Use esta lista de verificación antes de iniciar la implementación. Ayuda a Cadisa y al equipo del cliente a acordar los detalles del portal, la identidad, el runtime, la seguridad y el lanzamiento necesarios para una integración del SDK sin contratiempos.
Información que aporta el cliente
| Elemento | Ejemplo | Responsable |
|---|---|---|
| Dominio del portal | https://portal.customer-domain.com | Cliente |
| Dominio del runtime de Aura Home | https://aura.customer-domain.com | Cadisa + Cliente |
| Proveedor de identidad | Okta, Azure AD, Auth0, Google o puente SAML | Cliente |
| Emisor OIDC | https://customer.okta.com/oauth2/default | Cliente |
| Client ID o audiencia | aura-home | Cliente |
| Origen principal permitido | https://portal.customer-domain.com | Cadisa |
| Perfil de marca | ID del tema, URL del logotipo, modo, color principal, color de acento y familia tipográfica | Cliente + Cadisa |
| Contacto técnico | Responsable de ingeniería designado y canal de soporte | Cliente |
Preparación del portal
- La página del portal cuenta con un contenedor estable para Aura Home.
- El portal se sirve por HTTPS con un certificado de confianza.
- El portal puede cargar el paquete del SDK o el recurso del SDK empaquetado.
- La Content Security Policy permite el runtime de Aura Home en
frame-srcyconnect-src. - El portal puede proporcionar un token OIDC/JWT mediante
auth.getTokencuando el SSO empresarial está habilitado.
Decisiones de integración
| Decisión | Valor predeterminado recomendado |
|---|---|
| Secciones visibles | Comience con chat y profile; oculte la barra de navegación, el pie de página, la incorporación, los precios y las páginas legales dentro de los portales de clientes. |
| Altura del contenedor | Use un espacio fijo o una altura basada en el viewport, como calc(100vh - 120px), con un mínimo razonable. |
| Autenticación | Use OIDC/JWT mediante auth.getToken; si es necesario, cree un puente de SAML a OIDC/JWT. |
| Marca | Priorice los perfiles de apariencia publicados desde el panel y las variables CSS permitidas; use hojas de estilo alojadas solo para ajustes más amplios y específicos del cliente. |
| Validación del lanzamiento | Pruebe HTTPS, CSP, los claims del token, la carga del iframe, los eventos del SDK y el tamaño en dispositivos móviles antes del despliegue en producción. |
Paquete de entrega
Antes del lanzamiento, los equipos del cliente y de Cadisa deben confirmar lo siguiente:
- Valores finales de la URL del runtime y del origen permitido.
- Valores finales del emisor de identidad y de la audiencia.
- Responsable de los certificados y proceso de renovación.
- Reglas de CSP para producción.
- ID del tema aprobado y perfil de apariencia publicado desde el panel para el runtime de destino.
- Ruta de soporte para fallas de autenticación, iframe o certificados.