Herramientas para Desarrolladores

La sección Desarrollador de la Consola Auris proporciona un conjunto de herramientas para construir, probar y depurar integraciones con Auris. Estas herramientas están diseñadas para reducir el tiempo entre “quiero integrar Auris” y “la autenticación funciona en mi aplicación.”

Accede al Hub de Desarrolladores en Consola → Desarrollador → Hub.

Resumen del Hub de Desarrolladores

El Hub de Desarrolladores es una página de inicio con seis tarjetas que enlazan a cada herramienta para desarrolladores:

Adicionalmente, la página de Documentación para Desarrolladores proporciona guías de referencia inline con bloques de código para tareas de integración comunes.

API Explorer

El API Explorer proporciona una referencia navegable de todos los endpoints de la API Auris, organizados en 9 secciones. Accede en Consola → Desarrollador → API Explorer.

Secciones de la API

Usando el API Explorer

Cada sección se expande para mostrar endpoints individuales con:

• Método HTTP y ruta (por ejemplo, POST /api/auth/token)
• Parámetros de la solicitud: Parámetros de consulta, parámetros de ruta y esquema del cuerpo de la solicitud
• Formato de respuesta: Ejemplos de cuerpos de respuesta de éxito y error
• Requisito de autenticación: Qué endpoints requieren un token Bearer y cuáles son públicos

El API Explorer es una herramienta de referencia — muestra el formato de solicitud y respuesta pero no ejecuta llamadas a la API. Usa el Sandbox para pruebas en vivo.

Decodificador de Tokens

El Decodificador de Tokens te permite pegar cualquier JWT y ver su contenido decodificado. Accede en Consola → Desarrollador → Decodificador de Tokens.

Cómo Usarlo

{
  "alg": "RS256",
  "kid": "key-id-1",
  "typ": "JWT"
}

{
  "sub": "usr_abc123",
  "iss": "https://auth.yourcompany.com",
  "aud": "your-client-id",
  "iat": 1739880000,
  "exp": 1739880900,
  "email": "[email protected]",
  "roles": ["editor"],
  "acr": "urn:auris:acr:mfa",
  "amr": ["pwd", "otp"]
}

Casos de Uso Comunes

• Depurar claims: Verificar que los claims personalizados, roles y scopes están presentes en el token
• Comprobar expiración: Determinar si un error 401 es causado por un token expirado
• Verificar ACR/AMR: Confirmar que los claims de autenticación step-up están incluidos tras MFA
• Inspeccionar tokens M2M: Comprobar type: "m2m" y claims de scope para tokens de credenciales de cliente
• Validar DPoP: Comprobar el claim cnf.jkt en tokens vinculados a DPoP

Sandbox

El Sandbox proporciona un entorno de pruebas de API en vivo conectado a tu tenant. Accede en Consola → Desarrollador → Sandbox.

Cómo Funciona

El Sandbox rellena previamente las cabeceras de autenticación con tu token de sesión de administrador actual y la cabecera x-tenant con tu ID de tenant. Puedes:

1. Seleccionar un endpoint de la API del menú desplegable (organizado por las mismas 9 secciones que el API Explorer)
2. Rellenar los parámetros de la solicitud (parámetros de ruta, consulta, cuerpo)
3. Hacer clic en Enviar para ejecutar la solicitud contra la API Auris en vivo
4. Ver el código de estado de la respuesta, las cabeceras y el cuerpo

Contexto Rellenado Previamente

Esto significa que puedes probar endpoints de inmediato sin construir manualmente las cabeceras.

Ejemplo: Probar una Comprobación de Permisos

1. Selecciona POST /api/roles/check del menú desplegable de endpoints
2. Introduce el cuerpo de la solicitud:

{
  "userId": "usr_abc123",
  "permission": "view:invoices",
  "applicationId": "app_xyz789"
}

3. Haz clic en Enviar
4. Ve la respuesta:

{
  "ok": true,
  "data": {
    "allowed": true,
    "source": "role_permission",
    "role": "editor"
  }
}

Quickstarts

El asistente de Quickstarts proporciona instrucciones paso a paso para integrar Auris en tu aplicación. Accede en Consola → Desarrollador → Quickstarts.

Asistente de Configuración Interactivo

El asistente guía a través de tres pasos:

npm install @auris/react

import { AurisProvider } from '@auris/react'
 
function App({ children }) {
  return (
    <AurisProvider
      domain="auth.yourcompany.com"
      clientId="your-actual-client-id"
    >
      {children}
    </AurisProvider>
  )
}

import { useAuris } from '@auris/react'
 
function LoginButton() {
  const { loginWithRedirect, isAuthenticated, user } = useAuris()
 
  if (isAuthenticated) {
    return <p>Bienvenido, {user.name}</p>
  }
 
  return <button onClick={() => loginWithRedirect()}>Iniciar Sesión</button>
}

Temas Avanzados

Debajo del asistente principal de 3 pasos, la página de Quickstarts incluye una sección de Temas Avanzados con fragmentos de código para:

Cada tema incluye un ejemplo de código funcional con las credenciales de tu aplicación rellenadas previamente.

Herramienta CLI

La página de referencia de la Herramienta CLI documenta la interfaz de línea de comandos auris para gestionar tu tenant desde un terminal. Accede a la referencia en Consola → Desarrollador → CLI.

Comandos Disponibles

Instalación

npm install -g @auris/cli

Autenticación

El CLI usa el mismo flujo OAuth2 que la Consola. Al ejecutar auris login se abre una ventana del navegador para la autenticación y se almacena el token localmente.

Resumen de SDKs

La página Resumen de SDKs compara características entre los tres paquetes SDK. Accede en Consola → Desarrollador → SDKs.

Comparación de Características

Detalles de los Paquetes

Documentación para Desarrolladores

La página de Documentación para Desarrolladores proporciona guías de referencia inline organizadas en secciones desplegables. Accede en Consola → Desarrollador → Docs.

Secciones de las Guías

Cada sección incluye:

• Texto explicativo conciso
• Bloques de código con resaltado de sintaxis
• Botones Copiar en todos los bloques de código
• Enlaces rápidos a la documentación completa para lectura más profunda

La página de Documentación para Desarrolladores está diseñada como referencia rápida que permanece dentro de la Consola, evitando cambios de contexto a documentación externa para tareas comunes.

Guías Relacionadas

• SDKs — Documentación completa de los SDKs
• Referencia de la API — Documentación completa de los endpoints de la API
• Aplicaciones — Configurar las aplicaciones usadas en Quickstarts
• Tutorial de Quickstarts — Tutorial completo de primeros pasos