コンテンツにスキップ

トラブルシューティング

getClassification() が常に insufficient または undetermined を返す

原因: 次のいずれかです:

  1. ユーザーが同意していないため、何も記録されていない。
  2. セッションのアクションがモデルの求める数(組み込みモデルでは 8)に達していない。結果は insufficient。証拠を参照してください。
  3. 結果が undetermined: スコアが botThreshold と humanThreshold の間にある。
  4. 取得が一時停止され、再開されていない。
  5. SDK がスコアリングできない: isScoring が false で、結果は insufficient。
  6. 自動化検出が SDK を停止した: stopped が null ではなく、結果は insufficient。 stopped が null ではないを参照してください。
  7. ユーザーの入力が SDK の見えない場所(キー入力、または Web ビュー)で起きており、アプリがそれを 報告していない。
  8. アプリが 5 分を超えてバックグラウンドにあった後に戻り、証拠がやり直された。

解決策: それぞれ順番に確認します:

final dea = DeaSdk.instance!;

debugPrint('consent: ${dea.consent.decision}'); // must be granted
debugPrint('scoring: ${dea.isScoring}');        // must be true
debugPrint('error: ${dea.error}');              // must be null
debugPrint('stopped: ${dea.stopped}');          // must be null

final read = dea.getClassification();
debugPrint('result: ${read.result}, actions: ${read.actions}, '
    'score: ${read.value}, thresholds: ${read.botThreshold}..${read.humanThreshold}, '
    'model: ${read.modelVersion}');
  • insufficient は、アクションがまだモデルの求める数に達していないことを意味します。組み込みモデルでは actions が 8 未満で、score は null です。
  • undetermined は、スコアが 2 つのしきい値の間にあることを意味します。
  • すべての pause() に対応する resume() があることを確認してください。
  • SDK が見えない入力については、 SDK が見えない入力を報告するを 参照してください。

getClassification() が ThresholdMissing を投げる

原因: 読み込まれたモデルに bot しきい値がありません。そのバージョンは例外の modelVersion に あります。

解決策: 判断ポイントで ThresholdMissing を捕捉し、フォールバックの経路に進んでください。モデルの 更新が動作していること(modelUpdates: false を設定しない限り動作します)を確認し、DEA が 新しいモデルを公開したときに SDK がモデルを置き換えられるようにしてください。 checkForModel(force: true) はすぐに確認します。オプションを 参照してください。

ユーザーが操作しても getClassification().actions が 0 のまま

原因: 何も記録されていません。通常はユーザーがまだ同意していないためです。そうでなければ、取得が 一時停止しているか、events がテストしている入力を除外しています。

解決策: 同意ダイアログを表示して受け入れてください。 ユーザー同意を参照してください。同意が与えられている場合は、 対応する resume() のない pause() がないか確認し、events を 確認してください。

debug: true でもログに何も表示されない

原因: 公開されている Flutter パッケージにはログが含まれていません。debug と onLog はそこでは 効果を持ちません。

解決策: 代わりにコードから SDK を確認してください。 セットアップの確認を参照してください。

isScoring が false で、error が設定されている

原因: スコアリングエンジンが動作していません。error が次のどちらかを示します:

  1. error が CoreMismatch である: dea_sdk が dea_base または dea_automation_detection と異なる バージョンである。SDK は混在したバージョンでの実行を拒否し、一時停止のままになります。
  2. error が読み込み時に投げられた例外である: この端末でスコアリングエンジンを読み込めなかった。パッケージは Android の arm64-v8a と x86_64 向けに同梱しているため、32 ビットアプリしか実行できない端末(armeabi-v7a)には存在しません。

解決策: バージョンの混在については、同じリリースから 3 つの zip をすべてダウンロードし、dea_base と dea_automation_detection がそれらのコピーを指すようにします:

dependencies:
  dea_sdk:
    path: vendor/dea/sdk

dependency_overrides:
  dea_base:
    path: vendor/dea/base
  dea_automation_detection:
    path: vendor/dea/automation_detection

続けて flutter pub get を実行します。

ライブラリを読み込めない場合は、64 ビットの端末またはエミュレーターでテストしてください。スコアリング エンジンのない端末でも SDK は動作を続け、getClassification() は insufficient を返します。

スコアリングエンジンが動作していない間に停止するもの:

停止するもの アプリから見えるもの
スコア Classification.unscored(insufficient)。isScoring は false。coreStats は null
モデルの復元と更新 model はバージョン 0、ソース embedded、updateFault は no_core。checkForModel は cancelled、"model updates are not running" を返す
自動化検出 開始しない
証明: record、sendProof、getProof proof.not_signed、outcome は refused、dea.reason: no_core
スコアを含む signRequest null。lastRequestRefusal は "nothing signed: no core to compose the evidence"。ログには何も出ない
replaySession null
sdk.ready 代わりに sdk.core_failed。error が設定される
取得(バージョンの混在の場合のみ) 何も取得されない

取得、インテグレーション、attest()、スコアを含まない signRequest は動作を続けます。

stopped が null ではない

原因: automationDetection: true のとき、SDK は自動化がアプリを操作している確実な兆候を見つけました。 SDK はすべての処理を直ちに停止しました。これはすべてのアカウントとビルドに当てはまり、テストビルドも 含みます。停止は reset() または新しい起動まで続きます。

解決策: たとえば次のセッションで reset() を呼ぶか、SDK を再び起動してください。アプリを起動し直すか、 dispose() の後に init を呼びます。resume() と setConsent(true) では停止は解除されません。自動化が 続くと、SDK は再び停止します。自社の自動テストでは automationDetection をオフのままにしてください。 ステージングビルドまたはテストビルドは、発生したシグナルとともに automation.detected をログに書き、続けて dea.reason: automated とともに sdk.stopped を書きます。

