Basic 認証を有効にする
Enable Basic authentication to require a username and password before users can access your Quarkus application. For more information, see Basic authentication.
前提条件
-
You have installed at least one extension that provides an
IdentityProviderto verify username and password credentials and map them to aSecurityIdentity. For example:
手順
-
application.propertiesファイルで、quarkus.http.auth.basicプロパティーをtrueに設定します。quarkus.http.auth.basic=true -
Configure an identity provider to verify the username and password against your user store. For a production application, configure one of the identity provider extensions listed in the Prerequisites, for example, by storing users in a database with the Jakarta Persistence extension. For more information, see the Identity providers guide.
-
For testing only: In a non-production environment, you can use the embedded realm provided by the
quarkus-elytron-security-properties-fileextension instead of a production identity provider.-
埋め込みレルムの認証を有効にするには、
quarkus.security.users.embedded.enabledプロパティーをtrueに設定します。quarkus.security.users.embedded.enabled=true -
You can also configure the required user credentials: user name, password, and roles. For example:
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 quarkus.security.users.embedded.users.bob=bob quarkus.security.users.embedded.roles.alice=admin quarkus.security.users.embedded.roles.bob=userwhere:
-
ユーザー
aliceは、パスワードがaliceで、ロールがadminです。 -
ユーザー
bobは、パスワードがbobで、ロールがuserです。
-
-
検証
-
Start your application.
-
Send a request to a secured endpoint without credentials and confirm that the application returns a
401 Unauthorizedresponse:$ curl -i -X GET http://localhost:8080/<your_secured_endpoint> HTTP/1.1 401 Unauthorized WWW-Authenticate: Basic -
Send the same request with a valid username and password and confirm that the application returns a
200 OKresponse:$ curl -i -X GET -u <username>:<password> http://localhost:8080/<your_secured_endpoint> HTTP/1.1 200 OK
次のステップ
ユーザー認証情報をデータベースに保存するために Basic 認証と Jakarta Persistence を組み合わせて設定する方法を示す、より詳細なチュートリアルについては、Basic 認証と Jakarta Persistence を使用した Security の開始 ガイドを参照してください。
