Onboarding mobile

In un'app nativa incorpora la pagina di acquisizione ospitata in una WebView, invece di costruire una propria interfaccia di fotocamera. La WebView esegue lo stesso flusso del web — selfie, confronto del volto, vivacità — e la Sua app legge il verdetto interrogando la sessione.

Lo schema

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

Due cose sono necessarie su ogni piattaforma:

1. Crei sul server, tenga solo il token. L'app chiama il Suo backend, che chiama POST /sessions di Certivant con la chiave di identificazione. L'app riceve solo captureUrl e sessionToken.
2. Conceda la richiesta di fotocamera della WebView. getUserMedia all'interno di una WebView è bloccato finché non lo concede esplicitamente — il punto di aggancio varia per piattaforma (sotto).

Permesso della fotocamera per piattaforma

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
    });

Lettura dell'esito

Interroghi l'endpoint di stato e si fermi quando la verifica è completata:

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

matched === true → conceda l'accesso. Il Suo backend può anche iscriversi al webhook live_id.validation.completed per un segnale autorevole lato server — utile quando vuole che la decisione di concedere l'accesso risieda interamente sul Suo backend.

App di esempio

Riferimenti completi e funzionanti si trovano nel repository sotto samples/live-id-validation/:

Ognuna è una sola schermata: tocchi Verifica con selfie → WebView → esito. Imposti il Suo host e una fonte di sessione nella LiveIdConfig dell'esempio (il Suo endpoint backend, oppure un token creato con curl per una prova rapida), poi esegua. Consulti il README di ogni esempio per i passaggi di compilazione e per i file esatti che collegano la concessione della fotocamera e l'interrogazione.