OneSpan Developer: Intelligent Adaptive Authentication Sandbox API-Einführung

Hakim Aldaoub, 25. Juni 2020
OneSpan Developer: Intelligent Adaptive Authentication Sandbox API Intro

Mit der IAA-Sandbox-API (Intelligent Adaptive Authentication) können Entwickler OneSpan-Lösungen integrieren, einschließlich Intelligente adaptive Authentifizierung , Risikoanalyse , und OneSpan Cloud-Authentifizierung innerhalb ihrer Web- und mobilen Produkte, um Betrug besser zu erkennen und die Benutzererfahrung zu verbessern. Mit der IAA Sandbox-API können Sie Benutzer verwalten, Ereignisse validieren, Authentifikatoren zuweisen, Geräte bereitstellen und vieles mehr.

Um die Integration zu vereinfachen, entsprechen alle Services in der IAA-Sandbox der REST-Architektur. Darüber hinaus gibt es eine interaktive API-Seite mit OpenAPI Swagger-Dokumentation. Es enthält Beispiele, die Ihnen helfen, die einzelnen Dienste zu verstehen und Ihre JSON-Nutzdaten zu erstellen, um die verschiedenen Endpunkte zu erkunden. In diesem Blog erfahren Sie, wie Sie auf die interaktive API-Seite zugreifen und die Open API Swagger-Dokumentation verwenden.

Treten Sie der OneSpan-Community bei:

Bevor Sie die interaktive API erkunden können, müssen Sie Mitglied der OneSpan Community sein und sich für ein kostenloses IAA-Sandbox-Konto anmelden. Schauen Sie sich unseren vorherigen Blog an "OneSpan Cloud-Lösungen in Aktion - MyBank Web Portal-Demo, Teil 1" um zu lernen, wie man das macht.

Greifen Sie auf die interaktive API für die adaptive Authentifizierung zu

Melden Sie sich zuerst bei der an OneSpan Community-Webseite . Bewegen Sie den Mauszeiger in der Navigationsleiste in der oberen rechten Ecke über das Dropdown-Menü, in dem Ihr Benutzername angezeigt wird, und klicken Sie dann auf "Sandbox", um zur Seite mit den Sandbox-Kontodetails zu gelangen.

25.-1. Juni

Klicken Sie auf der Seite mit den Sandbox-Details auf den Link "Interaktive API für die adaptive Authentifizierung" (siehe Abbildung unten). Hiermit gelangen Sie zur OpenAPI Swagger Interactive API-Webseite.

25.-2. Juni

Wenn Sie auf den obigen Link klicken, gelangen Sie zur unten gezeigten OpenAPI Swagger Interactive API-Webseite.

25.-3. Juni

Die interaktive Swagger-API-Seite:

Auf der Seite Interaktive API werden die Endpunkte nach Ressourcen gruppiert. Beispielsweise umfasst die Authentifikatorressource die Endpunkte zum Abfragen, Zuweisen, Aufheben der Zuweisung und alle Endpunkte zum Behandeln von Authentifikatoren (siehe unten). Auf die gleiche Weise enthalten die anderen Ressourcen die zugehörigen Endpunkte, die in einem logischen Ansatz zusammengefasst sind. 

25.-4. Juni

Die vollständige Liste der verfügbaren Ressourcen in der interaktiven API enthält:
• Authentifikatoren
• Bulkfile-Upload
• Gerätebefehle
• Veranstaltungen
• Bereitstellung
• Sitzungen
• Transaktionen
• Benutzer
• Visuelle Codes

Jeder Endpunkt in der API ist durch seine HTTP-Methode gekennzeichnet, unabhängig davon, ob Get, Post, Put, Delete oder Patch. Diese Endpunkte können dann über die interaktive IAA-API getestet werden. Der OpenAPI Swagger-Editor bietet Ihnen außerdem die Möglichkeit, die URL-Pfadparameter mit einer Beschreibung für jeden dieser Parameter bequem zu bearbeiten. Diese Funktion ist im folgenden Screenshot dargestellt. Jeder dieser Parameter wird mit einem Sternchen markiert, wenn er für jeden Endpunkt erforderlich ist. 

25.-6. Juni

Darüber hinaus präsentiert die interaktive API die erwartete Struktur und Beispiele für 

• Der JSON-Anforderungshauptteil für jeden Endpunkt

25.-7. Juni

• Der JSON-Antworttext für jeden Endpunkt

25.-8. Juni

• Der erwartete Antwortcode für einen erfolgreichen oder einen fehlerhaften Webservice-Aufruf. Zum Beispiel ein Beispiel für einen 200-Antwortcode, der eine erfolgreiche Anforderung anzeigt, oder ein Beispiel für einen 400-Antwortcode, der einen Eingabedatenfehler anzeigt.

25.-9. Juni

Die interaktiven API-Schemata

Einer der wichtigsten Abschnitte der interaktiven API ist der Abschnitt Schema. Im Inneren finden Sie alle Attribute, die für jeden einzelnen Endpunkt verwendet werden können. Sie werden zusammen mit ihren Datentypen und einem Beispiel für jedes der Datenfelder aufgelistet. Sie werden feststellen, dass die erforderlichen Attribute mit einem roten Stern markiert sind. Wenn einem Attribut das Sternchen fehlt, handelt es sich um ein optionales Attribut, das nicht angegeben werden muss, wenn es im Anforderungshauptteil nicht benötigt wird.

25.-10. Juni

Weitere Informationen finden Sie in den Community Portal-Foren

Dieser Blog-Beitrag war eine Einführung in die IAA Sandbox API. Wir haben gesehen, wie die Seite "Interaktive API" mit einer Beispielvorlage für jeden Endpunktaufruf strukturiert ist, wie die Endpunkte in Ressourcen gruppiert sind und wie das Schema der Datenfelder untersucht wird. In den kommenden Blogs werden wir jeden Endpunkt einzeln untersuchen. Wenn Sie Fragen haben, erreichen Sie uns bitte unter der Community-Portal-Foren .

 

OneSpan Sign-Entwickler-Community

OneSpan Sign-Entwickler-Community

Treten Sie der OneSpan Sign Developer Community bei! Foren, Blogs, Dokumentationen, SDK-Downloads und mehr.

Tritt heute bei