Okta Privileged Accessゲートウェイを構成する
コマンドラインオプション
-
service:sft-gatewaydサービスを実行します。 -
support:Oktaサポート用にローカルシステム情報を収集します。 -
-h、--help:ヘルプを表示します。 -
-v、--version:バージョンを表示します。 -
--syslog:syslogによるログ記録を強制します。
構成ファイル
Okta Privileged Accessゲートウェイは、構成ファイル(/etc/sft/sft-gatewayd.yaml)を使って制御できます。ゲートウェイをインストールすると、サンプルの構成ファイル(/etc/sft/sft-gatewayd.sample.yaml)を利用できるようになります。構成ファイルが作成されない、または利用できない場合は、ゲートウェイは以下のデフォルト値を使用します。
構成ファイルの変更内容を有効にするには、ゲートウェイを再起動します。詳細については、「Okta Privileged Accessゲートウェイを管理する」を参照してください。
セットアップトークンのオプション
これらのオプションは、ゲートウェイへのセットアップトークンの追加方法を制御します。以下のいずれかのオプションを有効にする必要があります。セットアップトークンを取得する方法の詳細については、トークンとラベルを作成するを参照してください。
| オプション | デフォルト値 | 説明 |
|---|---|---|
| SetupToken | unset | Okta Privileged Accessプラットフォームで作成されるセットアップトークンを指定します。 注:このオプションを使用した場合、セットアップトークンは引き続きプレーンテキストで使用可能です。構成ファイルの読み取り権限を制限することをお勧めします(例:Linuxでは0600)。Okta |
| SetupTokenFile | Linux:/var/lib/sft-gatewayd/setup.token |
セットアップトークンが含まれる個別ファイルへのパスを指定します。デフォルト値は、ゲートウェイを実行するオペレーティングシステムによって異なります。 このオプションは、推奨される方式です。 このオプションを使用した場合、手動でセットアップトークンファイルを作成し、Okta Privileged Accessプラットフォームで作成されたセットアップトークンを追加しなければなりません。 ゲートウェイをチームに登録すると、ゲートウェイによってトークンファイルが削除されます。 注: |
ログオプション
| オプション | デフォルト値 | 説明 |
|---|---|---|
| LogLevel | info |
ログの詳細度を制御します。Oktaは、これをinfoのまま残すことをお勧めします。 有効な値:
|
接続オプション
| オプション | デフォルト値 | 説明 |
|---|---|---|
| AccessAddress | 1.1.1.1 | クライアントがゲートウェイへのアクセスに使用するネットワークアドレス(IPv4、IPv6、またはFQDN)を指定します。アドレスを指定しない場合、ゲートウェイはネットワークインターフェイスまたはクラウドプロバイダーのメタデータによって指定されるアドレスを使用します。 |
| AccessPort | 7234 | クライアントがゲートウェイへのアクセスに使用するポートを指定します。 |
| ListenAddress | 0.0.0.0 | ゲートウェイが接続のリッスンに使用するネットワークアドレス(IPv4、IPv6、またはFQDN)を指定します。デフォルトでは、ゲートウェイは利用可能なすべてのインターフェイスの接続をリッスンします。 |
| ListenPort | 7234 | ゲートウェイが接続のリッスンに使用するポートを指定します。 |
| TLSUseBundledCAs | True | OS証明書ストアではなく、バンドルされた証明書ストアを使ってHTTPリクエストをTLS保護するようにゲートウェイに強制します。これにはOkta Privileged Accessクラウドサービスへのリクエストも含まれます。 注:OS証明書ストアを使用するには、このオプションをFalseに設定します。 |
| RefuseConnections | False | ゲートウェイが、SSHおよびRDPプロキシトラフィックを受け入れるかどうかを制御します。有効な場合、SSHおよびRDP接続リクエストはルーティングされず、ゲートウェイはプロキシトラフィックのリクエストをリッスンしません。 |
| ForwardProxy | unset |
Okta Privileged Accessへのアウトバウンドネットワーク接続に使用するHTTPフォワードプロキシのホスト名とポートを指定します。プロキシは、HTTPS_PROXY環境変数を使用して設定することもできます。 例: |
RDPオプション
これらのオプションでは、ゲートウェイがRDPセッションを管理する方法をコントロールします。
RDP接続は、Enabled: trueオプションと、DangerouslyIgnoreServerCertificates: Trueオプションを使って明示的に許可する必要があります。RDPはYAMLディクショナリであるため、RDPでは必ずこれらのオプションに2つのスペースを追加してください。
ゲートウェイ経由でルーティングされるRDP接続には、Ubuntu 20.04、22.04、RHEL 8、またはRHEL 9が必要です。
| オプション | デフォルト値 | 説明 |
|---|---|---|
| Enabled | False |
ゲートウェイ向けのRDP機能を制御します。このオプションはデフォルトで無効になっています。RDPは他の構成を必要とし、RDP接続が許可される前に |
| DangerouslyIgnoreServerCertificates | False | このオプションは、ゲートウェイがRDP機能の起動と有効化を行うには不可欠です。サーバーエージェントを使用する場合、ゲートウェイは証明書の警告をブローカーサービスに転送することで迂回し、この設定を自動的に有効化します。 |
| MaximumActiveSessions | 20 | ゲートウェイで許可される同時RDPセッションの数を制御します。このセッション数に達すると、他のユーザーはエラーを受信し、ゲートウェイに接続できなくなります。この制限は、リソースおよびパフォーマンス上の理由のみで設けられています。 |
| VerboseLogging | True | RDP内部ログの詳細度を制御します。これらのメッセージは問題の診断時には有用ですが、ログが雑然とする場合もあります。 注: |
セッションの記録オプション
| オプション | デフォルト値 | 説明 |
|---|---|---|
| SessionLogFlushInterval | 10s | セッションキャプチャログのサイズしきい値を指定します。このしきい値に達すると、アクティブセッションのログは署名され、ディスクにフラッシュされます。このオプションでは、時間単位(ms、s、m、h)も指定する必要があります。 |
| SessionLogMaxBufferSize | 262144 | セッションキャプチャログのサイズしきい値を指定します。このしきい値に達すると、アクティブセッションのログが署名され、フラッシュされます。このオプションでは、サイズの単位はバイトです。 |
| SessionLogTempStorageDirectory | /tmp | SSHセッションログを、指定の場所にアップロードする前に格納しておく一時ディレクトリを指定します。 デフォルト値はオペレーティングシステムによって異なります。Linuxでは、デフォルトは 注:
一時セッションログと最終的なセッションログのディレクトリは、同じデバイス上になければなりません。 |
| LogDestinations | unset | 最終的なセッションログの格納場所を指定します。ログは、ローカルに保存することも、AWSバケットまたはGCSバケットに保存することもできます。セッションログは、複数の場所に格納できます。格納先が複数の場合、ログは構成ファイルに指定されている順序で格納先に送信されます。セッションログは、Okta Privileged Accessには絶対に送信されません。 次のデフォルトの値と例を参照してください。 例 - Linux/BSD LogDestinations: - Type: file LogDir: /var/log/sft/sessions 注:
ゲートウェイは 例 - AWS
例 - Google Cloud
|
|
LogFileNameFormats |
|
システム管理者は
|
関連項目