Skip to Content
このプロジェクトは現在「開発段階」です。仕様や挙動が予告なく変更される可能性があります。
ドキュメント高度な機能トラブルシューティング

トラブルシューティング

このページでは、SAuthBase を使用する際に発生する可能性のある一般的なエラーとその対処法、およびすべてのレスポンスコードcodeの一覧を提供します。

よくある問題と解決策

SAuthBase has not been initialized.

  • 原因: sauthbase.init() を呼び出す前に sauthbase.use() を使用しようとした。
  • 解決策: アプリ起動時に sauthbase.init() を呼び出してから .use() を利用してください。

トークン形式が無効です。

  • 原因: decrypt() や extractUserWithVerify() に渡したトークンの形式が iv:encrypted:authTag の構造になっていない。
  • 解決策: トークンが正しく生成された形式か確認し、暗号化手順を見直してください。

レスポンスコード一覧

以下は、SAuthBase SDK が返す可能性のあるレスポンスコードの一覧です。
code はレスポンスの種類を簡潔に識別できるよう分類されています。詳細な内容は message に記述されています。

✅ 成功レスポンス

コード説明
SUCCESS操作が正常に完了しました。

❌ エラーレスポンス

🔧 内部処理エラー

コード説明
ERROR/INTERNAL一般的な内部処理エラーが発生しました。
ERROR/INTERNAL_HMAC_CALCULATIONHMACの計算中にエラーが発生しました。
ERROR/INTERNAL_DECRYPTION復号処理中にエラーが発生しました。
ERROR/INTERNAL_VERIFICATIONセッション検証中に内部エラーが発生しました。
ERROR/INTERNAL_TOKEN_GENERATIONトークン生成中にエラーが発生しました。
ERROR/INTERNAL_ENCRYPTION_FAILURE暗号化処理中にエラーが発生しました。
ERROR/INTERNAL_HMAC_FAILUREHMAC生成に失敗しました。
ERROR/INTERNAL_HMAC_ERRORHMAC関連で予期しないエラーが発生しました。

⚠️ 引数不正・欠如

コード説明
ERROR/ARGUMENT_REQUIRED_SESSIONセッション引数が必要ですが、提供されていません。
ERROR/ARGUMENT_REQUIRED_USERNAMEユーザー名が必要ですが、提供されていません。
ERROR/ARGUMENT_REQUIRED_TOKENトークンが必要ですが、提供されていません。

📦 データ取得・フォーマット関連

コード説明
ERROR/FETCH_FAILEDデータの取得に失敗しました。
ERROR/FORMAT_INVALID_TOKENトークンの形式が無効です。
ERROR/DECRYPTION_FAILURE復号に失敗しました。
ERROR/HMAC_MISMATCHHMAC 検証に失敗しました（改ざんの可能性）。

サポート

問題が解決しない場合は、GitHubのIssueページ にて報告してください。

最終更新日
セッション管理API リファレンス