Tutorial zum Konfigurieren von Onfido mit Azure Active Directory B2C

In diesem Tutorial erfahren Sie, wie Sie Azure Active Directory B2C (Azure AD B2C) in Onfido integrieren, eine App zur Überprüfung der Dokument-ID und der biometrischen Gesichtsdaten. Verwenden Sie es, um die Anforderungen an "Know Your Customer" und "Identity" zu erfüllen. Onfido verwendet eine Technologie der künstlichen Intelligenz (KI), die die Identität überprüft, indem sie einen Lichtbildausweis mit biometrischen Gesichtsdaten abgleicht. Die Lösung verbindet eine digitale Identität mit einer Person, bietet ein zuverlässiges Onboarding-Erlebnis und hilft, Betrug zu reduzieren.

In diesem Tutorial aktivieren Sie den Onfido-Dienst, um die Identität im Registrierungs- oder Anmeldeablauf zu überprüfen. Die Ergebnisse von Onfido geben Aufschluss über die Entscheidung, auf welche Produkte oder Dienstleistungen der Nutzer zugreift.

Voraussetzungen

Zunächst benötigen Sie Folgendes:

• Ein Azure-Abonnement

  • Wenn Sie kein Konto haben, können Sie ein kostenloses Azure-Konto erhalten.

• Ein Azure AD B2C-Mandant , der mit Ihrem Azure-Abonnement verknüpft ist
• Ein Onfido-Testkonto
  • Gehen Sie zu onfido.com Kontaktieren Sie uns und füllen Sie das Formular aus

Szenariobeschreibung

Die Onfido-Integration umfasst die folgenden Komponenten:

• Azure AD B2C-Mandant – Der Autorisierungsserver, der Benutzeranmeldeinformationen basierend auf benutzerdefinierten Richtlinien überprüft, die im Mandanten definiert sind. Er wird auch als Identitätsanbieter (Identity Provider, IdP) bezeichnet. Es hostet die Onfido-Client-App, die die Benutzerdokumente sammelt und an den Onfido-API-Dienst übermittelt.
• Onfido-Client – Ein konfigurierbares JavaScript-Client-Dienstprogramm zum Sammeln von Dokumenten, das auf Webseiten bereitgestellt wird. Es überprüft Details wie Dokumentgröße und -qualität.
• Zwischen-REST-API : Stellt Endpunkte für den Azure AD B2C-Mandanten bereit, um mit dem Onfido-API-Dienst zu kommunizieren. Es übernimmt die Datenverarbeitung und hält sich an die Sicherheitsanforderungen beider.
• Onfido API-Dienst – Der Backend-Dienst, der Benutzerdokumente speichert und überprüft.

Das folgende Architekturdiagramm zeigt die Implementierung.

1. Der Benutzer meldet sich an, um ein neues Konto zu erstellen, und gibt Attribute ein. Azure AD B2C sammelt die Attribute. Die in Azure AD B2C gehostete Onfido-Client-App sucht nach Benutzerinformationen.
2. Azure AD B2C ruft die API der mittleren Ebene auf und übergibt die Attribute.
3. Die API der mittleren Schicht sammelt Attribute und konvertiert sie in ein Onfido-API-Format.
4. Onfido verarbeitet Attribute, um die Benutzeridentifikation zu validieren, und sendet das Ergebnis an die API der mittleren Schicht.
5. Die API der mittleren Ebene verarbeitet die Ergebnisse und sendet relevante Informationen im JSON-Format (JavaScript Object Notation) an Azure AD B2C.
6. Azure AD B2C empfängt die Informationen. Wenn die Antwort fehlschlägt, wird eine Fehlermeldung angezeigt. Wenn die Antwort erfolgreich ist, wird der Benutzer authentifiziert und in das Verzeichnis geschrieben.

Erstellen Sie ein Onfido-Konto

1. Erstellen Sie ein Onfido-Konto: Gehen Sie zu onfido.com Kontaktieren Sie uns und füllen Sie das Formular aus.
2. Erstellen Sie einen API-Schlüssel: Gehen Sie zu Erste Schritte (API v3.5).

Onfido Dokumentation

Live-Schlüssel sind kostenpflichtig. Sie können jedoch die Sandbox-Schlüssel zum Testen verwenden. Wechseln Sie zu onfido.com, wo Sie Informationen zu den Unterschieden zwischen Sandbox und Live erhalten. Die Sandbox-Schlüssel erzeugen die gleiche Ergebnisstruktur wie Live-Schlüssel, die Ergebnisse sind jedoch vorgegeben. Dokumente werden nicht verarbeitet oder gespeichert.