automationDetection がオンのとき、root 化された Android 端末や jailbreak された iPhone でも SDK は停止します。 ステージングビルドは見つけた痕跡とともに sdk.device_compromised をログに書き、続けて sdk.stopped を 書きます。reset() で停止は解除されますが、同じ端末では SDK は再び停止します。テストビルドはログに書くだけで、 動作を続けます。

Android の外付けタッチスクリーンでは SDK は停止しません。ステージングビルドまたはテストビルドはそれを automation.soft_signal としてログに書き、SDK は動作を続けます。

停止するもの アプリから見えるもの
取得 何も記録されない。resume() と setConsent(true) では再開しない
スコア getClassification() は、actions が 0 ですべての数値が null の insufficient を返す
モデルの更新 checkForModel は要求なしで応答する
アテステーション attest() は要求なしで failed を返す。dea.reason: automated の attest.failed。自動更新は停止する
証明: record、sendProof、getProof 要求なしで、何も署名されない。proof.not_signed、dea.reason: automated。lastProofRefusal は automated
signRequest null。automated の proof.not_signed。lastRequestRefusal は automated
インテグレーション それ以上は何も送られない。停止前に送られたものは送信済みのまま

reset() で停止は解除され、dispose() はいつもどおり動作します。

後から呼んだ init に渡したオプションが無視される

原因: DeaSdk.init が複数回呼ばれています。最初の呼び出しのオプションが有効なままです。 ステージングビルドまたはテストビルドは sdk.init_repeated をログに書き、dea.option が最初に異なる オプションを示します。

解決策: DeaSdk.init は main() で一度だけ呼んでください。本当に異なるオプションが必要な場合は、 先に DeaSdk.instance?.dispose() を呼んでください。

原因: 回答が保存されていません。remember: false が渡されているか、SDK のネイティブプラグインが アプリに登録されていない(たとえば add-to-app の構成)ために回答を保存できません。

解決策: 端末が共用でなければ remember: false を外してください。そうでなければ、アプリが生成された プラグイン登録コードを使っていることを確認し、パッケージ追加後はホットリスタートではなくアプリを完全に リビルドしてください。

attest() が unsupported を返す

原因: 次のいずれかです:

  1. DeaSdk.init に appKey が渡されていない。その場合、attestation.detail にそう記されます。
  2. 署名キーを作成できなかった: SDK のネイティブプラグインが登録されていない、または端末に安全なキー ストレージがない。

解決策: このプラットフォームのアプリに対して DEA が発行した appKey を渡してください。 オプションを参照してください。そうでなければ、パッケージ追加後に アプリを完全にリビルドし、実機でテストしてください。

attest() が failed を返す

原因: attestation.detail が次のどれかを示します:

  1. Google または Apple がトークンを発行しなかった。detail は Play Integrity refused または App Attest で始まります。
  2. DEA が登録を拒否した。detail には要求と DEA が返したステータスが記されます。たとえば /api/attest answered 403。
  3. DEA に到達できなかった。
  4. 以前の拒否の後でアテステーションが一時停止している。detail は attestation paused until で 始まります。
  5. 自動化検出が SDK を停止したため、要求は行われていない。 stopped が null ではないを参照してください。

解決策:

  • Android では、Google Play のテストトラックからインストールしたビルドを、Google Play 開発者サービスの ある端末でテストし、アプリの Play Console エントリが Play Integrity にリンクされていることを確認して ください。アテステーションを参照してください。
  • iOS では、detail に invalidKey が含まれる場合、通常はビルドに App Attest ケイパビリティが欠けて います。アテステーションを参照してください。
  • appKey がこのプラットフォームのアプリに対して DEA が発行したものであることを確認してください。 Android では Android のキー、iOS では iOS のキーです。
  • 一時停止したアテステーションは、detail に示された時刻に自動的に再開します。

attest() は成功するが platformAttested が false

原因: プラットフォームに渡せるトークンがありません。アプリが iOS シミュレーター、または App Attest が利用できない iOS 12 か 13 で動作しています。

解決策: iOS 14 以降の実機でアテステーションをテストしてください。 アテステーションを参照してください。

Web ビュー内のタッチが数えられない

原因: Web ビューは自身のタッチを自分で処理し、Flutter はそれらを SDK にルーティングしません。

解決策: capturePointer で転送してください。 Web ビュー内のタッチを報告するを 参照してください。転送したタッチがそれでも数えられない場合は、その種別が events に含まれていること、x と y にウィンドウ内での Web ビューのオフセットが含まれていることを確認してください。

ログに sdk.app_id_missing が出る

原因: appId が渡されていない、appId が空、または unknown-app です。SDK は DEA が登録していない本番の appId で動作しています。

解決策: DEA がこのアプリ向けに発行した appId を渡してください。 アカウントとキーを参照してください。

モデルが更新されない

原因: 更新がオフになっています。DeaSdk.instance?.model.updateFault が理由を示します。null は更新が 動作していることを意味します。

updateFault 原因 解決策
no_core スコアリングエンジンが読み込まれなかった isScoring が false で、error が設定されているを参照
disabled init に modelUpdates: false が渡された それを取り除く
no_storage modelDirectory がなく、プラットフォームがフォルダを提供しなかった(Android と iOS 以外のすべてのプラットフォーム) modelDirectory を渡す

解決策: 読み取った値の行を適用してください。null の場合、更新は動作しています。確認は起動のたびに 行われ、checkForModel は今すぐ確認します。