データベース統合のトラブルシューティング

ゲートウェイのセットアップの問題、統合作成の問題、エンドユーザーのアクセスの問題を解決します。

すでに実行中の統合の問題については、最初に正常性ステータスを確認します。「データベース統合の正常性ステータス」を参照してください。

ゲートウェイの問題

表示される内容 考えられる原因 手順
セットアップ後、ゲートウェイがOkta Privileged Accessに表示されない。 ゲートウェイサービスが稼働していないか、登録に失敗している。 サービスがsudo systemctl status sft-gatewaydで実行されていることを確認します。実行中の場合は、sudo journalctl -u sft-gatewaydで登録エラーを確認します。データベース統合をサービスするゲートウェイはユーザーセッションを進行しないため、サービスの再起動は安全です。
ゲートウェイサービスがamazonlinux 2023で開始されない。 必要なセッションログディレクトリが存在しない可能性がある。 次のコマンドを実行します。

echo "SessionLogTempStorageDirectory: /var/log/sft/sessions/tmp" | sudo tee -a /etc/sft/sft-gatewayd.yaml sudo mkdir -p /var/log/sft/sessions/tmp

統合作成の問題

表示される内容 考えられる原因 手順
統合作成時にタイムアウトエラーが発生し、ゲートウェイがリクエストを認識しない。 オーケストレーショングループのゲートウェイがリクエストを受け付けられなかった。 ゲートウェイサービスが稼働していること、およびインフラストラクチャオーケストレーション用に構成されたセットアップトークンを使って登録されていることを確認します。統合のオーケストレーショングループがゲートウェイと一致することを確認します。
統合作成時にタイムアウトエラーが発生し、ゲートウェイがリクエストを認識した。 データベースインスタンスが応答しないため、ゲートウェイは割り当てられた時間内にリクエストを完了できなかった。 データベースがリッスンするポートにゲートウェイからデータベースインスタンスへの接続があること、インスタンスが実行され、接続を受け入れていることを確認します。「環境別のネットワークアクセス」を参照してください。
統合の作成時に「統合ユーザーに必要なすべての権限がありません」というメッセージが表示される。 統合ユーザーに1つ以上の権限がない。 データベースタイプに必要な権限が、統合ユーザーにあることを確認します。エラーは、不足している権限を常に指定するとは限りません。「データベース統合ユーザー権限」を参照してください。
統合の作成時に「ネットワークエラー」または「ホストにアクセスできない」というメッセージが表示される。 ゲートウェイがデータベースインスタンスに接続できない。 データベースがリッスンするポートにゲートウェイからデータベースインスタンスへの接続があることを確認します。「環境別のネットワークアクセス」を参照してください。
統合の作成時に「読み取り専用インスタンスを統合できません」というメッセージが表示される。 統合が、読み取り専用のデータベースインスタンスを指している。 統合が、プライマリの書き込み対応データベースインスタンスを指すようにします。
統合の作成時に「オペレーションがキャンセルされました」というメッセージが表示される。 リクエストが完了する前にキャンセルされた。 もう一度、統合をテストして保存（Test and Save integration）を選択します。
統合の作成時に、統合ユーザーの資格情報を指定するエラー。 統合ユーザーに入力したユーザー名またはパスワードが間違っている。 統合ユーザーのユーザー名とパスワードを確認し、再試行します。「データベース統合ユーザー権限」を参照してください。
統合作成時のデータベースのバージョンエラー。エラーが、サポートされる最小バージョンとインスタンスが実行されているバージョンを指定する。 データベースインスタンスが、Okta Privileged Accessがサポートする最小バージョン以下を実行している。 インスタンスをサポートされるバージョンにアップグレードします。「サポートされているデータベースのタイプ、バージョン、デプロイメントオプション」を参照してください。
アカウントルールを定義した後、アカウントは表示されません。 アカウントルールがどのデータベースユーザーにも一致しない、または最初の検出が完了していない。 オンボーディングされたアカウントは、リソース管理（Resource Administration） > 統合（Integrations） > 統合名（integration name） > アカウント（Accounts）に表示されます。何も表示されない場合は、アカウントルールの演算子（Operator）と値（Value）を確認します。ルールを保存すると、検出とオンボーディングが再開されます。「統合を追加する」を参照してください。
同じデータベースターゲットへの統合が存在する。 Okta Privileged Accessは、各データベースターゲットに対して1つの統合のみを許可します。 エラーメッセージを確認して、競合する統合を特定します。その統合を使用するか、別のデータベースターゲットで統合を作成するか、Oktaサポートにお問い合わせください。

エンドユーザーの問題

表示される内容 考えられる原因 手順
エンドユーザーのダッシュボードにデータベースが表示されない。 そのグループを対象とする公開されたセキュリティポリシーがない。 エンドユーザーは、自分の特権アクセス（My Privileged Access） > データベース（Databases）の下で、データベースを確認できます。ユーザーグループを含むセキュリティポリシーを作成して公開します。
エンドユーザーはデータベースを表示できるが、チェックアウトできない。 プロジェクト設定でチェックアウトが無効になっている。 プロジェクト設定でチェックアウトを有効化します。「データベースアカウント」を参照してください。