コンテンツにスキップ

アテステーション

このブラウザーの署名キーを 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 が割り当てた信頼ティア