如何使用CLI登入雲SSO並訪問阿里雲資源 - CloudSSO

雲SSO已與阿里雲CLI進行了整合。使用者除了使用瀏覽器登入雲SSO使用者門戶，也可以通過阿里雲CLI登入。登入後，選擇對應RD帳號和許可權，通過CLI命令列訪問阿里雲資源。本文為您介紹雲SSO使用者使用阿里雲CLI登入雲SSO的操作方法。

步驟一：安裝CLI

您需要安裝阿里雲CLI和雲SSO CLI，具體如下：

安裝阿里雲CLI
安裝雲SSO CLI
1. 安裝Node.js。
  安裝Node.js的同時請安裝包管理工具npm。
  說明
  Node.js版本不低於7.6.0，推薦最新的LTS版本。
2. 執行以下命令，安裝雲SSO CLI。
```
npm i @alicloud/sso-cli -g
```
更多資訊，請參見雲SSO CLI。

步驟二：配置雲SSO登入資訊

執行以下命令，開始配置雲SSO登入資訊。
```
acs-sso configure
```
輸入使用者登入地址signinUrl。
說明
使用者登入地址signinUrl擷取方法：請登入雲SSO控制台，在概覽頁面的右側，擷取使用者登入URL。
請求樣本：
```
acs-sso configure
? please input 'signinUrl': https://signin-******.alibabacloudsso.com/device/login
```
配置成功的返回樣本：
```
configuration done!
```

步驟三：雲SSO使用者登入阿里雲

常用命令如下：

預設登入
1. 執行以下命令，開始登入。
```
acs-sso login
```
2. 在彈出的瀏覽器視窗中，根據介面提示，完成雲SSO使用者登入，登入成功後請關閉瀏覽器視窗。
  如果瀏覽器視窗未彈出，您可以根據CLI的提示資訊，手動複製登入URL和使用者碼完成登入。
  提示資訊樣本：
```
If your default browser is not opened automatically, please use the following URL to finish the signin process.
Signin URL: https://signin-****.alibabacloudsso.com/device/code
User Code: *********
```
3. 如果目前使用者被授予了多個RD帳號的存取權限，CLI會互動式地提醒您選擇要使用的RD帳號和訪問配置，並最終產生相應的阿里雲存取金鑰。
  返回樣本：
```
You have logged in.
used account: test-account(191585963325****)
used access configuration: TestAC(ac-x08xz11covd3cyzd****)
{
  "mode": "StsToken",
  "access_key_id": "STS.****",
  "access_key_secret": "****",
  "sts_token": "****"
}
```
登入成功後，profile會綁定該RD帳號和訪問配置。下次登入時，將會使用本次緩衝的RD帳號和訪問配置直接登入。
指定雲SSO的登入配置名稱
```
acs-sso login --profile sso
```
當您想同時配置多個RD帳號和訪問配置所對應的SSO登入資訊時，可以通過指定登入配置名稱來區分。您可以使用--profile指定雲SSO的不同登入配置名稱。上述命令表示指定使用的登入配置名稱是sso。
不指定--profile時，預設使用的登入配置名稱是default。
擷取登入配置列表
```
acs-sso profile --list
```
刪除指定的登入配置
執行以下命令，刪除預設登入配置。
```
acs-sso profile --delete --profile default
```
執行以下命令，刪除名為sso的登入配置。
```
acs-sso profile --delete --profile sso
```
配置輸出模式
以下兩種方式，您可以任選其一進行配置：
- 外部進程模式（預設）：當您與阿里雲CLI的外部進程（External）模式配合使用時，您可以使用該輸出模式。
  返回樣本：
```
{
  "mode": "StsToken",
  "access_key_id": "STS.NUyPeEoab****",
  "access_key_secret": "GBubpmh****",
  "sts_token": "CAIS****"
}
```
- 環境變數模式：您可以使用--env 參數配置返回結果為環境變數模式。例如：acs-sso login --profile user1 --env。
  返回樣本：
```
export ALIBABACLOUD_ACCESS_KEY_ID=STS.NUyPeEoab****
export ALIBABACLOUD_ACCESS_KEY_SECRET=GBubpmh****
export SECURITY_TOKEN=CAIS****
```
  環境變數可以與阿里雲的相關工具（例如：Terraform等）配合使用。例如：`acs-sso login --profile user1 --env` && terraform plan。
  環境變數也可以與阿里雲CLI配合使用。例如：`acs-sso login --profile user1 --env` && aliyun ecs DescribeRegions。

步驟四：配合阿里雲CLI使用

請求樣本：

aliyun configure --mode External --profile sso
Configuring profile 'sso' in 'External' authenticate mode...
Process Command []: acs-sso login --profile sso
Default Region Id []: cn-shanghai
Default Output Format [json]: json (Only support json)
Default Language [zh|en] en: 
Saving profile[sso] ...Done.

其中，Process Command使用命令acs-sso login --profile sso指定雲SSO的登入配置名稱為sso。建議您在阿里雲CLI和雲SSO CLI指定相同的配置名稱，這樣當有多個雲SSO登入配置時，可以多次配置CLI憑證，並匹配不同的雲SSO登入配置。

配置成功的返回樣本：

Configure Done!!!
..............888888888888888888888 ........=8888888888888888888D=..............
...........88888888888888888888888 ..........D8888888888888888888888I...........
.........,8888888888888ZI: ...........................=Z88D8888888888D..........
.........+88888888 ..........................................88888888D..........
.........+88888888 .......Welcome to use Alibaba Cloud.......O8888888D..........
.........+88888888 ............. ************* ..............O8888888D..........
.........+88888888 .... Command Line Interface(Reloaded) ....O8888888D..........
.........+88888888...........................................88888888D..........
..........D888888888888DO+. ..........................?ND888888888888D..........
...........O8888888888888888888888...........D8888888888888888888888=...........
............ .:D8888888888888888888.........78888888888888888888O ..............

執行以下測試樣本，驗證阿里雲CLI是否可用。

aliyun sts GetCallerIdentity --profile sso