Antes de empezar
- Haber ingresado a la consola con una cuenta de administrador del tenant. Vea Ingresar a la consola.
- El tipo de aplicación que va a conectar: pública (navegador o móvil), de servidor o servicio a servicio. Vea la sección de buenas prácticas, más abajo.
- El negocio y el canal del cliente, si no va a usar Global (Tenant) y Todos los canales.
- Las URIs de redirección de su aplicación, si va a usar Código de Autorización o Implícito.
Crear el cliente
Abra Ajustes Globales, busque Clientes OAuth y haga clic en Crear. El asistente tiene cuatro pasos. Use Próximo y Atrás para moverse, o Cancelar para salir.1
Información Básica y Ámbito de Acceso
Escriba el Nombre del Cliente. La consola propone un ID del Cliente a partir del nombre. Puede editarlo o hacer clic en Regenerar para obtener otro. El ID acepta letras, números, guiones y guiones bajos, de 3 a 100 caracteres, y no puede repetirse en el tenant.Elija los Métodos de Autenticación y los Tipos de Concesión. Luego complete el Ámbito de Acceso:
- Negocio: un negocio o Global (Tenant). Si ingresó con una cuenta de negocio, el campo muestra su negocio y no se puede cambiar.
- Canal: un canal o Todos los canales.
- Tipo de Cuenta: LABORAL, CLIENTE o SERVICIO.
2
URIs y Alcances
Complete URIs de Redirección y URIs de Post-Logout. Cada URI debe empezar con
http:// o https://. Las URIs de Redirección son obligatorias si eligió Código de Autorización o Implícito.En Alcances, haga clic en los alcances predefinidos o escriba uno propio y presione Enter. El cliente necesita al menos un alcance. El alcance predefinido Administrador es role_admin.3
Tokens y seguridad
Ajuste Configuración de Tokens, Formato del Token de Acceso, Algoritmo de Firma y Opciones de Seguridad. Haga clic en Crear Cliente OAuth.
4
Credenciales del Cliente
La consola muestra el ID del Cliente y el Secreto del Cliente, cada uno con un botón para copiarlo. Guarde el secreto y haga clic en Cerrar.
Opciones del asistente
Valores por defecto
Para un cliente de servicio a servicio, cambie el tipo de concesión por defecto: elija Credenciales de Cliente y quite Código de Autorización.
Buenas prácticas
- Aplicaciones públicas (navegador o móvil): no pueden guardar un secreto. Elija Ninguno como método de autenticación, use Código de Autorización y active Requerir PKCE (Proof Key for Code Exchange).
- Aplicaciones de servidor: guarde el secreto en su backend y use un método con secreto o con clave privada.
- Servicio a servicio: use Credenciales de Cliente.
- Mínimos alcances: pida solo los alcances que la aplicación usa.
- Mínimas concesiones: habilite solo los tipos de concesión que la aplicación necesita. Evite Implícito y Contraseña del Propietario del Recurso en aplicaciones nuevas.
- Redirecciones exactas: registre solo las URIs de redirección que la aplicación usa.
Administrar los clientes
La lista muestra Nombre del Cliente, ID del Cliente, Negocio, Estado, Canal, Tipo de Cuenta, Alcances y Fecha de Creación. Cada fila tiene tres acciones:
Si el cliente todavía tiene autorizaciones activas, Eliminar no lo borra directamente. Si su cuenta tiene permiso para revocar autorizaciones, la consola ofrece Revocar y eliminar: revoca todas las autorizaciones y borra el cliente. Los tokens emitidos para ese cliente dejan de funcionar.
Qué sigue
Autenticación por API
Pida tokens con el cliente que creó.
Conceptos
Repase tenant, negocio, canal y tipo de cuenta.
Atributos
Defina los atributos que viajan con sus identidades.