データベース統合サポートのためにゲートウェイを構成する

ゲートウェイがデータベース統合をサービスできるように、ゲートウェイ構成ファイルを作成し、インフラストラクチャオーケストレーション用に構成されたセットアップトークンを適用します。

このタスクについて

データベースインスタンスへのアクセスを提供するゲートウェイには、特定の構成が必要です。Okta Privileged Accessを使用してデータベースアクセスを管理するには、インフラストラクチャオーケストレーション用に構成されたセットアップトークンを使用して登録されたゲートウェイが必要です。

始める前に

インフラストラクチャオーケストレーター（Infrastructure orchestrator）ロールで、ゲートウェイセットアップトークンが作成されている。このタスクでは、このトークンをゲートウェイマシンに適用します。「セットアップトークンを作成する」を参照してください。
ゲートウェイマシンには、関連データベースインスタンスへとOkta Privileged Accessへのアウトバウンド接続が必要です。「環境別のネットワークアクセス」を参照してください。
データベース統合を作成する前に、インフラストラクチャでゲートウェイをセットアップします。ゲートウェイがデータベースインスタンスにアクセスできない場合は、統合の作成は失敗します。「UbuntuまたはDebianにOkta Privileged Accessゲートウェイをインストールする」または「LinuxにOkta Privileged Accessゲートウェイをインストールする」を参照してください。

注:

インフラストラクチャオーケストレーション用に構成されていないトークンを使用して登録されたゲートウェイは、データベース統合の作成に失敗します。これには、サーバーアクセスプロキシ（Server access proxy）に登録された既存のゲートウェイが含まれます。「セットアップトークンゲートウェイロールの既知の問題」を参照してください。

手順

ゲートウェイマシンで、/etc/sft/sft-gatewayd.yamlに構成ファイルを作成し、以下を追加します。
```
Orchestrator:
  Enabled: true
  BinaryPath: /usr/sbin/sft-orchestrator
```
作成したセットアップトークンを適用します。
```
echo 'your-setup-token' | sudo tee /var/lib/sft-gatewayd/setup.token > /dev/null
```
your-setup-tokenをOkta Privileged Accessダッシュボードからコピーしたトークン値に置き換えます。
ゲートウェイマシンがOkta Privileged Accessへのアウトバウンド接続を確認します。
ゲートウェイは、ポート443の本番環境とプレビューOkta Privileged Accessドメインの両方にアクセスする必要があります。ゲートウェイマシンから以下のコマンドを実行し、your-opa-team-nameをチーム名に置き換えます。応答により、ネットワークパスが機能していることを確認できます。
```
curl -Iv https://your-opa-team-name.pam.okta.com
curl -Iv https://your-opa-team-name.pam.oktapreview.com
```
ゲートウェイサービスを再起動します。
```
sudo systemctl restart sft-gatewayd
```
ゲートウェイが正常に登録されたことを確認します。
```
sudo journalctl -u sft-gatewayd -f
```
このコマンドは、完全なゲートウェイログをストリーミングします。次の3つのエントリの出力をスキャンして、登録が成功したことを確認します。各エントリは長いログ行に表示され、常にこの順序で表示されるとは限りません。
- Initialization Successful
- Orchestrator started successfully
- GatewaySync reported 204
Ctrl+Cを押して、ログの実行を停止します。

ゲートウェイが登録されないか、予期されたメッセージが表示されないときは、「データベース統合のトラブルシューティング」を参照してください。
ゲートウェイマシンがデータベースインスタンスにアクセスできることを確認します。
これらのコマンドを使用して、ゲートウェイマシンがデータベースインスタンスにアクセスできることを確認します。認証エラーにより、ネットワークパスが機能することを引き続き確認できます。接続タイムアウトまたはホストが見つかりませんというエラーは、ゲートウェイがインスタンスにアクセスできないことを意味します。

MySQLまたはMariaDBの場合：
```
mysql -h hostname -P port -u username -p
```
PostgreSQLの場合：
```
psql -h hostname -p port -U username -d database-name
```
他のデータベースタイプでは、独自のコマンドラインクライアントが使用されます。ゲートウェイがインスタンスに到達できない場合は、「環境別のネットワークアクセス」を参照してください。
Okta Privileged Accessダッシュボードで、ゲートウェイにインフラストラクチャオーケストレーター（Infrastructure orchestrator）ロールがあることを確認します。

リソース管理（Resource Administration） > ゲートウェイ（Gateways）に進みます。用途（Used for）列には、各ゲートウェイのロールが表示されます。

トラブルシューティング

Amazon Linux 2023でゲートウェイの起動に失敗した場合は、必要なセッションログディレクトリが存在していません。ディレクトリを作成して構成ファイルに追加し、サービスを再起動します。

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

次のタスク

ゲートウェイがインフラストラクチャオーケストレーター（Infrastructure orchestrator）ロールに登録されていることを確認したら、データベース統合を追加できます。