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¶
yarn¶
pnpm¶
注: pnpm 11 はこのインストールを
ERR_PNPM_EXOTIC_SUBDEPで停止します。@dea/sdkが@dea/baseに URL で依存しているためです。プロジェクトのルートにあるpnpm-workspace.yamlに次の行を追加し (ファイルがなければ作成し)、インストールをやり直してください。
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';
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 はアプリ側のコードを表します。スコアとしきい値がどのように
生成されるかは、スコアリングの仕組みで説明しています。
セットアップの確認¶
-
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でない場合は、トラブルシューティングを参照してください。 -
ページを操作し(ポインターを動かす、クリックする、スクロールする、入力する)、分類をもう一度読み取ります。
console.log(dea.getClassification()); // { result: 'insufficient', value: null, actions: 6, botThreshold: …, humanThreshold: …, modelVersion: … }タップ、ドラッグ、スクロール、連続したキー入力のそれぞれがアクションです。
actionsはスコアの根拠となったアクションの数で、resultはセッションが 十分になるまで、つまりモデルが求める数に達するまで'insufficient'のままです。組み込みモデルでは、デスクトップブラウザーで 20 個(ポインター、 スクロール、キーボードのうち少なくとも 2 種類の入力から、それぞれ 3 個以上)、スマートフォンや タブレットのブラウザーで 8 個です。証拠を参照してください。 -
統合中に SDK の動作を観察するには、本番パッケージの代わりにステージングパッケージをインストール します。ログを有効にした同じ SDK で、ブラウザーのコンソールに出力します。
ページを再読み込みします。初回訪問時、コンソールには次のように表示されます。
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()を呼んでいる — セッションを参照 - [ ] ユーザーに必要な場所で同意を求めている — ユーザー同意を参照
- [ ] プラットフォーム共通のチェックリストを完了している — 本番環境への移行を参照
次のステップ¶
- ヒューマンスコアリング — 分類とその根拠となる証拠を読み取る
- ユーザー同意 — ユーザーが同意するまで取得を保留する
- 機密性の高い画面 — 支払いフィールドで取得を一時停止する
- セッション — ログアウト時に新しいセッションを開始する
- アテステーションと広告 — ブラウザーのキーを登録し、広告の証明に署名する
- オプション —
initが受け付けるすべてのオプション - プライバシーとネットワーク — SDK が取得・保存・送信するもの
- トラブルシューティング