Weitere Informationen zur Onfido-Dokumentation finden Sie unter:

• Onfido API-Dokumentation
• Onfido Entwickler-Hub

Konfigurieren von Azure AD B2C mit Onfido

Bereitstellen der API

1. Stellen Sie den API-Code in einem Azure-Dienst bereit. Wechseln Sie zu samples/OnFido-Combined/API/Onfido.Api/. Sie können den Code aus Visual Studio veröffentlichen.
2. Einrichten von CORS (Cross-Origin Resource Sharing).
3. Fügen Sie den zulässigen Ursprung als https://{your_tenant_name}.b2clogin.comhinzu.

Hinzufügen vertraulicher Konfigurationseinstellungen

Konfigurieren Sie App-Einstellungen in Azure App Service, ohne sie in ein Repository einzuchecken.

REST-API-Einstellungen:

• Name der Anwendungseinstellung: OnfidoSettings:AuthToken
• Quelle: Onfido Account

Bereitstellen der Benutzeroberfläche

Konfigurieren des Speicherorts

1. Erstellen Sie im Azure-Portal einen Container.
2. Speichern Sie die UI-Dateien in /samples/OnFido-Combined/UI in Ihrem Blobcontainer.
3. CORS-Zugriff auf den von Ihnen erstellten Speichercontainer gewähren: Gehen Sie zu Einstellungen>Zulässiger Ursprung.
4. Geben Sie https://{your_tenant_name}.b2clogin.com ein.
5. Ersetzen Sie Ihren Mandantennamen durch den Namen Ihres Azure AD B2C-Mandanten, und verwenden Sie dabei Kleinbuchstaben. Beispiel: https://fabrikam.b2clogin.com.
6. Wählen Sie für Zulässige MethodenGET und PUT aus.
7. Wählen Sie Speichern aus.

Aktualisieren von UI-Dateien

1. Wechseln Sie in den Benutzeroberflächendateien zu samples/OnFido-Combined/UI/ocean_blue.
2. Öffnen Sie jede HTML-Datei.
3. Suchen Sie {your-ui-blob-container-url} und ersetzen Sie es durch die URLs Ihrer UI-Ordner ocean_blue, dist und assets.
4. Suchen Sie {your-intermediate-api-url}, und ersetzen Sie es durch die Zwischen-URL des API-App-Dienstes.

Hochladen Ihrer Dateien

1. Speichern Sie die Dateien des UI-Ordners in Ihrem Blobcontainer.
2. Verwenden Sie den Azure Storage-Explorer, um verwaltete Azure-Datenträger und Zugriffsberechtigungen zu verwalten .

Konfigurieren von Azure AD B2C

Ersetzen der Konfigurationswerte

Suchen Sie in /samples/OnFido-Combined/Policies die folgenden Platzhalter und ersetzen Sie sie durch die entsprechenden Werte aus Ihrer Instance.

* Application Insights kann sich in einem anderen Mandanten befinden. Dieser Schritt ist optional. Entfernen Sie die entsprechenden TechnicalProfiles und OrchestrationSteps, wenn sie nicht benötigt werden.

Konfigurieren der Azure AD B2C-Richtlinie

Anweisungen zum Einrichten Ihres Azure AD B2C-Mandanten und zum Konfigurieren von Richtlinien finden Sie unter Starter Pack für benutzerdefinierte Richtlinien . Benutzerdefinierte Richtlinien sind eine Reihe von XML-Dateien, die Sie in Ihren Azure AD B2C-Mandanten hochladen, um technische Profile und User Journeys zu definieren.

Testen des Benutzerflows

1. Öffnen Sie den Azure AD B2C-Mandanten.
2. Wählen Sie unter "Richtlinien" das Identitätsdarstellungsframework aus.
3. Wählen Sie Ihr zuvor erstelltes SignUpSignIn aus.
4. Wählen Sie Benutzerflow ausführen aus.
5. Wählen Sie für "Anwendung" die registrierte App aus (z. B. JWT).
6. Wählen Sie für antwort-URL die Umleitungs-URL aus.
7. Wählen Sie Benutzerflow ausführen aus.
8. Schließen Sie den Registrierungsablauf ab.
9. Erstellen Sie ein Konto.
10. Wenn das Benutzerattribut erstellt wird, wird Onfido während des Ablaufs aufgerufen.

Nächste Schritte

• Benutzerdefinierte Richtlinien in Azure AD B2C
• Erste Schritte mit benutzerdefinierten Richtlinien in Azure AD B2C