署名検証

Tヒント (TIP)

加盟店は以下の手順に従って、レスポンスまたはコールバックの署名を検証できます。

検証された加盟店のリクエスト署名が正しい場合、tokenpayはレスポンスのHTTPヘッダーに返信署名を含めます。加盟店にはレスポンス署名を検証することをお勧めします。

同様に、tokenpayはコールバックのHTTPヘッダーにコールバックパケットの署名を含めます。加盟店は、コールバックがtokenpayから送信されたことを確認するために、コールバックの署名を必ず検証する必要があります。

連結 (Concatenate)

まず、加盟店はレスポンスから以下の情報を取得します。

• HTTPヘッダー TTPay-Timestamp 内の返信タイムスタンプ。

• HTTPヘッダー TTPay-Nonce 内の返信ランダム文字列。

• レスポンス本文 (Response Body)。インターフェースから返された順序に従って確認します。順序が正しくないと検証に失敗します。

署名文字列は3行で構成され、1行につき1つのパラメーターが含まれます。行の末尾は \n (改行、ASCII文字コード 0x0A) で終わりますが、最後の行には \n を追加しないでください。パラメーター自体が \n で終わっている場合でも、追加で \n を付与する必要があります。

Reply timestamp\n
Reply random string\n
Reply message body

例えば、HTTP返信メッセージは以下のようになります：

HTTP/1.1 200 OK
Server: nginx
Date: Tue, 02 Apr 2019 12:59:40 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 2204
Connection: keep-alive
Keep-Alive: timeout=8
Content-Language: zh-CN
TTPay-Nonce: c5ac7061fccab6bf3e254dcf98995b8c
TTPay-Signature: CtcbzwtQjN8rnOXItEBJ5aQFSnIXESeV28Pr2YEmf9wsDQ8Nx25ytW6FXBCAFdrr0mgqngX3AD9gNzjnNHzSGTPBSsaEkIfhPF4b8YRRTpny88tNLyprXA0GU5ID3DkZHpjFkX1hAp/D0fva2GKjGRLtvYbtUk/OLYqFuzbjt3yOBzJSKQqJsvbXILffgAmX4pKql+Ln+6UPvSCeKwznvtPaEx+9nMBmKu7Wpbqm/+2ksc0XwjD+xlvlECkCxfD/OJ4gN3IurE0fpjxIkvHDiinQmk51BI7zQD8k1znU7r/spPqB+vZjc5ep6DC5wZUpFu5vJ8MoNKjCu8wnzyCFdA==
TTPay-Timestamp: 1554209980
Cache-Control: no-cache, must-revalidate

{"app_id":"xxxx"}

その場合の署名文字列は以下のようになります：

1554209980
c5ac7061fccab6bf3e254dcf98995b8c
{"app_id":"xxxx"}

返信 (Reply)

tokenpayの返信署名はHTTPヘッダー TTPay-Signature を通じて送信されます。（注：組版の都合上、改行が含まれる場合がありますが、実際のデータは1行にする必要があります）

CtcbzwtQjN8rnOXItEBJ5aQFSnIXESeV28Pr2YEmf9wsDQ8Nx25ytW6FXBCAFdrr0mgqngX3AD9gNzjnNHzSGTPBSsaEkIfhPF4b8YRRTpny88tNLyprXA0GU5ID3DkZHpjFkX1hAp/D0fva2GKjGRLtvYbtUk/OLYqFuzbjt3yOBzJSKQqJsvbXILffgAmX4pKql+Ln+6UPvSCeKwznvtPaEx+9nMBmKu7Wpbqm/+2ksc0XwjD+xlvlECkCxfD/OJ4gN3IurE0fpjxIkvHDiinQmk51BI7zQD8k1znU7r/spPqB+vZjc5ep6DC5wZUpFu5vJ8MoNKjCu8wnzyCFdA==

判定 (Judgment)

AES-256-ECB メソッドを使用して署名を生成します（署名生成 を参照できます）。生成された署名を返信署名と比較します。一致しない場合、データは改ざんされています。