The English version of quarkus.io is the official project site. Translated sites are community supported on a best-effort basis.

Activar la autenticación básica

Habilite la autenticación básica para su proyecto Quarkus y permita que los usuarios se autentiquen con un nombre de usuario y una contraseña.

Requisitos previos

The following procedure outlines how you can enable Basic authentication for your application by using the elytron-security-properties-file extension.

Procedimiento

  1. In the application.properties file, set the quarkus.http.auth.basic property to true.

    quarkus.http.auth.basic=true
  2. Optional: In a non-production environment only and purely for testing Quarkus Security in your applications:

    1. To enable authentication for the embedded realm, set the quarkus.security.users.embedded.enabled property to true.

      security.users.embedded.enabled=true
    2. You can also configure the required user credentials, user name, secret, 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 (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 El usuario, alice, tiene como contraseña alice y como rol admin.
      2 El usuario, bob, tiene como contraseña bob y como rol user.

      Para obtener información sobre otros métodos que puede utilizar para configurar las credenciales de usuario requeridas, consulte la sección Configuración de información de usuario de la guía "Pruebas de seguridad" de Quarkus.

      Configuring user names, secrets, and roles in the application.properties file is appropriate only for testing scenarios. For securing a production application, it is crucial to use a database to store this information.

Próximos pasos

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 Getting started with Security by using Basic authentication and Jakarta Persistence guide.