その他の問題のトラブルシューティング
このトピックでは、一般的な問題をトラブルシューティングする方法について説明します。
- コマンドラインを使ってAccess Gatewayインスタンスに接続すると、SSHエラーが表示される
- 予期しないアプリケーションやAccess Gatewayインスタンスの動作
- アプリケーション証明書エラー
- Microsoft Internet Explorerのリダイレクトルーピング
- 無効なIDプロバイダーAPIキー
- アプリ名が同期していない
- サイトにアクセスできない、または表示できない
- アプリのセットアップまたは作成が応答しない
- TLSページが表示されない
- HTTPステータスコードのトラブルシューティング
開始する前の確認事項
Access Gatewayの問題をトラブルシューティングするには、次の前提条件を満たす必要があります。
- 自分が所属するOkta orgへの管理者アクセス権がある。
- Access Gateway管理コンソールへのアクセス権がある。
- ネットワークアプライアンスやアプリケーションサーバーなどからログを取得して監視できる。
コマンドラインを使ってAccess Gatewayインスタンスに接続すると、SSHエラーが表示される
| メッセージ | アクセス許可が拒否されました(publickey,gssapi-keyex,gssapi-with-mic) |
| 説明 | コマンドラインを使ってAccess Gatewayインスタンスへの接続を試みる際に、oag-mgmtユーザー名が指定されていませんでした。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 | Access Gatewayインスタンスに接続する際にoag-mgmtユーザー名を指定します。 |
時刻が同期していない
Access Gatewayとアプリケーションの間で時刻が同期されていないと、Access GatewayはSAMLアサーションを正しく処理できません。
Access GatewayがSAMLアサーションを検証できない
| メッセージ | Requester/RequestDenied:パートナーAccess Gatewayアプリケーション名からの次のSAML AuthnRequestを検証できませんでした: |
| 説明 | Access Gatewayまたは保護されているアプリコンピューターの時刻が同期されていません。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
SAMLアサーションの日時が将来のものである
| メッセージ | 将来有効になるアサーションを受信しました。IdPとSPのクロック同期を確認してください。 |
| 説明 | 保護されているアプリからのSAMLアサーションの日時が将来のものです。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
期限切れのSAMLアサーション
| メッセージ | 期限切れのアサーションを受信しました。クロックを確認してください。 |
| 説明 | 保護されているアプリからのSAMLアサーションが期限切れです。保護されているアプリをホスティングしているコンピューターで時刻が正しく構成されていない可能性があります。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
ブラウザーがドメインを信頼せず、SAMLリクエストを送信しない
| メッセージ | 原因:例外:現在のバインディングが見つかりません。 |
| 説明 | このエラーは、ユーザーがSAMLアサーションの再投稿を続けているか、自己署名付きSSL証明書の承認プロセスでエラーが発生した場合に起こります。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
解決策1:証明書が検証済みであることを確認します。
解決策2:ブラウザーがアプリケーションのURLを信頼することを確認します。
|
予期しないアプリケーションやAccess Gatewayインスタンスの動作
| 動作 | アプライアンスまたはAccess Gatewayインスタンスで予期せぬ動作が生じました。 |
| 説明 |
古くなったページやcookieがブラウザーキャッシュに保存されていると、Access Gatewayとアプリケーションは古いデータを読み込んだり、処理したりすることがあります。 |
| 検証と軽減の手順 |
|
アプリケーション証明書エラー
| 動作 |
|
| 説明 |
この動作は、ブラウザーが証明書を信頼していない場合に発生します。ユーザーが続行リンクをクリックすると、ブラウザーはデータをSAMLエンドポイントにポストせず、SAMLアサーションは失敗します。ユーザーが同じブラウザーセッションでアプリケーションをもう一度開くと、ユーザーが事前に権限を付与してるためにブラウザーはURLを信頼します。アプリケーションは正しいデータをSAMLエンドポイントにポストします。 |
| 検証と軽減の手順 |
この問題をローカルシステムのみで修正します。 Access Gatewayクライアント証明書をブラウザーの信頼済みストアに追加します。手順については、ブラウザーのドキュメントを参照してください。 この問題をすべてのシステムで修正します。
|
Microsoft Internet Explorerのリダイレクトルーピング
ブラウザーの信頼
| 動作 | Microsoft Internet Explorerのタブは、それ自体で開閉することも、ユーザーをループにリダイレクトすることもできます。 |
| 説明 | ブラウザーがアプリケーションまたはAccess Gatewayエンドポイントを信頼していません。 |
| 検証と軽減の手順 |
Microsoft Internet Explorerの設定で、Access Gatewayホスト名のエンドポイントのURLとアプリケーションのエンドポイントのURLを信頼済みゾーン(Trusted Zone)設定に追加します。 |
負荷分散
| 動作 | Microsoft Internet Explorerのタブは、それ自体で開閉することも、ユーザーをループにリダイレクトすることもできます。 |
| 説明 | 負荷分散ソリューションを使用している場合、ブラウザーはAccess Gatewayホスト名を1つのノードに解決し、アプリケーションのパブリックドメインを別のノードに解決します。 |
| 検証と軽減の手順 |
|
無効なIDプロバイダーAPIキー
| メッセージ | IdP APIトークンがIdPから削除されました。 |
| 検証と軽減の手順 |
|
アプリ名が同期していない
| メッセージ | <アプリ名>がIdPと同期していません。このアプリケーションを<IDP Org名>として再作成しますか? |
| 説明 | アプリケーションがIDプロバイダーから削除されています。 |
| 検証と軽減の手順 |
|
サイトにアクセスできない、または表示できない
| 動作 | ブラウザーがサイトにアクセスできません。 |
| 説明 | アプリケーションまたはAccess Gatewayサービスが動作していない、またはDNSエントリがありません。 |
| 検証と軽減の手順 |
|
アプリのセットアップまたは作成が応答しない
| 動作 | Access Gatewayでアプリケーションの初期セットアップ時または作成時に進行状況インジケーターが長時間回転します。 |
| 説明 | これは、Access Gatewayが指定のIDプロバイダーにアクセスできない場合に生じます。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
TLSページが表示されない
| 動作 | TLSページが表示されません。 |
| 説明 | これは、ブラウザーのTLSセキュリティ設定が、Access Gatewayとのセキュアな接続を正しく認証しない場合に生じます。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
ブラウザーがTLS 1.1、1.2、1.3を使用していることを確認します。手順については、ブラウザーのドキュメントを参照してください。 |