トラブルシューティング

​

鍵とセキュアキーバックアップ

​

アンロックに失敗する(無効なパスコード)

• パスコードが setup で使用したものと一致していることを確認してください
• 試行の間に待機してください。レルムは誤答をレート制限し、失敗が多すぎると復元をロックすることがあります

try:
    chat.unlock(passcode)
except ValueError as e:
    print(e)  # may mention InvalidPin or guesses remaining

try {
  await chat.unlock(passcode);
} catch (e) {
  console.error((e as Error).message);
}

chat.unlock(passcode_bytes).await?;

if err := chat.Unlock(passcode, juiceboxConfigJSON); err != nil {
    log.Println(err)
}

try { chat.Unlock(passcode, juiceboxConfigJson); }
catch (Exception e) { Console.WriteLine(e.Message); }

try { chat.unlock(passcode, juiceboxConfigJson); }
catch (Exception e) { System.out.println(e.getMessage()); }

​

鍵やアイデンティティがセットされていないため暗号化/復号が失敗する

chat.unlock(passcode)  # or: chat.import_keys(blob)
chat.set_identity(my_user_id, signing_key_version)

await chat.unlock(passcode);
chat.setIdentity(myUserId, signingKeyVersion);

chat.import_keys(&blob)?;
chat.set_identity(&my_user_id, &signing_key_version);

blob, _ := chatxdk.Base64ToBytes(privateKeysB64)
_ = chat.ImportKeys(blob)
_ = chat.SetIdentity(myUserID, signingKeyVersion)

chat.ImportKeys(blobBytes);
chat.SetIdentity(myUserId, signingKeyVersion);

chat.importKeys(blobBytes);
chat.setIdentity(myUserId, signingKeyVersion);

​

メッセージに対する会話鍵が見つからない

1. conversation_key_change_event(ライブイベント)または meta.conversation_key_events(履歴)の鍵素材を extract_conversation_keys で復号する、あるいはそれらのブロブを decrypt_events に含める。set_cache_keys(true) が有効なら、decrypt_events は各会話の最新の検証済み鍵も保持するため、以後の decrypt_event や encrypt_* の呼び出しでは省略できます
2. そのバージョンに対して会話鍵が追加されており、まだ参加者であることを確認してください(はじめに を参照)

​

ピアに公開鍵がない

​

復号と署名

​

復号に失敗する

• 生の会話鍵が古い/誤っている、または鍵バージョンが間違っている
• encoded_event 文字列が不完全である
• イベントタイプが復号可能なコンテンツとして扱える暗号化メッセージではない

​

署名が検証されない

• 送信者の署名鍵エントリが欠落または不完全(Chat XDK が必要とするすべてのフィールド——Chat XDK リファレンスを参照)
• 呼び出しに署名鍵が渡されておらず、set_signing_keys で保存されているものもない
• 送信者がバージョンをローテーションした——公開鍵を再取得してください
• 許容フロアより下の鍵バージョンは決して検証されません

chat.set_reject_unverified(True)

chat.setRejectUnverified(true);

chat.set_reject_unverified(true);

chat.SetRejectUnverified(true)

chat.SetRejectUnverified(true);

chat.setRejectUnverified(true);

​

返信に reply_preview_validation: "Invalid" が付いている

​

古いイベントが恒久的に検証に失敗する

​

送信ペイロードの構築

​

状態を変更する呼び出しで API が 400 を返す

​

メディアの暗号化と復号

• 添付を参照するメッセージと同じ会話鍵(およびバージョン)を使用してください
• ダウンロードレスポンスは、decrypt_stream を実行するまで暗号文として扱ってください
• MIME タイプは復号後に推測してください。ダウンロードの Content-Type は多くの場合、実際の画像タイプではありません

​

安全なデバッグ

• 会話 ID、イベント ID、鍵のバージョンのみをログに出力してください
• 平文、パスコード、秘密鍵、完全な鍵ブロブはログに出力しないでください
• set_identity に渡した署名鍵バージョンが public-key レコードの public_key_version と一致することを確認してください
• 履歴が不完全な場合は、鍵変更メタデータがスキップされないよう、復号前にすべてのイベントページをページングしてください