サポート体制の準備 (B2C)

B2C IAM 実装の立ち上げに向けたサポート体制を整えます。

​

Auth0 ポリシーを確認する

ローンチの準備を始める際は、必ず Auth0 Policies を確認し、ポリシーに定められた必要なリードタイムやお客様側の責任を踏まえて、本番運用の準備を進めてください。

​

Support プラン、SLA、重大度の定義、Support Center のドキュメントを確認する

購入した サポートプラン の詳細と、それに関連するサービスレベル契約 (SLA) を確認し、自社のニーズに十分対応できる内容かどうかを確認してください。まだであれば、Support Center を確認し、一般的な問題に対する推奨ソリューションの表示、チケットの起票、クォータ使用状況の確認といったサポート機能に慣れておいてください。また、適切な重大度でチケットを起票できるよう、サポートチケットの重大度レベルの定義も確認しておくと役立ちます。重要な注意点として、現時点では Support Center でサポートチケットの重大度を引き上げることはできません。中程度の問題としてチケットを起票した後で、問題の重大度が高くなった場合は、緊急性が生じた新たな状況を説明し、詳細について元のチケットを参照する新しい緊急・高重大度のチケットを起票してください。

また、以下で詳しく説明する Auth0 コミュニティフォーラム について、開発チームとサポートチームが十分に把握していることも確認してください。一般的な問題については、顧客がそこで回答をすぐに見つけられることが多く、チケットを起票せずに済む場合もあるため、技術的な質問があるときはまず最初に確認すべき場所です。

​

Auth0 コミュニティフォーラムを確認する

Auth0 コミュニティフォーラムには、豊富な情報が掲載されています。疑問がある場合は、すでに別の誰かがその質問をフォーラムに投稿している可能性があります。回答は Auth0 のスタッフと、より幅広い Auth0 ユーザーコミュニティの両方から寄せられています。

重要なお知らせはコミュニティフォーラムにも投稿されるため、重要なニュースを把握するのに役立ちます。必ず “Community” と “FAQ” のカテゴリを確認してください。Community カテゴリには、製品に関するお知らせ、ロードマップ情報、How-To 動画に加え、今後予定されている機能の廃止に関する重要な情報などを案内する投稿が含まれています。

質問があるときだけでなく、定期的に Auth0 Community を確認することをお勧めします。閲覧中に、すでに自分で解決した質問を見つけたら、ぜひその知見を共有して他の人の役に立ててください。

​

サポートチケットに必要な Auth0 のトラブルシューティング情報を収集する

サポートチームは、ID プロトコルと Auth0 に特化したトラブルシューティングガイドを把握しておくことをお勧めします。これには、Auth0 フォーラムに質問を投稿したり、サポートチケットを送信したりする前に確認すべき事項や収集すべき情報が含まれます。認証トランザクションは複数のシステムにまたがることが多いため、身に付けておくと役立つ専門的なトラブルシューティング手法がいくつかあります。

​

トラブルシューティング用のツールを用意しておく

アプリケーションの開発中に、チームですでにある程度のトラブルシューティングを行っているはずですが、プロジェクトに関連する以下のツールについては、サポートチームも使い方を把握しておくことをおすすめします。チケットを起票する必要がある場合、Auth0 サポートチームから、問題の分析に役立てるために HAR (HTTP Archive) ファイルの提出を求められることがあります。そのため、サポート担当者がその取得方法を把握しておくと便利です。

HAR ファイルを誰か (Auth0 を含む) と共有する前に、次のような機微なデータをすべて削除または秘匿化していることを必ず確認してください。

• 機密性の高いユーザー情報
• 個人を特定できる情報 (PII)
• 機密性の高いアプリケーション情報

詳細については、Auth0 Community の以下の記事を参照してください。

• HTTP トレースのサニタイズ
• HTTP トレースファイルを自動的にサニタイズする方法
• 機微な情報を手動でマスキングする方法
• HAR ファイルが大きすぎてサポートケースにアップロードできない

