Integração móvel

Em um aplicativo nativo, você incorpora a página de captura hospedada em um WebView, em vez de criar sua própria interface de câmera. O WebView executa o mesmo fluxo da web — selfie, comparação facial, prova de vida — e o seu aplicativo lê o veredito consultando a sessão.

O padrão

graph TD
  A[App: user taps Log in] --> B[Ask your backend to mint a session]
  B --> C[Backend returns captureUrl + sessionToken]
  C --> D[Open captureUrl in a WebView]
  D --> E[WebView: selfie -> face match + liveness]
  A --> F[Poll GET …/sessions/sessionToken every 2s]
  E --> F
  F --> G{status == completed?}
  G -->|yes| H[Read matched -> grant or deny, close WebView]
  G -->|no| F

Duas coisas que todas as plataformas precisam:

1. Crie no servidor, guarde apenas o token. O aplicativo chama o seu backend, que chama POST /sessions da Certivant com a Chave de Identificação. O aplicativo recebe apenas captureUrl + sessionToken.
2. Conceda a solicitação de câmera do WebView. O getUserMedia dentro de um WebView fica bloqueado até que você o autorize explicitamente — o gancho muda em cada plataforma (veja abaixo).

Permissão de câmera por plataforma

let config = WKWebViewConfiguration()
config.allowsInlineMediaPlayback = true
config.mediaTypesRequiringUserActionForPlayback = []
// WKUIDelegate:
func webView(_ webView: WKWebView,
             requestMediaCapturePermissionFor origin: WKSecurityOrigin,
             initiatedByFrame frame: WKFrameInfo,
             type: WKMediaCaptureType,
             decisionHandler: @escaping (WKPermissionDecision) -> Void) {
    decisionHandler(.grant)
}

webView.settings.javaScriptEnabled = true
webView.settings.mediaPlaybackRequiresUserGesture = false
webView.webChromeClient = object : WebChromeClient() {
    override fun onPermissionRequest(req: PermissionRequest) {
        runOnUiThread { req.grant(arrayOf(PermissionRequest.RESOURCE_VIDEO_CAPTURE)) }
    }
}

Microsoft.Maui.Handlers.WebViewHandler.Mapper.AppendToMapping(
    "LiveIdCamera", (handler, view) => {
#if ANDROID
        handler.PlatformView.SetWebChromeClient(new LiveIdChromeClient());
#elif IOS || MACCATALYST
        handler.PlatformView.UIDelegate = new LiveIdUIDelegate();
#elif WINDOWS
        // CoreWebView2.PermissionRequested -> Allow (Camera)
#endif
    });

Como ler o resultado

Consulte o endpoint de status e pare quando a sessão for concluída:

GET https://app.certivant.com/api/kyc/public/live-id/sessions/{sessionToken}
→ { "status": "completed", "matched": true, … }

matched === true → conceda o login. Seu backend também pode assinar o webhook live_id.validation.completed para ter um sinal autoritativo no servidor — útil quando você quer que a decisão de conceder o acesso fique inteiramente no seu backend.

Aplicativos de exemplo

Referências completas e executáveis estão no repositório, em samples/live-id-validation/:

Cada um tem uma única tela: toque em Verify with selfie → WebView → resultado. Defina o seu host e uma fonte de sessão no LiveIdConfig do exemplo (o endpoint do seu backend ou um token gerado com curl para um teste rápido) e execute. Veja o README de cada exemplo para as etapas de build e os arquivos exatos que configuram a permissão da câmera e a consulta de status.