Gestión de Aplicaciones

Las aplicaciones en Auris representan los registros de clientes OAuth 2.0 para tus aplicaciones web, móviles, APIs y servicios de máquina a máquina. Cada cliente que se conecta a Auris para autenticar usuarios u obtener tokens debe registrarse primero como una aplicación.

La sección Aplicaciones de la Consola es donde creas y gestionas estos registros, configuras los ajustes OAuth que cada cliente necesita y controlas qué datos aparecen en los tokens que reciben tus aplicaciones.

Tipos de Aplicación

Auris admite cuatro tipos de aplicación. Elige el tipo que mejor se adapte a la arquitectura de tu cliente:

Nota: Para aplicaciones WEB y MOBILE, no incluyas el secreto del cliente en tu código frontend. PKCE (Proof Key for Code Exchange) proporciona una seguridad equivalente sin necesidad de un secreto en el lado del cliente.

Crear una Aplicación

Página de Detalle de la Aplicación

Una vez creada la aplicación, al hacer clic en su nombre se abre la página de detalle. Esta página está organizada en pestañas:

Pestaña Credenciales

La pestaña Credenciales muestra los identificadores OAuth para esta aplicación.

ID de Cliente

El ID de cliente es un identificador único asignado por Auris en el momento de la creación. Es seguro exponerlo en el código frontend. Usa este valor como clientId en la configuración de tu SDK.

your-client-id-here

Secreto de Cliente (solo aplicaciones M2M y API)

El secreto del cliente se muestra completo solo una vez — inmediatamente después de la creación. Tras salir de la pestaña Credenciales, la Consola solo muestra los últimos cuatro caracteres.

Para ver o rotar el secreto:

1. Haz clic en Mostrar Secreto para ver la vista previa de los últimos cuatro caracteres
2. Haz clic en Rotar Secreto para generar un nuevo secreto

Nota: Al rotar un secreto de cliente, el secreto antiguo sigue siendo válido durante un período de gracia de 24 horas. Esto te permite actualizar la configuración de tu servidor sin provocar un fallo de autenticación inmediato. Tras el período de gracia, el secreto antiguo queda invalidado permanentemente.

Guarda los secretos de cliente de forma segura. Trátelos como contraseñas: nunca los confirmes en el control de versiones ni los expongas en los logs.

Pestaña URIs

La pestaña URIs configura con qué URLs interactuará Auris para esta aplicación.

URIs de Redirección (URLs de Callback Permitidas)

Son las URLs a las que Auris puede redirigir tras un intercambio de código de autorización exitoso. El redirect_uri proporcionado en tiempo de ejecución debe coincidir exactamente con uno de los valores registrados — las coincidencias parciales, los comodines y las discrepancias de barra al final son rechazadas.

Añade una URI por línea. Valores típicos:

https://app.yourdomain.com/auth/callback
http://localhost:3000/auth/callback

Orígenes Permitidos (CORS)

Orígenes desde los que el navegador puede realizar solicitudes directas a la API de Auris. Se usa para solicitudes de actualización de tokens entre orígenes desde SPAs. Introduce los orígenes sin ruta al final:

https://app.yourdomain.com
http://localhost:3000

URLs de Cierre de Sesión

URLs a las que Auris puede redirigir tras una solicitud de cierre de sesión (endpoint /logout). Añade la página de destino post-cierre de sesión para tu aplicación:

https://app.yourdomain.com
http://localhost:3000

Pestaña Configuración

La pestaña Configuración controla los tiempos de vida de los tokens y los permisos de tipos de grant.

Rotación del Token de Actualización

Cuando está habilitada (por defecto), cada uso de un token de actualización emite un nuevo token de actualización e invalida el que acaba de usarse. Esto limita la ventana de exposición si un token de actualización es robado, porque el cliente legítimo detectará que su token ya fue usado y puede revocar la sesión.

Pestaña Claims Personalizados

Los claims personalizados te permiten incluir datos adicionales en los tokens de acceso JWT emitidos para esta aplicación. Los claims se evalúan en el momento de emisión del token y varían por usuario.

Tipos de Claim

Agregar un Claim

1. Haz clic en Agregar Claim
2. Introduce la Clave del Claim — este es el nombre de propiedad que aparecerá en el payload del JWT (por ejemplo, department, plan, org_id)
3. Selecciona el Tipo de Valor en el desplegable
4. Configura la fuente del valor según el tipo
5. Activa Activo para incluir este claim en los tokens emitidos
6. Haz clic en Guardar

Vista Previa

Usa el botón Vista Previa para probar la resolución del claim. Introduce un ID de usuario y haz clic en Vista Previa para ver cómo quedaría el payload del JWT para ese usuario con todos los claims configurados aplicados.

Para detalles de implementación sobre cómo leer claims personalizados en tu SDK, consulta Claims Personalizados.

Pestaña Scopes M2M

Esta pestaña solo es visible para aplicaciones de tipo M2M. Controla qué scopes puede solicitar un cliente de máquina a máquina al usar el tipo de grant client_credentials.

Formato de Scope

Los scopes siguen el formato acción:recurso, igual que el formato de permisos usado en todo Auris:

read:users
write:invoices
admin:reports

Configurar Scopes

1. Haz clic en Agregar Scope
2. Introduce la cadena del scope (por ejemplo, read:orders)
3. Añade opcionalmente una descripción para el scope
4. Haz clic en Guardar

Cuando el cliente M2M solicita un token, solo puede solicitar los scopes listados aquí. Solicitar un scope no listado resulta en un error.

Verificar Scopes en Tu API

Tu servidor de API debe validar que el token entrante contiene el scope requerido antes de atender una solicitud:

// Ejemplo Node.js — verificar scope de token M2M
import { createLocalJWKSet, jwtVerify } from 'jose'
 
export async function verifyM2MToken(bearerToken, requiredScope) {
  const JWKS = createLocalJWKSet(await fetchJwks())
  const { payload } = await jwtVerify(bearerToken, JWKS)
 
  if (payload.type !== 'm2m') {
    throw new Error('No es un token M2M')
  }
 
  const scopes = payload.scope?.split(' ') ?? []
  if (!scopes.includes(requiredScope)) {
    throw new Error(`Falta el scope requerido: ${requiredScope}`)
  }
 
  return payload
}

Para detalles completos de implementación M2M, consulta Credenciales de Cliente M2M.

Eliminar una Aplicación

Para eliminar una aplicación:

1. Abre la página de detalle de la aplicación
2. Desplázate hasta el final de la pestaña Configuración
3. Haz clic en Eliminar Aplicación
4. Confirma la eliminación en el diálogo

Nota: Eliminar una aplicación es permanente. Cualquier token emitido para esta aplicación dejará de ser verificable tras la eliminación, ya que el ID de cliente dejará de existir. Asegúrate de que todos los servicios en ejecución que usen las credenciales de esta aplicación hayan sido actualizados antes de eliminarla.

Guías Relacionadas

• Login Alojado (Authorization Code + PKCE) — Implementar OAuth 2.0 PKCE en tu frontend
• Credenciales de Cliente M2M — Autenticación de servidor a servidor con credenciales de cliente
• Claims Personalizados — Incluir datos de usuario y rol en tokens JWT
• Verificación de Tokens — Validar JWTs de Auris en tu servidor de API