コンテンツにスキップ

DEA SDK for Web

ブラウザーのセッションが実在の人物によるものかどうかを検出します。SDK はページ上のポインター、ホイール、 キーボード、端末の動きの入力を観測し、セッションをブラウザー内でスコアリングします。

このページの内容: 前提条件 · インストール · SDK の初期化 · 分類を使う · セットアップの確認 · リリース前に · 次のステップ

前提条件

  • このアプリ用の appId と appKey — アカウントとキーを参照
  • HTTPS で配信されるページ、または開発中の localhost。SDK はセキュアコンテキストを必要とします。 それ以外のページではブラウザーが crypto.randomUUID() を提供しないため、init は例外を投げます。
  • Chrome または Edge 96、Firefox 95、Safari 15.4(iOS 15.4)以降で、WebAssembly が有効なこと。 これらは、SDK が起動時に呼ぶ crypto.randomUUID() と、スコアリングエンジンが使う WebAssembly の機能の 両方を備えた最初のバージョンです。
  • ES モジュールを読み込むバンドラーなどのツール(Vite、webpack、Rollup、esbuild)。パッケージは ES モジュールのみで公開されています。

インストール

注: @dea/sdk は npm レジストリではなく、DEA のリリース URL からインストールします。URL が リリースを指定します。アップグレードするには、新しいリリースの URL をインストールします。依存する @dea/base パッケージも同じリリースから取得され、一緒にインストールされます。

npm

npm install https://sdk.dep-protocol.com/0.26.0/web/sdk/dea-sdk-0.26.0.tgz

yarn

yarn add https://sdk.dep-protocol.com/0.26.0/web/sdk/dea-sdk-0.26.0.tgz

pnpm

pnpm add https://sdk.dep-protocol.com/0.26.0/web/sdk/dea-sdk-0.26.0.tgz

注: pnpm 11 はこのインストールを ERR_PNPM_EXOTIC_SUBDEP で停止します。@dea/sdk が @dea/base に URL で依存しているためです。プロジェクトのルートにある pnpm-workspace.yaml に次の行を追加し (ファイルがなければ作成し)、インストールをやり直してください。

blockExoticSubdeps: false

Content Security Policy

ページが Content Security Policy を送信している場合、次を許可する必要があります。許可しないと、SDK は スコアリングエンジンを読み込めず、DEA にも到達できません。

ディレクティブ 許可する値 理由
script-src 'wasm-unsafe-eval' SDK は WebAssembly のスコアリングエンジンをページ内でコンパイルします
connect-src data: エンジンはパッケージの JavaScript に埋め込まれ、data: URL から読み込まれます。coreUrl を設定している場合は、代わりにその URL を許可します
connect-src https://sdk.dep-protocol.com スコアリングモデルの更新。modelUpdates: false の場合は不要です
connect-src https://poh-api.dep-protocol.com attest() と広告の証明

例:

Content-Security-Policy: script-src 'self' 'wasm-unsafe-eval'; connect-src 'self' data: https://sdk.dep-protocol.com https://poh-api.dep-protocol.com

パッケージは自身のコードの一部を動的な import() で読み込みます。バンドラーはそのチャンクを他のスクリプトと 一緒に出力するため、バンドルを許可する script-src がそのまま適用されます。

SDK の初期化

取得がセッション全体を覆うように、ページ読み込みのできるだけ早い段階で一度だけ初期化します。

import { init } from '@dea/sdk';

const dea = init({
  appId: 'YOUR_APP_ID',
  appKey: 'YOUR_APP_KEY',
});
  • appId と appKey は、DEA がこのアプリに発行したペアです。どちらも秘密ではなく、ページに含めて配信 されます。appKey がなくてもスコアリングは動作しますが、本番の appId で appKey がない場合、 attest() は 'failed' を返し、広告の証明は署名も送信もされません。 アカウントとキーを参照してください。
  • init は複数回呼んでも安全です。再度の呼び出しは実行中のインスタンスを返し、そのセッションを維持 します。再度の呼び出しのオプションは無視されます。
  • スコアリングエンジンを読み込めない場合でも init は値を返し、SDK はスコアなしで動作を続けます。 分類は 'insufficient' のままです。dea.ready() が解決した後、dea.error に理由が報告されます。
  • 取得は即座に始まります。ラップするものも登録するものもありません。ユーザーが同意するまで取得を 保留するには、ユーザー同意を参照してください。
  • SDK は、ページがデスクトップブラウザーかモバイルブラウザーで動いているかを判定します。自分で 選ぶには、profile を参照してください。

