Enable Basic authentication

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 only suitable for testing scenarios. If you are securing a production application, always use a database to store this information.

Próximos pasos

Para obtener un tutorial más detallado que muestra cómo configurar la autenticación básica junto con Jakarta Persistence para almacenar las credenciales de usuario en una base de datos, consulte xref:security-basic-authentication-tutorial.adoc[Asegure una aplicación Quarkus con autenticación básica y Jakarta Guía de persistencia.