CloudSSO：使用CLI登入雲SSO並訪問阿里雲資源

步驟一：安裝CLI

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

• 安裝阿里雲CLI

  • 安裝CLI（Windows）

  • 安裝CLI（Linux）

  • 安裝CLI（macOS）

• 安裝雲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登入資訊

1. 執行以下命令，開始配置雲SSO登入資訊。

   acs-sso configure

2. 輸入使用者登入地址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（SignIn url）和使用者碼（User code）完成登入。

     提示資訊樣本：

     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