Saltar al contenido principal
Version: Next

Conceptos fundamentales

Conceptos básicos del diseño e integración del SDK de Eixam.

SDK-first​

Eixam está construido con arquitectura SDK-first. El SDK posee la lógica central de seguridad y runtime. La app anfitriona consume esa lógica a través de contratos documentados y estables.

Bootstrap vs ciclo de vida de sesión​

Bootstrap​

bootstrap(...) crea la instancia del SDK y resuelve la configuración del entorno. Se ejecuta una vez al inicio de la app.

Ciclo de vida de sesión​

MétodoDescripción
setSession(...)Aplicar una sesión firmada nueva o actualizada
clearSession()Eliminar la sesión actual
getCurrentSession()Leer la sesión firmada actual

Identidad firmada vs identidad canónica​

Identidad firmada​

Proporcionada por el backend del partner: appId, externalUserId, userHash

Identidad canónica​

El SDK puede enriquecer la identidad firmada a través de GET /v1/sdk/me. Los flujos internos del runtime usan esta identidad canónica para la resolución del transporte y los topics.

Entornos estándar vs personalizados​

EntornoUso
productionDespliegues en producción
sandboxDesarrollo y pruebas de integración
stagingValidación pre-producción
customEndpoints gestionados por el partner

Acciones sensibles al runtime​

Estas capacidades son deliberadamente sensibles a la UX y deben permanecer como decisiones explícitas de la app anfitriona:

  • Solicitar permisos
  • Entrar en Modo Protección
  • Emparejamiento y conexión de dispositivos
  • Iniciar tracking
  • Mostrar flujos de UI específicos del partner