async. Verwenden Sie unter .NET Framework C# 11 oder höher. In der Übersicht über die Server-SDKs erfahren Sie, was alle SDKs gemeinsam haben.
Installation
Didit.Extensions.DependencyInjection hinzu und registrieren Sie den Client mit services.AddDidit().
Die Pakete sind Didit und Didit.Extensions.DependencyInjection auf NuGet. Deren Quellcode und Changelog finden Sie unter didit-protocol/sdk-dotnet auf GitHub.
Client konfigurieren
new DiditClient() liest DIDIT_API_KEY aus der Umgebung aus. Übergeben Sie DiditClientOptions, um diesen zu überschreiben oder um die Organisations- und Anwendungs-IDs festzulegen, die Aufrufe auf Anwendungsebene (Fälle, Netzwerke, regulatorische Berichte) benötigen. Erstellen Sie einen einzelnen Client und verwenden Sie ihn wieder.
required definiert, sodass eine fehlende Eigenschaft zu einem Kompilierungsfehler führt. Optionale Eigenschaften, die Sie nicht setzen, werden nicht gesendet.
Sitzung erstellen
Erstellen Sie eine Verifizierungssitzung für einen Workflow und leiten Sie Ihren Benutzer auf deren URL weiter.Entscheidung abrufen
Sobald der Benutzer den Vorgang abgeschlossen hat (oder sobald der Webhook eingeht), rufen Sie die Entscheidung ab. Jedes Funktionsergebnis ist eine Liste mit einem Eintrag pro Workflow-Knoten.Webhook verifizieren
Übergeben Sie den Roh-Body exakt so, wie er empfangen wurde, sowie eine Möglichkeit zum Lesen der Anfrage-Header.DiditWebhooks.Verify wirft eine WebhookVerificationException für alles, was keine gültige, zeitnahe Zustellung ist, und gibt andernfalls ein typisiertes Ereignis zurück.
StreamReader ein und übergeben name => request.Headers[name].FirstOrDefault(). Wenn Sie das Secret rotieren, übergeben Sie beide: new[] { newSecret, oldSecret }. Weitere Informationen zu den Ereignissen und dem Signaturschema finden Sie unter Webhooks.
Transaktion überprüfen
Übermitteln Sie eine Zahlung, Auszahlung oder Krypto-Überweisung an die Transaktionsüberwachung; die Antwort enthält deren Status und Risiko-Score.Authentication-Token verifizieren
Authentication prüft die von Ihrem Authentication-Aussteller signierten Zugriffs-Token direkt in Ihrem Backend, ohne für jede Anfrage Didit aufzurufen. Es tauscht außerdem Codes aus, aktualisiert Token, prüft und widerruft Sitzungen und führt Step-up-Authentifizierungen durch.
Die Token-Prüfung führt die unter Token auf Ihrem Server verifizieren beschriebenen Prüfungen anhand des Ausstellers und der Signaturschlüssel Ihrer Anwendung durch.