2.3. roxctl CLI を使用した認証

手順

1. RHACS ポータルで、Platform Configuration Integrations に移動します。
2. Authentication Tokens カテゴリーまでスクロールし、API Token をクリックします。
3. Generate Token をクリックします。
4. トークンの名前を入力し、必要なレベルのアクセスを提供するロールを選択します (たとえば、Continuous Integration または Sensor Creator)。

5. Generate をクリックします。

   重要

   生成されたトークンをコピーして安全に保存します。再度表示することはできません。

手順

1. 認証トークンを生成したら、次のコマンドを入力して、ROX_API_TOKEN 変数としてエクスポートします。

   $ export ROX_API_TOKEN=<api_token>

   Copy to Clipboard Toggle word wrap

2. (オプション): 次のコマンドを入力して、トークンをファイルに保存し、--token-file オプションとともに使用することもできます。

   $ roxctl central debug dump --token-file <token_file>

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、ROX_ENDPOINT 変数を Central のホスト名とポートに設定します。

   export ROX_ENDPOINT=<central_hostname:port>

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、Central へのログインプロセスを開始します。

   $ roxctl central login

   Copy to Clipboard Toggle word wrap
3. roxctl CLI 内では、URL が出力として出力され、ブラウザーウィンドウにリダイレクトされ、使用する認証プロバイダーを選択できます。

4. 認証プロバイダーを使用してログインします。

   ログインに成功すると、認証が成功したことがブラウザーウィンドウに表示されるので、ブラウザーウィンドウを閉じることができます。

5. roxctl CLI は、アクセストークン、アクセストークンの有効期限、更新トークンが発行されている場合はそのトークン、これらの値がローカルに保存されているという通知などの詳細を含むトークン情報を表示します。

   出力例

   Please complete the authorization flow in the browser with an auth provider of your choice.
   If no browser window opens, please click on the following URL:
           http://127.0.0.1:xxxxx/login
   
   INFO:	Received the following after the authorization flow from Central:
   INFO:	Access token: <redacted> 

   1

   
   INFO:	Access token expiration: 2023-04-19 13:58:43 +0000 UTC 

   2

   
   INFO:	Refresh token: <redacted> 

   3

   
   INFO:	Storing these values under $HOME/.roxctl/login… 

   4

   Copy to Clipboard Toggle word wrap

   1

   アクセストークン。

   2

   アクセストークンの有効期限。

   3

   更新トークン。

   4

   アクセストークンの値、アクセストークンの有効期限、および更新トークンがローカルに保存されるディレクトリー。

   重要

   設定が保存されるディレクトリーを決定するように環境を設定してください。デフォルトでは、設定は $HOME/.roxctl/roxctl-config ディレクトリーに保存されます。

   • $ROX_CONFIG_DIR 環境変数を設定すると、設定は $ROX_CONFIG_DIR/roxctl-config ディレクトリーに保存されます。このオプションは、優先度が最も高くなります。
   • $XDG_RUNTIME_DIR 環境変数を設定し、$ROX_CONFIG_DIR 変数が設定されていないと、設定は $XDG_RUNTIME_DIR/roxctl-config ディレクトリーに保存されます。
   • $ROX_CONFIG_DIR または $XDG_RUNTIME_DIR 環境変数を設定しないと、設定は $HOME/.roxctl/roxctl-config ディレクトリーに保存されます。