Diagnostique problemas de integración de clientes

Use esta guía cuando una integración de Aura Home no se carga, no se autentica, no se renderiza o no supera la validación del lanzamiento en un portal de cliente.

Verificaciones rápidas

Abra directamente la baseUrl configurada en una pestaña del navegador.
Confirme que la página del portal, el runtime, los recursos del SDK y los endpoints de identidad usen HTTPS.
Revise la consola del navegador en busca de errores de CSP, de inserción en marcos, de contenido mixto o de certificados.
Confirme que el callback de token devuelva un token OIDC/JWT válido.
Escuche los eventos loaded, ready, configAck, tokenProvided y error del SDK.

Síntomas y soluciones

Síntoma	Causa probable	Solución
El iframe aparece en blanco	La URL del runtime es incorrecta, está bloqueada o no tiene permitido insertarse en un marco.	Abra `baseUrl` directamente, revise las listas de permitidos del runtime e inspeccione los errores de inserción en marcos en la consola del navegador.
El SDK no encuentra el contenedor	`AuraHome.init` se ejecuta antes de que exista el contenedor.	Cree `<div id="aura-home"></div>` antes de la inicialización o inicialice después de que se monte el componente.
`ready` nunca se dispara	El runtime se cargó, pero no completó el handshake con el SDK.	Revise `allowedOrigin`, la disponibilidad del runtime y los errores de consola dentro del iframe, si es posible acceder a ellos.
El SSO devuelve un error 401	Token faltante, vencido o no válido.	Valide `iss`, `aud`, `sub`, `exp`, la firma y la configuración OIDC del runtime.
SAML funciona, pero Aura Home aparece como anónimo	No se creó el puente entre la sesión SAML y un token OIDC/JWT.	Intercambie la sesión SAML mediante el gateway de identidad del cliente y devuelva el token OIDC/JWT desde `getToken`.
Advertencia de contenido mixto	Un script, iframe, API, hoja de estilo o imagen usa HTTP.	Migre todas las URL de la integración a HTTPS.
Advertencia de certificado	Certificado vencido, SAN incorrecto o cadena incompleta.	Renueve o vuelva a emitir el certificado y sirva la cadena completa desde el borde.
El tema no se aplica	El `theme.id` solicitado no está permitido, los nombres de las variables CSS no son válidos o la hoja de estilo alojada está bloqueada.	Confirme la lista de permitidos del runtime o el perfil de apariencia publicado desde el panel, use variables que comiencen con `--` y permita la URL de la hoja de estilo en la CSP.

Fragmento para depurar eventos

const aura = AuraHome.init({
  container: "#aura-home",
  baseUrl: "https://aura.customer-domain.com/",
  allowedOrigin: "https://aura.customer-domain.com",
  auth: {
    mode: "oidc",
    getToken: async () => customerIdentity.getIdToken()
  }
});

["loaded", "ready", "configAck", "tokenProvided", "error"].forEach((eventName) => {
  aura.on(eventName, (event) => {
    console.info("[Aura Home]", eventName, event);
  });
});

Qué enviar al soporte de Cadisa

URL del portal y URL del runtime de Aura Home.
Nombre del entorno: development, staging o production.
Errores de la consola del navegador, sin tokens ni secretos.
Estado de red del runtime del iframe y de los recursos del SDK.
Resumen de los claims del token: solo emisor, audiencia, vencimiento y presencia del sujeto. No envíe tokens sin procesar.