Enable Basic authentication

Quarkus プロジェクトで Basic 認証 を有効にし、ユーザーがユーザー名とパスワードで認証できるようにします。

前提条件

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

手順

  1. application.properties ファイルで、quarkus.http.auth.basic プロパティーを true に設定します。

    quarkus.http.auth.basic=true
  2. オプション: 非実稼働環境のみで、アプリケーションで Quarkus セキュリティーをテストする場合:

    1. 埋め込みレルムの認証を有効にするには、quarkus.security.users.embedded.enabled プロパティーを true に設定します。

      security.users.embedded.enabled=true
    2. 必要なユーザー認証情報、ユーザー名、シークレット、およびロールを設定することもできます。 たとえば:

      quarkus.http.auth.basic=true
      quarkus.security.users.embedded.enabled=true
      quarkus.security.users.embedded.plain-text=true
      quarkus.security.users.embedded.users.alice=alice (1)
      quarkus.security.users.embedded.users.bob=bob (2)
      quarkus.security.users.embedded.roles.alice=admin (1)
      quarkus.security.users.embedded.roles.bob=user (2)
      1 ユーザー alice のパスワードは alice、ロールは admin です。
      2 ユーザー bob のパスワードは bob、ロールは user です。

      必要なユーザー認証情報を設定するために使用できる他の方法については、Quarkus の「セキュリティーテスト」ガイドの ユーザー情報の設定 セクションを参照してください。

      Configuring user names, secrets, and roles in the application.properties file is only suitable for testing scenarios. If you are securing a production application, always use a database to store this information.

次のステップ

For a more detailed walk-through that shows you how to configure Basic authentication together with Jakarta Persistence for storing user credentials in a database, see the Secure a Quarkus application with Basic authentication and Jakarta Persistence guide.