Habilitar a autenticação básica
Enable Basic authentication to require a username and password before users can access your Quarkus application. For more information, see Basic authentication.
Pré-requisitos
-
You have installed at least one extension that provides an
IdentityProviderto verify username and password credentials and map them to aSecurityIdentity. For example:
Procedimento
-
No arquivo
application.properties, defina a propriedadequarkus.http.auth.basiccomotrue.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.-
Para habilitar a autenticação para o embedded realm, defina a propriedade
quarkus.security.users.embedded.enabledcomotrue.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:
-
O usuário,
alice, temalicecomo sua senha eadmincomo sua função. -
O usuário,
bob, tembobcomo sua senha eusercomo sua função.
-
-
Verification
-
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
Próximos passos
Para um passo a passo mais detalhado que mostre como configurar a autenticação básica junto com o Jakarta Persistence para armazenar credenciais de usuário em um banco de dados, consulte o guia Começando com Segurança usando autenticação básica e Jakarta Persistence.
