トラブルシューティング¶
getClassification() が常に insufficient または undetermined を返す¶
原因: 次のいずれかです:
- ユーザーが同意していないため、何も記録されていない。
- セッションのアクションがモデルの求める数(組み込みモデルでは 8)に達していない。結果は
insufficient。証拠を参照してください。 - 結果が
undetermined: スコアがbotThresholdとhumanThresholdの間にある。 - 取得が一時停止され、再開されていない。
- SDK がスコアリングできない:
isScoringがfalseで、結果はinsufficient。 - 自動化検出が SDK を停止した:
stoppedがnullではなく、結果はinsufficient。stoppedがnullではないを参照してください。 - ユーザーの入力が SDK の見えない場所(キー入力、または Web ビュー)で起きており、アプリがそれを 報告していない。
- アプリが 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 が次のどちらかを示します:
errorがCoreMismatchである:dea_sdkがdea_baseまたはdea_automation_detectionと異なる バージョンである。SDK は混在したバージョンでの実行を拒否し、一時停止のままになります。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 を返す¶
原因: 次のいずれかです:
DeaSdk.initにappKeyが渡されていない。その場合、attestation.detailにそう記されます。- 署名キーを作成できなかった: SDK のネイティブプラグインが登録されていない、または端末に安全なキー ストレージがない。
解決策: このプラットフォームのアプリに対して DEA が発行した appKey を渡してください。
オプションを参照してください。そうでなければ、パッケージ追加後に
アプリを完全にリビルドし、実機でテストしてください。
attest() が failed を返す¶
原因: attestation.detail が次のどれかを示します:
- Google または Apple がトークンを発行しなかった。
detailはPlay Integrity refusedまたはApp Attestで始まります。 - DEA が登録を拒否した。
detailには要求と DEA が返したステータスが記されます。たとえば/api/attest answered 403。 - DEA に到達できなかった。
- 以前の拒否の後でアテステーションが一時停止している。
detailはattestation paused untilで 始まります。 - 自動化検出が 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 は今すぐ確認します。