トラブルシューティング¶
getClassification() が .human を返さない¶
原因: 次のいずれかです。
- ユーザーが同意していないため、何も記録されていない。
- セッションのアクションがモデルの求める数(組み込みモデルでは 8)より少なく、結果が
.insufficientである。証拠を参照してください。 - 取得が一時停止され、再開されていない。
start()が呼び出されていない。- SDK がスコアリングできない。
readyがfalseで、結果が.insufficientである。 - 自動化検出が SDK を停止した。
stoppedがnilではなく、結果が.insufficientである。stoppedがnilではないを参照してください。 - スコアがモデルの 2 つのしきい値の間にあり、設計どおり
.undeterminedになっている。
解決策: 順番に確認します。
import DeaBase
import DeaSDK
if let dea = Dea.sdk {
print("consent:", dea.consent.decision) // must be granted
print("ready:", dea.ready) // must be true
print("fault:", dea.coreFault ?? "none") // must be none
print("stopped:", dea.stopped as Any) // must be nil
print("processed:", dea.coreCounts.samples) // must grow as you touch
// the result leaves `.insufficient` at 8 actions with the built-in model:
print("score:", String(describing: try? dea.getClassification()))
}
すべての pause() に対応する resume() があることを確認してください。
getClassification() が ThresholdMissing を throw する¶
原因: 読み込まれたスコアリングモデルが bot しきい値を持たないため、どの読み取り値も分類できません。
DEA が提供するすべてのモデルは組み込みモデルを含めてこれを持っています。エラーの modelVersion が、
持たないモデルを示します。
解決策: modelVersion を DEA に報告してください。しきい値を持つモデルがインストールされるまでは、
throw されたエラーを .undetermined として扱ってください。
ready が false¶
原因: DeaSDK にバンドルされたスコアリングエンジンを読み込めませんでした。coreFault が理由を示します。
coreFault |
意味 |
|---|---|
no core binary in this build |
このビルドには、そのプラットフォーム向けのスコアリングエンジンがない |
core ABI …, this adapter speaks … |
ビルド内のスコアリングエンジンが DeaSDK と異なるリリースのもの |
core built for profile …, wanted 0 |
ビルドがデスクトップブラウザ向けのスコアリングエンジンを含んでいる |
解決策: iOS 端末または iOS シミュレーター向けにビルドしてください。DeaSDK、DeaBase、DeaSDK に
バンドルされたスコアリングエンジンが同じリリースのものであることを確認し、ビルドフォルダをクリーン
(Product → Clean Build Folder)してください。
ready が false の間に停止するもの:
| 停止するもの | アプリから見えるもの |
|---|---|
| スコア | getClassification() は .unloaded を返す。coreStats は nil |
| モデルの復元 | modelInfo は .compiledIn |
| モデルの更新 | checkForModel は cancelled、"model updates are not running" で完了する |
installModel |
ModelStore.InstallRefusal.unavailable(coreFault) を throw する |
| 自動化検出 | 開始しない |
証明: record、sendProof、getProof |
proof.not_signed、dea.reason: no_core |
スコアを含む signRequest |
nil。lastRequestRefusal は "nothing signed: no core to compose the evidence"。ログには何も出ない |
sdk.ready |
代わりに sdk.core_failed。coreFault が設定され、ready は false |
取得、インテグレーション、attest()、スコアを含まない signRequest は動作を続けます。
stopped が nil ではない¶
原因: automationDetection: true のとき、SDK は自動化がアプリを操作している確実な兆候を見つけました。
SDK はすべての処理を直ちに停止しました。これはすべてのアカウントとビルドに当てはまり、テストビルドも
含みます。停止は reset() または新しい起動まで続きます。
解決策: たとえば次のセッションで reset() を呼び出すか、SDK を再び起動してください。アプリを起動し直すか、
dispose() を呼び出してから新しい DeaSdk を作成して start() を呼び出します。resume() と
setConsent(true) では停止は解除されません。自動化が続くと、SDK は再び停止します。自社の自動テストでは
automationDetection をオフのままにしてください。ステージングビルドまたはテストビルドは、発生したシグナルと
ともに automation.detected をログに書き、続けて dea.reason: automated とともに sdk.stopped を書きます。
automationDetection がオンのとき、jailbreak された iPhone でも SDK は停止します。ステージングビルドは
見つけた痕跡とともに sdk.device_compromised をログに書き、続けて sdk.stopped を書きます。reset() で停止は
解除されますが、同じ端末では SDK は再び停止します。テストビルドはログに書くだけで、動作を続けます。
| 停止するもの | アプリから見えるもの |
|---|---|
| 取得 | 何も記録されない。resume() と setConsent(true) では再開しない |
| スコア | getClassification() は、actions が 0 ですべての数値が nil の .insufficient を返す |
| モデルの更新 | checkForModel は要求なしで完了する |
| アテステーション | attest() と renewAttestation() は要求なしで .failed を返す。dea.reason: automated の attest.failed。自動更新は停止する |
証明: record、sendProof、getProof |
要求なしで、何も署名されない。proof.not_signed、dea.reason: automated。lastProofRefusal は automated |
signRequest |
nil。automated の proof.not_signed |
| インテグレーション | それ以上は何も送られない。停止前に送られたものは送信済みのまま |
reset() で停止は解除され、dispose() はいつもどおり動作します。
画面に触れても何も処理されない¶
原因: 何も記録されていません。通常はユーザーがまだ同意していないためです。それ以外では、取得が
一時停止している、start() が呼び出されていない、インスタンスが破棄されている、のいずれかです。
解決策: 同意アラートを表示して承諾してください。ユーザー同意
を参照してください。次に、起動時に start() が実行されること、すべての pause() に対応する resume()
があることを確認してください。
起動ごとに同意アラートが表示される¶
原因: 回答が保存されていないか、コードが確認なしに尋ねています。remember: false が渡されている、
consent に MemoryConsentStore 上の Consent が設定されている、または SwiftUI の deaConsent
アラートが consent.isAnswered を先に確認せずに表示されている、のいずれかです。
解決策: 端末が共有されている場合を除き、remember: false を取り除いてください。SwiftUI では、
consent.isAnswered が false のときだけ asking バインディングを設定します。
captureEvent が false を返す¶
原因: 名前が空か 64 文字を超えている、データが JSON として 1024 バイトを超えている、または何も 記録されていない(同意なし、一時停止中、破棄済み)。
解決策: 名前またはデータを短くしてください。iOS SDK は長すぎる名前を切り詰めるのではなく拒否します。 カスタムイベントを参照してください。
captureKey が何も記録しない¶
原因: events オプションに .keyDown(pressed: false の呼び出しでは .keyUp)がない、または
何も記録されていない(同意なし、一時停止中、破棄済み)。
テストビルドまたはステージングビルドは、欠けていた種類とともに capture.key_ignored をログに書きます。
解決策: events にキーの種類を追加してください。
タイピングを報告するを参照してください。
attest() を呼び出すとアプリが固まる¶
原因: attest() と renewAttestation() はネットワーク要求を行い、それが終わるまで呼び出し元の
スレッドをブロックします。メインスレッドで呼び出すと UI が固まります。
解決策: バックグラウンドキューまたは detached タスクから呼び出してください。
attest() が unsupported を返す¶
原因: 次のいずれかです。
appKeyが渡されていない。detailがそう示し、要求は行われていません。- 署名キーを作成できなかった。端末が Secure Enclave またはキーチェーンでのキー作成を拒否しました。
detailはnilです。
解決策: DEA がこのアプリ向けに発行した appKey を渡してください。
オプションを参照してください。appKey が設定されている場合は、別の
端末でテストしてください。シミュレーターでは SDK はソフトウェアキーにフォールバックするため、そこでの
unsupported はビルドのキーチェーンの問題(たとえばテストホストにキーチェーンのエンタイトルメントが
ない)を示します。
attest() は合格するが platformAttested が false¶
原因: キーが App Attest トークンなしで登録されました。iOS シミュレーター、iOS 14 より古い端末、 App Attest のない端末では想定どおりの動作です。App Attest が 15 秒以内に応答しない場合にも起きます。
解決策: iOS 14 以降を実行する実機でテストしてください。App Attest に対応した端末は次の登録で
トークンを得ます。renewAttestation() で今すぐ再登録できます。
attest() が failed を返す¶
原因: DEA が登録を拒否した、DEA に到達できなかった、または App Attest が拒否した。
解決策: attestation.detail を読み取ってください。
detail に含まれる文字列 |
意味 |
|---|---|
invalidKey |
App Attest がキーを拒否した。通常はビルドに App Attest エンタイトルメントがない。アテステーションを参照 |
/api/attest/challenge answered 401 |
DEA が appKey を認識しない |
/api/attest answered 403 |
DEA が登録を拒否した |
unreachable |
DEA から応答がない。ネットワークがない、またはタイムアウト |
attestation paused until |
App Attest を使った以前の登録を DEA が拒否し、SDK が再試行まで待機している。forgetAttestation() で待機を終える |
stopped が nil ではない場合、SDK は要求を行っていません。stopped が nil ではないを
参照してください。
ログに sdk.app_id_missing が出る¶
原因: appId が渡されていない、appId が空、または unknown-app です。SDK は DEA が登録していない本番の
appId で動作しています。
解決策: DEA がこのアプリ向けに発行した appId を渡してください。
アカウントとキーを参照してください。
モデルが更新されない¶
原因: 更新がオフになっています。sdk.model.updateFault が理由を示します。nil は更新が動作していることを
意味します。
updateFault |
原因 | 解決策 |
|---|---|---|
no_core |
スコアリングエンジンが読み込まれなかった | ready が falseを参照 |
disabled |
modelUpdates が false |
それを取り除く |
no_storage |
渡した modelDirectory、または Application Support を開けなかった |
アプリが書き込めるフォルダを渡す、または modelDirectory を設定しない |
解決策: 読み取った値の行を適用してください。nil の場合、更新は動作しています。確認は起動のたびに行われ、
checkForModel は今すぐ確認します。