アテステーション¶
このブラウザーの署名キーを DEA に登録します。SDK は最初に必要になったときにキーを作成し、ブラウザーの IndexedDB に保持します。秘密鍵の側は、ページ、他のスクリプト、SDK 自身のいずれからも読み取れません。 署名付きの証明(広告を参照)はこのキーで 署名され、DEA は登録済みのキーによる証明のみを受理します。
Web のアテステーションはキーの登録のみです。 ブラウザーには Play Integrity や App Attest のようなプラットフォームのアテステーションがありません。
passedの結果は DEA がキーを受理したことを意味し、端末が正規のものかどうかについては何も示しません。
使いどころ¶
- 広告セッションを開く前。SDK が自らキーを登録することは なく、DEA は未登録のキーで署名されたすべての証明を拒否します
- 機密性の高いステップの前に、キーが登録されていることを確実にする
- 診断画面にアテステーションの状態を表示する
前提条件¶
- SDK がインストールされ、
appIdとappKeyで初期化されていること。 クイックスタートとアカウントとキーを 参照してください。 - ページが HTTPS または
localhostから配信されていること。 - ブラウザーが IndexedDB を許可していること。一部のプライベートブラウジングモードでは許可されません。
- Content Security Policy が
connect-srcでhttps://poh-api.dep-protocol.comを許可していること。 Content Security Policy を参照してください。
使い方¶
アテステーションを行う¶
import { DeaSdk } from '@dea/sdk';
const attestation = await DeaSdk.current?.attest();
switch (attestation?.verdict) {
case 'passed':
// DEA accepted this browser's key.
break;
case 'unsupported':
// No key could be created: storage refused, or no Web Crypto.
break;
case 'failed':
// DEA refused, could not be reached, or no appKey was set.
break;
}
attest() は決して例外を投げません。DEA から一度限りのチャレンジを取得し、キーの公開側をそれと一緒に、
appKey の下で送り返します。passed の結果は expiresAt の 60 秒前まで保持されます。それまでに再度
attest() を呼ぶと、要求を送らずに即座に答えます。その後の次の呼び出しはキーを再登録します。SDK が
自動的に更新することはありません。failed の結果は保持されないため、次の呼び出しで再試行されます。
本番の appId で appKey がない場合、attest() は要求を送らずに 'failed' を返します。
例¶
支払いステップの前にアテステーションを行う¶
import { DeaSdk } from '@dea/sdk';
async function openPayment() {
const attestation = await DeaSdk.current?.attest();
if (attestation?.verdict !== 'passed') {
reportDiagnostic('attestation', attestation);
}
showPaymentForm();
}
reportDiagnostic と showPaymentForm はアプリ側のコードを表します。
API¶
| メンバー | 戻り値 | 説明 |
|---|---|---|
attest() |
Promise<Attestation> |
キーを登録し、結果を返す |
Attestation:
| フィールド | 型 | 説明 |
|---|---|---|
supported |
boolean |
このブラウザーでキーを作成できたかどうか |
verdict |
'passed' \| 'failed' \| 'unsupported' |
結果 |
expiresAt |
number \| null |
登録の有効期限(エポック秒) |
kid |
string \| null |
キーの識別子 |
tier |
string \| null |
DEA が割り当てた信頼ティア |