アプリのログイン問題を解決するにはどうすればよいですか? （テクニカルサポート）

認証失敗のトラブルシューティング

1. 登録時に使用されたウォレット アドレスまたは電子メールが、システムに保存されているものと正確に一致していることを確認します。大文字と小文字の区別や末尾のスペースにより、サイレントな不一致が発生することがよくあります。

2. アプリのバージョンが最新であることを確認します。レガシー ビルドでは、新しい JWT トークン署名アルゴリズムや OAuth 2.1 エンドポイントがサポートされていない可能性があります。

3. デバイスのクロックが NTP サーバーと同期しているかどうかを確認します。タイム スキューが 5 分を超えると、ブロックチェーン ID プロバイダーによって発行された有効期間の短いアクセス トークンが無効になります。

4. 一部の分散型認証フローはプッシュベースのチャレンジ/レスポンス ハンドシェイクに依存しているため、ブラウザーまたはモバイル OS の権限 (特に「通知の許可」と「アプリのバックグラウンド更新」) を検査します。

ウォレット署名エラーからの回復

1. MetaMask または Phantom が「署名が拒否されました」というプロンプトを表示したら、接続されたネットワークが dApp のフロントエンド構成で予期されるネットワークと一致していることを確認します。メインネットとテストネットの不一致により、セッションが即時に中止されます。

2. IndexedDB に保存されているキャッシュされた署名ナンスをクリアします。カウンターが古いと、リプレイ保護メカニズムが新しいサインイン要求を検証できなくなります。

3. ハードウェア ウォレット ブリッジを一時的に無効にします。Ledger Live または Trezor Suite が実行されている場合、その USB 列挙が安全なエンクレーブ認証に必要な WebUSB ハンドシェイク シーケンスを妨げる可能性があります。

バックエンド ID サービス ログの分析

1. 「invalid_signature_format」を含む HTTP 401 応答を探します。これは、フロントエンドが不正な形式の EIP-712 型データ構造を署名プロバイダーに渡したことを示します。

2. AuthZ マイクロサービス ログで「nonce_mismatch」のタグが付いたエントリを検索します。これは、クライアント側の nonce の再利用またはバックエンドの Redis TTL の構成ミスのいずれかを示します。

3. ウォレット接続、ID 検証サービス、セッション マネージャー サービス全体で相関 ID を追跡し、JWT ペイロードから「sub」、「iss」、または「chain_id」などの必須クレームが削除された箇所を特定します。

クロスチェーンセッションの競合の処理

1. アクティブな Ethereum セッションを保持しているときに Polygon ID 経由でログインすると、ドメイン スコープの Cookie 制限により、セッション マネージャーが新しいコンテキストを拒否する可能性があります。これは、サブドメイン ベースの認証 Cookie に切り替えることで解決されます。

2. Trust Wallet のようなマルチチェーンウォレットは、競合する window.ethereum プロバイダーを挿入することがあります。認証を開始する前にwindow.ethereum.request({ method: 'wallet_switchEthereumChain' })を介して明示的なプロバイダーの選択を強制することで、競合状態を防ぐことができます。

3. 同じセッション ストア内で ERC-4337 アカウント抽象化ログインと EOA を混在させないでください。それらの署名スキーム (userOperation とpersonal_sign) は、セッション検証層で互換性がありません。

よくある質問

Q: 正しいシードフレーズを入力した後でも、アプリに「無効な認証情報」が表示されるのはなぜですか? A: シード フレーズがサーバーに送信されることはありません。このメッセージは通常、導出されたウォレット アドレスがオンチェーン ID コントラクトに対する検証に失敗したことを意味します。デプロイされた検証コントラクトがログイン リクエストのチェーン ID と一致するかどうかを確認してください。

Q: iOS Safari で Ledger Nano X を使用してログインできますか? A: はい。ただし、WebUSB が無効で、dApp が代わりに WalletConnect v2 を使用する場合に限ります。iOS は直接 USB アクセスをブロックするため、ハードウェア ウォレットの統合には QR ベースのペアリングが必須になります。

Q: 署名に成功した直後に「セッションが期限切れになりました」と表示される原因は何ですか? A: この問題は、バックエンドが SameSite=Strict を使用してセッション Cookie を発行しているが、フロントエンドがサードパーティの iframe から認証フローを開始している場合に発生します。SameSite=Lax に切り替えるか、HTTP ヘッダーでステートレス JWT を発行すると、この問題が回避されます。

Q: Android 13 以降で生体認証ログインが「キーストア操作に失敗しました」というメッセージで失敗するのはなぜですか? A: Android の StrongBox Keymaster は、より厳格な認証要件を適用します。アプリはandroid:allowBackup='false'を宣言し、キー生成中に KeyGenParameterSpec.Builder.setIsStrongBoxBacked(true) を使用する必要があります。