コード内の他の場所では、DeaSdk.current で実行中のインスタンスを取得します。

import { DeaSdk } from '@dea/sdk';

const dea = DeaSdk.current; // null before init

分類を使う

判断を下す瞬間に分類を読み取ります。読み取りは同期的で、 ネットワークを待ちません。

import { DeaSdk } from '@dea/sdk';

async function onSignUp(form: SignUpForm) {
  const result = DeaSdk.current?.getClassification().result ?? 'insufficient';
  if (result === 'human') {
    await submitSignUp(form);
  } else {
    showChallenge(); // 'bot', 'undetermined' or 'insufficient': a captcha, a delay, a manual review
  }
}

SignUpForm、submitSignUp、showChallenge はアプリ側のコードを表します。スコアとしきい値がどのように 生成されるかは、スコアリングの仕組みで説明しています。

セットアップの確認

  1. SDK が読み込まれたことを確認します。init を呼んだページで次を実行します。

    import { DeaSdk } from '@dea/sdk';
    
    const dea = DeaSdk.current!;
    await dea.ready();
    console.log(dea.error);            // null: the scoring engine loaded
    console.log(dea.getSessionInfo()); // { session: '…', device: { … }, identity: { … }, motion: 'off', sdk: { version: '0.26.0', core: '…' } }
    

    dea.error が null でない場合は、トラブルシューティングを参照してください。

  2. ページを操作し(ポインターを動かす、クリックする、スクロールする、入力する)、分類をもう一度読み取ります。

    console.log(dea.getClassification());
    // { result: 'insufficient', value: null, actions: 6, botThreshold: …, humanThreshold: …, modelVersion: … }
    

    タップ、ドラッグ、スクロール、連続したキー入力のそれぞれがアクションです。 actions はスコアの根拠となったアクションの数で、result はセッションが 十分になるまで、つまりモデルが求める数に達するまで 'insufficient' のままです。組み込みモデルでは、デスクトップブラウザーで 20 個(ポインター、 スクロール、キーボードのうち少なくとも 2 種類の入力から、それぞれ 3 個以上)、スマートフォンや タブレットのブラウザーで 8 個です。証拠を参照してください。

  3. 統合中に SDK の動作を観察するには、本番パッケージの代わりにステージングパッケージをインストール します。ログを有効にした同じ SDK で、ブラウザーのコンソールに出力します。

    npm install https://sdk.dep-protocol.com/0.26.0/staging/web/sdk/dea-sdk-0.26.0.tgz
    

    ページを再読み込みします。初回訪問時、コンソールには次のように表示されます。

    dea 2026-10-16T01:39:29.699Z INFO  sdk.started                    ok      session.id=none account=production | SDK started on a production account
    dea 2026-10-16T01:39:29.731Z INFO  model.installed                ok      session.id=ee0962fd-… model.version=0 model.source=embedded model.theta_bot=… | Model 0 installed from embedded
    dea 2026-10-16T01:39:29.731Z INFO  sdk.ready                      ok      session.id=ee0962fd-… core=web-desktop profile=web-desktop | SDK ready: core web-desktop, profile web-desktop
    

    代わりに sdk.core_failed が表示される場合は、 トラブルシューティングを参照してください。

警告: ステージングパッケージはスコアリングモデルを DEA のステージングチャネルからダウンロードする ため、その分類は本番と異なることがあります。リリース前に本番パッケージを再インストールしてください。 本番パッケージはログを一切出力しません。

リリース前に

  • [ ] 本番パッケージがインストールされている: URL に /staging/ が含まれていない
  • [ ] init に、DEA がこのアプリに発行した appId と appKey を渡している — アカウントとキーを参照
  • [ ] ページが HTTPS で配信されている
  • [ ] Content Security Policy が SDK を許可している — Content Security Policy を参照
  • [ ] 判断ポイントで分類を読み取り、'bot'、'undetermined'、'insufficient' のフォールバックがある — ヒューマンスコアリングを参照
  • [ ] 支払いフィールドと、プライバシーポリシーで除外する画面で取得を一時停止している — 機密性の高い画面を参照
  • [ ] ログアウト時に reset() を呼んでいる — セッションを参照
  • [ ] ユーザーに必要な場所で同意を求めている — ユーザー同意を参照
  • [ ] プラットフォーム共通のチェックリストを完了している — 本番環境への移行を参照

次のステップ