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>

2. （可选）：您还可以将令牌保存到文件中，并通过输入以下命令将其与 --token-file 选项一起使用：

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

流程

1. 运行以下命令，将 ROX_ENDPOINT 变量设置为 Central 主机名和端口：

   export ROX_ENDPOINT=<central_hostname:port>

2. 运行以下命令，将登录过程启动到 Central：

   $ roxctl central login

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

   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 目录中。