Guida alla configurazione di Onfido con Azure Active Directory B2C

Questa esercitazione descrive come integrare Azure Active Directory B2C (Azure AD B2C) con Onfido, un ID documento e un'app di verifica biometrica facciale. Usarlo per soddisfare i requisiti di conoscenza del cliente e dell'identità. Onfido usa la tecnologia di intelligenza artificiale che verifica l'identità associando un ID foto con la biometria facciale. La soluzione connette un'identità digitale a una persona, offre un'esperienza di onboarding affidabile e contribuisce a ridurre le frodi.

In questa esercitazione, abiliterai il servizio Onfido per verificare l'identità nel processo di iscrizione o di accesso. I risultati di Onfido informano le decisioni relative ai prodotti o ai servizi a cui l'utente accede.

Prerequisiti

Per iniziare, è necessario:

• Una sottoscrizione di Azure

  • Se non hai già un account, puoi creare un account Azure gratuito

• Un tenant di Azure AD B2C collegato alla sottoscrizione di Azure
• Un account di valutazione Onfido
  • Vai a onfido.com Contattaci e compila il modulo

Descrizione dello scenario

L'integrazione di Onfido include i componenti seguenti:

• Tenant di Azure AD B2C : server di autorizzazione che verifica le credenziali utente in base ai criteri personalizzati definiti nel tenant. È anche noto come provider di identità (IdP). Ospita l'app client Onfido, che raccoglie i documenti utente e li trasmette al servizio API Onfido.
• Client Onfido : utilità di raccolta documenti client JavaScript configurabile distribuita nelle pagine Web. Controlla i dettagli, ad esempio le dimensioni e la qualità del documento.
• API REST intermedia : fornisce endpoint per il tenant di Azure AD B2C per comunicare con il servizio API Onfido. Gestisce l'elaborazione dei dati e rispetta i requisiti di sicurezza di entrambi.
• Servizio API Onfido : servizio back-end che salva e verifica i documenti utente.

Il diagramma dell'architettura seguente illustra l'implementazione.

1. L'utente si iscrive per creare un nuovo account e immette gli attributi. Azure AD B2C raccoglie gli attributi. L'app client Onfido ospitata in Azure AD B2C verifica la presenza delle informazioni utente.
2. Azure AD B2C chiama l'API di livello intermedio e passa gli attributi.
3. L'API di livello intermedio raccoglie gli attributi e li converte in un formato API Onfido.
4. Onfido elabora gli attributi per convalidare l'identificazione dell'utente e invia il risultato all'API di livello intermedio.
5. L'API di livello intermedio elabora i risultati e invia informazioni pertinenti ad Azure AD B2C, in formato JSON (JavaScript Object Notation).
6. Azure AD B2C riceve le informazioni. Se la risposta ha esito negativo, viene visualizzato un messaggio di errore. Se la risposta ha esito positivo, l'utente viene autenticato e scritto nella directory.

Creare un account Onfido

1. Crea un account Onfido: vai a onfido.com Contattaci e compila il modulo.
2. Creare una chiave API: passare a Introduzione (API v3.5).

Documentazione di Onfido

Le chiavi attive sono tuttavia fatturabili, è possibile usare le chiavi sandbox per il test. Passare a onfido.com per, Sandbox e differenze in tempo reale. Le chiavi sandbox producono la stessa struttura dei risultati delle chiavi attive, ma i risultati sono predeterminati. I documenti non vengono elaborati o salvati.

Per altre informazioni su Onfido, vedere:

• Documentazione dell'API Onfido
• Hub per sviluppatori Onfido

Configurare Azure AD B2C con Onfido

Distribuire l'API

1. Distribuire il codice API in un servizio di Azure. Passare a samples/OnFido-Combined/API/Onfido.Api/. È possibile pubblicare il codice da Visual Studio.
2. Configurare la condivisione di risorse tra origini diverse (CORS).
3. Aggiungi Origine consentita come https://{your_tenant_name}.b2clogin.com.

Aggiunta di impostazioni di configurazione riservate

Configurare le impostazioni dell'app nel servizio app di Azure senza eseguirne il controllo in un repository.

Impostazioni DELL'API REST:

• Nome dell'impostazione dell'applicazione: OnfidoSettings:AuthToken
• Origine: account Onfido

Distribuire l'interfaccia utente

Configurare la posizione di archiviazione

1. Nel portale di Azure creare un contenitore.
2. Archiviare i file dell'interfaccia utente in /samples/OnFido-Combined/UI nel contenitore BLOB.
3. Consentire l'accesso CORS al contenitore di archiviazione creato: passare a Impostazioni>Origine consentita.
4. Inserisci https://{your_tenant_name}.b2clogin.com.
5. Sostituire il nome del tenant con il nome del tenant di Azure AD B2C, usando lettere minuscole. Ad esempio: https://fabrikam.b2clogin.com.
6. Per Metodi consentiti selezionare GET e PUT.
7. Seleziona Salva.

Aggiornare i file dell'interfaccia utente

1. Nei file dell'interfaccia utente passare a samples/OnFido-Combined/UI/ocean_blue.
2. Aprire ogni file HTML.
3. Trova {your-ui-blob-container-url} e sostituiscilo con gli URL delle tue cartelle UI ocean_blue, dist e assets.
4. Trovare {your-intermediate-api-url} e sostituirlo con l'URL intermedio del servizio app per le API.

Caricare i file

1. Archiviare i file della cartella dell'interfaccia utente nel contenitore BLOB.
2. Usare Azure Storage Explorer per gestire Azure Managed Disks e le autorizzazioni di accesso.

Configurare Azure AD B2C

Sostituire i valori di configurazione

In /samples/OnFido-Combined/Policies trovare i segnaposto seguenti e sostituirli con i valori corrispondenti dell'istanza.

*Le informazioni dettagliate sulle app possono trovarsi in un tenant diverso. Questo passaggio è facoltativo. Rimuovere i componenti TechnicalProfiles e OrchestrationSteps corrispondenti, se non sono necessari.

Configurare i criteri di Azure AD B2C

Per istruzioni su come configurare il tenant di Azure AD B2C e configurare i criteri, vedere Pacchetto di avvio dei criteri personalizzato . I criteri personalizzati sono un set di file XML caricati nel tenant di Azure AD B2C per definire profili tecnici e percorsi utente.

Testare il flusso utente

1. Aprire il tenant di Azure AD B2C.
2. Sotto Criteri, selezionare Identity Experience Framework.
3. Selezionare l'elemento SignUpSignIn creato in precedenza.
4. Seleziona Esegui il flusso utente.
5. Per Applicazione selezionare l'app registrata( ad esempio JWT).
6. Per URL di risposta selezionare l'URL di reindirizzamento.
7. Seleziona Esegui il flusso utente.
8. Completare la procedura di iscrizione.
9. Creare un account.
10. Quando viene creato l'attributo utente, Onfido viene chiamato durante il flusso.

Passaggi successivi

• Criteri personalizzati in Azure AD B2C
• Introduzione ai criteri personalizzati in Azure AD B2C