​

HAR ファイルを取得する

HAR ファイルは、ブラウザーでの一連の操作を記録するもので、認証の問題をデバッグする際によく使用されるツールです。ユーザーの認証プロセスでは通常、アプリケーションから Auth0 へ、さらに使用している接続の種類によっては別のリモートのIDプロバイダーへと、ユーザーのブラウザーがリダイレクトされます。このリダイレクトとレスポンスを取得して分析することで、問題の原因を特定する手がかりを得ることができます。

​

HAR ファイルを解析する

トラブルシューティングに役立つ情報を得るために、HAR ファイルを解析します。HAR ファイルには、認証トランザクションにおけるブラウザーのリダイレクトの順序と、使用されたパラメーターが表示されます。認証プロセスが途中で停止したかどうか、停止した場合はどこで停止したかも HAR ファイルで確認できるため、問題箇所の特定に役立ちます。HAR ファイルにはアプリケーションのフロントエンドに返されたトークンも含まれており、これらを適切なビューアーに貼り付けることで、想定どおりの内容が含まれているか確認できます。

​

JWT を表示する

jwt.io は Auth0 が作成したツールで、JWT 形式のトークンの内容を確認できます。OIDC を介して Auth0 に認証を委任するアプリケーションは、Auth0 から IDトークン を受け取ります。アプリケーションの種類によっては、IDトークン が HAR ファイルに含まれることがあります。IDトークン は JWT 形式のため、jwt.io に貼り付けると IDトークン の内容を確認できます。

​

SAML リクエスト/レスポンスを表示する

利用できる SAML デコーダーは多数あります。samltool.io デコーダーは Auth0 によって作成されたもので、SAML リクエストまたはレスポンスの内容を表示できます。SAML 経由で認証を Auth0 に委任するアプリケーションや、Auth0 で SAML タイプの接続を使用するアプリケーションでは、SAML リクエストとレスポンスが使用されます。これらの SAML リクエストとレスポンスは、HAR ファイルに記録されることがあります。リクエストとレスポンスを samltool.io または他の SAML デコーダーに貼り付けると、SAML リクエストまたはレスポンスの内容を確認できます。

​

Auth0 サポートマトリックスを確認する

問題の原因の 1 つとして、古いバージョンの SDK やライブラリを使用していることが考えられます。ソフトウェアスタック、ブラウザー、SDK、ライブラリについて、最新のサポート対象バージョンを使用していることを確認するため、チームで Auth0 サポートマトリックス を確認することを強く推奨します。問題が発生した場合、Auth0 サポートチームからサポート対象バージョンへのアップグレードを求められることがあります。問題解決の遅延を避けるため、必ず最新のバージョンを使用してください。

​

Auth0 フィードバックポータルを利用する

Auth0 は、お客様からのフィードバックやアイデアを歓迎しています。製品チームへの提案がある場合は、Product Feedback portal から製品に関するフィードバックを直接送信してください。

​

Actions リアルタイムログ

Actions、Rules、Hooks、カスタムデータベーススクリプト、カスタム OAuth 接続など、Auth0 のカスタムコードをデバッグおよびサポートするには、Actions リアルタイムログ を理解しておくことが重要です。これにより、console.log ステートメントの出力を含む、カスタムコードからの出力を確認できます。

デバッグおよびサポートのツールとして Actions リアルタイムログを使用し、カスタムコードのログ出力を確認する方法に慣れておくことをお勧めします。

​

トラブルシューティング

開発中だけでなく、アプリケーションまたは API の本番稼働後も、基本的な問題のトラブルシューティングに対応できるよう準備しておく必要があります。開発チームとサポートチームが、トラブルシューティングツールに関する知識と、問題の切り分け時に確認すべき一般的な項目の一覧を把握していることを確認してください。

​

プロジェクト計画ガイド

推奨戦略の詳細を確認できるよう、ダウンロードして参照できる PDF 形式の計画ガイドを提供しています。

B2C IAM プロジェクト計画ガイド