Basic 認証

Web ブラウザーなどの HTTP ユーザーエージェントは、Authorization ヘッダーを使用して各 HTTP リクエストにユーザー名とパスワードを提供します。ヘッダーは Authorization: Basic <credentials> として指定されます。ここで、credentials はコロンで結合されたユーザー ID とパスワードの Base64 エンコードです。

Basic 認証メカニズムでは、送信されたクレデンシャルの機密性は保護されません。認証情報は、転送中に Base64 でエンコードされ、暗号化またはハッシュ化されません。そのため、機密性を提供するには、HTTPS で Basic 認証を使用します。

基本認証は、すべての Web ブラウザーとほとんどの Web サーバーが理解できる、明確に指定されたシンプルなチャレンジと応答のスキームです。

次の表は、Quarkus アプリケーションを保護するために HTTP Basic 認証を使用する場合のいくつかの制限を示しています。

Basic 認証を使用して Quarkus アプリケーションを保護する方法の詳細は、以下の資料を参照してください。

Quarkus には、一般的なセキュリティーアノテーション @RolesAllowed、@DenyAll、REST エンドポイント、および CDI Bean の@PermitAll に基づいてロールベースのアクセス制御(RBAC)を許可する組み込みセキュリティーも含まれます。詳細は、Quarkus の Web エンドポイントの認可 ガイドを参照してください。

io.quarkus.vertx.http.security.HttpSecurity CDI イベントを使用すると、次の例のようにプログラムで Basic 認証メカニズムを設定できます。

package org.acme.http.security;

import io.quarkus.vertx.http.security.HttpSecurity;
import jakarta.enterprise.event.Observes;

public class HttpSecurityConfiguration {

    void configure(@Observes HttpSecurity httpSecurity) {
        httpSecurity.basic("QuarkusTestRealm"); 
    }

}

package org.acme.http.security;

import io.quarkus.vertx.http.security.HttpSecurity;
import jakarta.enterprise.event.Observes;

public class HttpSecurityConfiguration {

    void configure(@Observes HttpSecurity httpSecurity) {
        httpSecurity.basic("QuarkusTestRealm"); 

    }

}

以下の手順では、elytron-security-properties-file エクステンションを使用してアプリケーションの Basic 認証を有効にする方法を説明します。

ユーザー認証情報をデータベースに保存するために、Basic 認証と Jakarta Persistence を一緒に設定する方法を示す詳細なチュートリアルは、Basic 認証と Jakarta Persistence を使用したセキュリティーのスタートガイド を参照してください。