コンテンツにスキップ

トラブルシューティング

getClassification() が .human を返さない

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

  1. ユーザーが同意していないため、何も記録されていない。
  2. セッションのアクションがモデルの求める数(組み込みモデルでは 8)より少なく、結果が .insufficient である。証拠を参照してください。
  3. 取得が一時停止され、再開されていない。
  4. start() が呼び出されていない。
  5. SDK がスコアリングできない。ready が false で、結果が .insufficient である。
  6. 自動化検出が SDK を停止した。stopped が nil ではなく、結果が .insufficient である。 stopped が nil ではないを参照してください。
  7. スコアがモデルの 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 バインディングを設定します。

if let dea = Dea.sdk, !dea.consent.isAnswered {
    askingConsent = true
}

captureEvent が false を返す

原因: 名前が空か 64 文字を超えている、データが JSON として 1024 バイトを超えている、または何も 記録されていない(同意なし、一時停止中、破棄済み)。

解決策: 名前またはデータを短くしてください。iOS SDK は長すぎる名前を切り詰めるのではなく拒否します。 カスタムイベントを参照してください。

captureKey が何も記録しない

原因: events オプションに .keyDown(pressed: false の呼び出しでは .keyUp)がない、または 何も記録されていない(同意なし、一時停止中、破棄済み)。

テストビルドまたはステージングビルドは、欠けていた種類とともに capture.key_ignored をログに書きます。

解決策: events にキーの種類を追加してください。 タイピングを報告するを参照してください。

attest() を呼び出すとアプリが固まる

原因: attest() と renewAttestation() はネットワーク要求を行い、それが終わるまで呼び出し元の スレッドをブロックします。メインスレッドで呼び出すと UI が固まります。

解決策: バックグラウンドキューまたは detached タスクから呼び出してください。

import DeaSDK

DispatchQueue.global(qos: .utility).async {
    _ = Dea.sdk?.attest()
}

attest() が unsupported を返す

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

  1. appKey が渡されていない。detail がそう示し、要求は行われていません。
  2. 署名キーを作成できなかった。端末が 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 は今すぐ確認します。