Verify Token API について

Verify Token API は、デバイス検証を提供するために使用されるものです。新規登録されたデバイスがアプリケーション・バックエンドによって検証されたことを確認するためのプロセスです。

これはアプリケーションバックエンドで行われ、Safous Web Application and API Protection (WAAP)で完了します。 

Flow Diagram

VT Diagram

説明:

処理を行う前に、バックエンドアプリケーションは秘密鍵を生成し、公開鍵の値をSafous WAAPと共有します。

  1. クライアントアプリケーションが登録顧客のverification tokenを要求し、(JWT形式の)verify_tokenを返します。
  2. クライアントアプリケーションがsafous WAAPにデバイス認証を要求し、顧客が登録したことを示す200のOK httpレスポンスを返します。 


Verify Token API – Backend Application

このAPIは、Safous WAAPでのデバイス登録処理後、クライアントデバイスからアプリケーションバックエンドで指定されたURLへコールされます。Verify Token API の目的は、この API を呼び出す Safous に登録されたデバイスがユーザのアプリケーションによって使用されていることを、アプリケーションバックエンドが検証することです。
デバイスリクエストを検証することで、アプリケーションバックエンドはアプリケーションユーザーを識別するトークン(Verify Token)を返します。

このAPIは、アプリケーションのバックエンドが提供するか、アプリケーションの所有者が信頼するサードパーティによって提供することができます。 

Request

URL

https://example.xxx.xxxx.safous.com/api/devices/verify

Method

GET

Content-Type

application/json

Body

{"device_id": "xxxxxxxxxxxxxxxx"}

 

 

 

 

Description

device_id

device_id or Session id

 

 

Response

Body

{"verify_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIwODUzNTM1MzUzNTMiLCJuYW1lIjoieXVkaGEgc2l0dW1vcmFuZyIsImlhdCI6MTUxNjIzOTAyMn0.tHptXTxwg85Y-DkN0H8VRZ-mK_FBi7L6HNtwgm6ekPk",

"token_type":"Bearer",

"expires_in":"60"}

Description

Verify_token

Verification user for safous WAAP in format JWT

token_type

Token type

expires_in

Expired verify_token (in second)

 

 

 

 

 

Verify Token API – Safous WAAP

このAPIは、アプリケーションバックエンドからVerify Tokenを受け取った後、クライアント端末によって呼び出されます。
Safous WAAPはこのリクエストを受け取ると、このトークンの有効性を検証し、クライアント端末にリンクされたポリシーを更新することで、アプリケーションバックエンドのAPIにアクセスするために設定された別のURLに接続できるようにします。