HTTPステータスコードのトラブルシューティング
Access GatewayのHTTPステータスコードはAccess Gateway管理者UIコンソールに表示され、想定とは異なる動作が示されます。
Access GatewayのHTTPステータスコードは、バックエンドアプリケーションコードとは異なります。Access Gateway管理者UIコンソール以外にHTTPステータスコードが表示されるときは、その原因となったバックエンドアプリケーションを調べてください。
- HTTPSステータスコードと説明
- HTTPステータスコードをキャプチャする
- トラッキングIDを見つける
- ステータスコード400:不明なホストステータス
- ステータスコード403:リソースへのアクセスが拒否された
- ステータスコード404:リソースが見つからない
- ステータスコード405:アクセスが拒否された
- ステータスコード413:エンティティにリクエストしたコードが大きすぎる
- ステータスコード500:内部サーバーエラー
- ステータスコード502:アプリケーションが応答しない
- ステータスコード503:アプリケーションを利用できない
- ステータスコード504:タイムアウトエラー
その他のエラーについては、その他の問題のトラブルシューティングを参照してください。
開始する前に
HTTPステータスコードをトラブルシューティングするには、以下の前提条件を満たす必要があります:
- 自分が所属するOkta orgへの管理者アクセス権がある。
- Access Gateway管理コンソールへのアクセス権がある。
- ネットワークアプライアンスとアプリケーションサーバーからログを取得して監視できる。
- ログステートメントに表示されるHTTPステータスコードを識別できる。
HTTPSステータスコードと説明
Access Gatewayとその他のアプリケーションは、あらゆるイベントの発生時に次のステータスコードをブラウザーに返します。アクセスログには、問題のトラブルシューティングのためにこの情報も記録されます。
HTTPステータスコード
| ステータスコード | 説明 |
|---|---|
|
200 |
成功 |
|
302 |
リダイレクト |
|
400 |
Access Gatewayが、IPアドレスまたはホスト名で呼び出されたアプリケーションに対応していません。 |
|
401 |
セッションが存在しません。 |
|
403 |
ポリシールールによってリソースへのアクセスが拒否されました。 |
|
404 |
不明なページ、コンテンツ、またはリソース。 |
|
405 |
セッション整合性エラー。 |
|
413 |
リクエストエンティティが大きすぎます。 |
|
500 |
サーバー側のエラー。 |
|
502 |
バックエンドアプリケーションを利用できません。 |
|
503 |
アプリケーションのモードが、メンテナンス、非アクティブ、オフラインのいずれかです。 |
|
504 |
バックエンドアプリケーションへのリクエストがタイムアウトしました。 |
HTTPステータスコードをキャプチャする
アプリケーションやエラーの種類によっては、Access Gatewayエラーページが表示されない場合があります。このようなときは、ブラウザー開発者ツールを使ってブラウザーからのHTTPステータスコードをキャプチャします。
手順については、Googleのドキュメントを参照してください。その他のブラウザーについては、各ブラウザーのドキュメントで手順を確認してください。
トラッキングIDを見つける
内部サーバーエラーがある場合、Access GatewayはトラッキングIDを生成します。トラッキングIDは、Access Gatewayエラーページに表示されます。このトラッキングIDを使用すると、トラブルシューティング時にログファイルからイベントとそれに対応するログメッセージを識別できます。
トラッキングID(Tracking ID)をクリックすると、そのIDと、ログ内の関連エラーメッセージがコピーされます。
次に、ログステートメントとトラッキングIDの例を示します。
Gateway host:[<host URL>]referrer:[<IDP SSO URL>]error:[Login Error] tracking ID:[6eff1f9ca3]
details:[Requester/RequestDenied: Could not validate the following SAML AuthnRequest from partner Test App: ]
ステータスコード400:不明なホストステータス
| メッセージ | 要求されたホスト:<要求されたホスト名>は、このAccess Gatewayではサービスされていません。 |
| 説明 | DNSレコードがAccess Gatewayに解決されたが、対応するホスト名を持つAccess Gatewayで利用できるサービスまたはアプリケーションがありません。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
ステータスコード403:リソースへのアクセスが拒否された
| メッセージ | 「要求されたアプリケーション」のRequested Resource(要求されたリソース)へのアクセスが拒否されました。 |
| 説明 | 保護されたリソースへのアクセスをポリシーエンジンが拒否した場合、Access Gatewayはこのステータスコードを返します。リソースへの一部のアクセスが意図的に拒否される条件がある場合、このステータスコードを受信する場合があります。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
ステータスコード404:リソースが見つからない
| メッセージ | アクセスしようとしているページが存在しません。 |
| 説明 | 要求されたリソースを利用できない場合、Access Gatewayはこのステータスコードを返します。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
ステータスコード405:アクセスが拒否された
| メッセージ | Access Gatewayが、<要求されたアプリケーション>へのユーザーアクセスで異常を検出しました。 |
| 説明 | セッションの整合性に潜在的な問題が検出された場合、セッションのハイジャックを防ぐために、Access Gatewayはこのステータスコードを返します。これは、アクティブなセッションが存在する状態でユーザーがネットワークを切り替えた場合にも発生する可能性があります。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
ステータスコード413:エンティティにリクエストしたコードが大きすぎる
| メッセージ | アップロードするファイルが1MBを超える場合、Access Gatewayはエラー413を表示します。 |
| 説明 | デフォルトでは、Access Gatewayは容量が1MB未満のファイルをアップロードできるように設定されています。 |
| 検証と軽減の手順 |
|
ステータスコード500:内部サーバーエラー
| メッセージ | 予期せぬサーバーエラーが発生しました。エラーはログに記録されています。このエラーメッセージが表示されたときは、サポートサービスまでお問い合わせください。 |
| 説明 | Access Gatewayコンポーネントでエラーが発生した。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 | Oktaサポートに問い合わせます。 |
ステータスコード502:アプリケーションが応答しない
| メッセージ | バックエンドWebアプリケーション<要求されたアプリケーション>が、Access Gatewayからのユーザーリクエストを受信しておらず、利用できません。 |
| 説明 | 保護しているバックエンドアプリケーションへの接続に失敗すると、Access Gatewayはこのエラーを返します。 |
| ログステートメントの例 |
|
| 検証と軽減の手順 |
|
ステータスコード503:アプリケーションを利用できない
| メッセージ: |
|
| 説明 |
アプリケーションが無効化されている、アクティブ化されていない、メンテナンスモードである、またはオフライン状態にある場合、Access Gatewayはこの警告ページを表示します。 管理者がアプリケーションへのアクセスを一時的に削除した場合も、そのアプリケーションはIDプロバイダーで無効化されます。Access Gateway管理者UIコンソールで設定を変更する前に、アプリケーション所有者またはアプリケーションマネージャーの権限でアプリケーションのステータスを確認してください。 |
| ログステートメントの例 |
アプリケーションが無効化されている、またはアクティブ化されていない場合:
アプリケーションがメンテナンス中の場合:
アプリケーションがオフライン状態の場合:
|
| 検証と軽減の手順 |
|
ステータスコード504:タイムアウトエラー
| メッセージ: |
|
| 説明 |
これらのエラーは、バックエンドアプリケーションからの応答を待機するAccess Gatewayで内部アプリケーションとの接続がタイムアウトになる、またはOracle EBS登録が機能していない、またはインスタンスから消去されている場合に表示されます。 Oracle EBS統合が機能していない場合、アプリケーションはGUIDを提供しません。デバッグを有効にしても、Access GatewayログにはUSER_ORCLGUIDヘッダーはありません。 |
| ログステートメントの例 |
Oracle EBS統合タイムアウトエラーの場合:
バックエンドアプリケーションタイムアウトの場合:
アプリケーションレンダリングのエラーの場合:
内部アプリケーションタイムアウトの場合:
|
| 検証と軽減の手順 |
|