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

B2B IAM 実装のローンチに向けたサポート体制の準備。

​

Auth0 のポリシーを確認する

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

​

Support plan、SLA、重大度の定義、および Support Center のドキュメントを確認する

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

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

​

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

Auth0コミュニティフォーラムには、非常に多くの情報があります。疑問がある場合は、すでに誰かが同じ質問をフォーラムでしている可能性が高いでしょう。回答は、Auth0のスタッフと幅広いAuth0ユーザーコミュニティの両方から寄せられています。

重要なお知らせは、重要な最新情報を把握できるよう、コミュニティフォーラムに掲載されます。必ず「Community」カテゴリーと「FAQ」カテゴリーを確認してください。Communityカテゴリーには、製品のお知らせ、ロードマップ情報、ハウツー動画に加え、今後予定されている機能の非推奨化に関する重要な情報などを事前に案内する投稿が含まれています。

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 ファイルにはアプリケーションのフロントエンドに返されたトークンも含まれており、これらを適切なビューアーに貼り付けることで、想定どおりの内容が含まれているかを確認できます。

​

JWT を表示する

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

​

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 形式の計画ガイドを提供しています。

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