Integración web y apps

Un runtime para los tres canales

Web, iOS y Android comparten el backend de challenges, capturas cifradas, evaluación y resultados. Cada proyecto registra su plataforma. Web captura dentro de un iframe; las apps utilizan cámara y permisos nativos. Compartir runtime no exige que las apps utilicen el iframe o el WASM del navegador.

Integrar web

1. Crea un proyecto web y registra los orígenes HTTPS exactos permitidos.
2. Para presencia pública, habilita Widget público y utiliza la sitekey con el script https://widget.autentikar.com/v1/api.js.
3. Para una transacción o comparación de identidad, tu backend crea el challenge y entrega al SDK web solamente su capability temporal.
4. Permite el widget en las políticas de iframe y cámara de tu página; la persona activa la cámara y el navegador decide el permiso.
5. Envía el token de resultado a tu backend para verificarlo antes de continuar con la operación.

Integrar iOS o Android

1. Crea un proyecto para la plataforma y configura los identificadores de la aplicación.
2. Tu backend crea el challenge y entrega al SDK contexto, capability temporal, expiración y clave pública.
3. El SDK consulta https://runtime.trace.autentikar.com y valida la configuración antes de capturar.
4. Tu app presenta la información y consentimiento aplicables y solicita el permiso de cámara. El proveedor de captura obtiene los fotogramas.
5. El SDK cifra la captura, la envía, consulta el estado y devuelve el token. Tu backend verifica el resultado y su contexto.

Expiración y reintentos

Si vence el challenge antes de capturar, solicita uno nuevo a tu backend. Si un envío queda incierto, el integrador conserva y reenvía el mismo sobre cifrado mediante el flujo explícito del SDK; no recaptures para ese reintento. Tu backend consume el resultado una vez, con reintentos idempotentes.

Cada sesión pertenece a su región de creación y no se migra automáticamente si esa región falla. Un proyecto suspendido o una configuración sin actualización vigente se rechazan.

Antes de publicar

Publica el backend compatible antes de distribuir los SDK nuevos. Confirma la disponibilidad de dominios, assets y versiones con tu equipo; estas guías describen código preparado, no un despliegue anunciado.

Valida cámaras, permisos y el evaluador en dispositivos reales. La UI del widget y su integración deben cumplir WCAG 2.2 AA; las pruebas parciales no acreditan conformidad completa.