OneSpan開発者:インテリジェント適応認証サンドボックスAPIの紹介

Hakim Aldaoub, 2020年6月25日

インテリジェント適応認証(IAA)サンドボックスAPIを使用すると、開発者はOneSpanソリューションを統合できます。インテリジェント適応認証リスク分析 、および OneSpan Cloud認証 、ウェブおよびモバイル製品内で不正をより適切に検出し、ユーザーエクスペリエンスを向上させます。IAA Sandbox APIを使用して、ユーザーの管理、イベントの検証、認証システムの割り当て、デバイスのプロビジョニングなどを行うことができます。

統合を容易にするために、IAAサンドボックスのすべてのサービスはRESTアーキテクチャに準拠しています。さらに、OpenAPI Swaggerのドキュメントを含むインタラクティブなAPIページがあります。さまざまなエンドポイントを探索するために、各サービスを理解し、JSONペイロードを構築するのに役立つ例があります。このブログでは、インタラクティブAPIページにアクセスし、Open API Swaggerのドキュメントを使用する方法を確認します。

OneSpanコミュニティに参加:

Interactive APIを探索する前に、OneSpanコミュニティのメンバーであり、無料のIAAサンドボックスアカウントにサインアップする必要があります。以前のブログをチェックしてください 「OneSpan Cloud Solutions In Action-MyBank Web Portal Demo、Part 1」 その方法を学ぶ。

適応認証インタラクティブAPIにアクセスする

最初に、 OneSpan Community Webページ 。次に、右上隅のナビゲーションバーから、ユーザー名が表示されているドロップダウンメニューにカーソルを合わせ、[サンドボックス]をクリックすると、サンドボックスアカウントの詳細ページに移動します。

June25th-1

サンドボックスの詳細ページで、下のスクリーンショットに示すように、「適応認証インタラクティブAPI」というラベルの付いたリンクをクリックします。これにより、OpenAPI Swagger Interactive API Webページが表示されます。

6月25日-2

上記のリンクをクリックすると、以下に示すOpenAPI Swagger Interactive API Webページに移動します。

June25th-3

インタラクティブSwagger APIページ:

インタラクティブAPIページでは、エンドポイントはリソースごとにグループ化されます。たとえば、オーセンティケーターリソースは、以下に示すように、クエリ、割り当て、割り当て解除、およびオーセンティケーターを処理するすべてのエンドポイントを含みます。同様に、他のリソースには、論理的なアプローチでグループ化された関連するエンドポイントが含まれます。 

6月25日-4

インタラクティブAPIで利用可能なリソースの完全なリストは次のとおりです。
•オーセンティケーター
•バルクファイルのアップロード
•デバイスコマンド
•イベント
•プロビジョニング
•セッション
•トランザクション
•ユーザー
•ビジュアルコード

APIの各エンドポイントは、Get、Post、Put、Delete、PatchのいずれのHTTPメソッドでマークされます。これらのエンドポイントは、IAAインタラクティブAPI内からテストできます。また、OpenAPI Swaggerエディターには、URLパスパラメーターを各パラメーターの説明とともに簡単に編集するオプションがあります。この機能は下のスクリーンショットに示されています。これらの各パラメーターは、各エンドポイントに必要な場合、アスタリスクでマークされます。 

6月25日〜6日

さらに、インタラクティブAPIは、期待される構造と例を提示します。 

•各エンドポイントのJSONリクエスト本文

June25th-7

•各エンドポイントのJSON応答本文

6月25日〜8日

•Webサービスコールの成功またはエラーに対して予期される応答コード。たとえば、成功した要求を示す200応答コードの例、または入力データエラーを示す400応答コードの例。

6月25日-9

インタラクティブAPIスキーマ

インタラクティブAPIの最も重要なセクションの1つは、スキーマセクションです。内部には、すべての単一のエンドポイントに利用できるすべての属性があります。それらは、データタイプおよび各データフィールドの例とともにリストされます。必要な属性が赤いアスタリスクでマークされていることがわかります。属性にアスタリスクがない場合、それはオプションの属性であり、リクエストの本文で必要ない場合は指定する必要はありません。

June25th-10

コミュニティポータルフォーラムで詳細を確認する

このブログ投稿は、IAAサンドボックスAPIの紹介です。Interactive APIページが各エンドポイント呼び出しのサンプルテンプレートでどのように構造化されるか、エンドポイントがリソースにグループ化される方法、およびデータフィールドのスキーマを探索する方法を見てきました。今後のブログでは、各エンドポイントを個別に探索します。また、ご不明な点がございましたら、コミュニティポータルフォーラム

 

OneSpan Sign開発者コミュニティ

OneSpan Sign開発者コミュニティ

OneSpan Sign開発者コミュニティに参加してください!フォーラム、ブログ、ドキュメント、SDKダウンロードなど。

今日参加します