ECS實例RAM角色

為ECS實例授予RAM角色。具體操作，請參見通過ECS實例RAM角色授權(quán)ECS訪問其他云服務(wù)。

RAM角色

1. 創(chuàng)建RAM角色。創(chuàng)建時可信實體需要選擇阿里云賬號或則渠道供應(yīng)商，其余操作，請參見創(chuàng)建RAM角色。

2. 獲取目標(biāo)RAM角色的RamRoleArn。具體操作，請參見查看RAM角色。

   說明

   RamRoleArn是RAM角色的ARN信息，即需要扮演的角色ID。格式為acs:ram::$accountID:role/$roleName。$accountID為阿里云賬號ID。$roleName為RAM角色名稱。

STS

1. 創(chuàng)建RAM用戶或RAM角色。具體操作，請參見創(chuàng)建RAM用戶、創(chuàng)建RAM角色。

2. 為RAM用戶或RAM角色授予AliyunSTSAssumeRoleAccess權(quán)限。具體操作，請參見為RAM用戶授權(quán)、為RAM角色授權(quán)。

3. 使用RAM用戶或RAM角色調(diào)用STS服務(wù)的AssumeRole接口獲取STS臨時訪問憑證。具體操作，請參見AssumeRole - 獲取扮演角色的臨時身份憑證。

ClientKey

您需要先創(chuàng)建應(yīng)用接入點AAP，然后在AAP中創(chuàng)建ClientKey。根據(jù)調(diào)用的API類型不同AAP的配置也不同，具體配置如下：

• 訪問KMS服務(wù)Endpoint-OpenAPI

  網(wǎng)絡(luò)規(guī)則-網(wǎng)絡(luò)類型選擇Public或VPC，權(quán)限規(guī)則-作用域選擇KMS共享網(wǎng)關(guān)。

• 訪問KMS實例Endpoint-實例API

  網(wǎng)絡(luò)規(guī)則-網(wǎng)絡(luò)類型選擇Private，作用域選擇實例ID。

具體操作，請參見創(chuàng)建應(yīng)用接入點。

AccessKey（不推薦）

具體操作，請參見創(chuàng)建AccessKey。

Java

訪問alibabacloud-secretsmanager-client-java了解更多安裝信息和源代碼。

通過Maven的方式在項目中安裝憑據(jù)客戶端。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>alibabacloud-secretsmanager-client</artifactId>
    <version>1.x.x</version>
</dependency>
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.x.x</version>
</dependency>

Python

訪問aliyun-secretsmanager-client-python了解更多安裝信息和源代碼。

執(zhí)行pip命令安裝憑據(jù)客戶端。

pip install aliyun-secret-manager-client

Go

訪問aliyun-secretsmanager-client-go了解更多安裝信息和源代碼。

使用go get命令，在項目中使用憑據(jù)客戶端。

go get -u github.com/aliyun/aliyun-secretsmanager-client-go

Java

• 方式一：通過系統(tǒng)環(huán)境變量或配置文件（secretsmanager.properties）構(gòu)建客戶端

  系統(tǒng)環(huán)境變量的詳細(xì)信息，請參見附錄一：系統(tǒng)環(huán)境變量。配置文件的詳細(xì)信息，請參見附錄二：配置文件。需要注意配置文件名稱固定為secretsmanager.properties。

  請將示例代碼中的#secretName#替換為您的憑據(jù)名稱。

  import com.aliyuncs.kms.secretsmanager.client.SecretCacheClient;
  import com.aliyuncs.kms.secretsmanager.client.SecretCacheClientBuilder;
  import com.aliyuncs.kms.secretsmanager.client.exception.CacheSecretException;
  import com.aliyuncs.kms.secretsmanager.client.model.SecretInfo;
  
  public class CacheClientEnvironmentSample {
  
      public static void main(String[] args) {
          try {
              //構(gòu)建憑據(jù)客戶端
              SecretCacheClient client = SecretCacheClientBuilder.newClient();
              //使用構(gòu)建好的客戶端獲取憑據(jù)信息
              SecretInfo secretInfo = client.getSecretInfo("#secretName#");
              System.out.println(secretInfo);
          } catch (CacheSecretException e) {
              e.printStackTrace();
          }
      }
  }

• 方式二：通過自定義配置文件構(gòu)建客戶端

  配置文件的詳細(xì)信息，請參見附錄二：配置文件。需要注意配置文件名稱和文件路徑由您自行定義。

  請將示例代碼中的#customConfigFileName#替換為您自定義的配置文件名稱，#secretName#替換為您的憑據(jù)名稱。

  import com.aliyuncs.kms.secretsmanager.client.SecretCacheClient;
  import com.aliyuncs.kms.secretsmanager.client.SecretCacheClientBuilder;
  import com.aliyuncs.kms.secretsmanager.client.exception.CacheSecretException;
  import com.aliyuncs.kms.secretsmanager.client.model.SecretInfo;
  import com.aliyuncs.kms.secretsmanager.client.service.BaseSecretManagerClientBuilder;
  
  public class CacheClientCustomConfigFileSample {
  
      public static void main(String[] args) {
          try {
              SecretCacheClient client = SecretCacheClientBuilder.newCacheClientBuilder(
                      BaseSecretManagerClientBuilder.standard().withCustomConfigFile("#customConfigFileName#").build()).build();
              SecretInfo secretInfo = client.getSecretInfo("#secretName#");
              System.out.println(secretInfo);
          } catch (CacheSecretException e) {
              System.out.println("CacheSecretException:" + e.getMessage());
          }
      }
  }

• 方式三：通過指定參數(shù)（accessKey、accessSecret、regionId）構(gòu)建客戶端

  說明

  阿里云賬號AccessKey擁有所有OpenAPI的訪問權(quán)限，建議您使用RAM用戶進行API訪問或日常運維。強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導(dǎo)致AccessKey泄露，威脅您賬號下所有資源的安全。

  本示例以將AccessKey配置在環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET的方式來實現(xiàn)身份驗證為例。

  • 更多認(rèn)證信息配置方式，請參見管理訪問憑據(jù)。

  • 不同操作系統(tǒng)的環(huán)境變量配置方法不同，具體操作，請參見在Linux、macOS和Windows系統(tǒng)配置環(huán)境變量。

  請將示例代碼中的#regionId#替換為實際地域ID，#secretName#替換為您的憑據(jù)名稱。

  import com.aliyuncs.kms.secretsmanager.client.SecretCacheClient;
  import com.aliyuncs.kms.secretsmanager.client.SecretCacheClientBuilder;
  import com.aliyuncs.kms.secretsmanager.client.exception.CacheSecretException;
  import com.aliyuncs.kms.secretsmanager.client.model.SecretInfo;
  import com.aliyuncs.kms.secretsmanager.client.service.BaseSecretManagerClientBuilder;
  import com.aliyuncs.kms.secretsmanager.client.utils.CredentialsProviderUtils;
  
  public class CacheClientSimpleParametersSample {
  
      public static void main(String[] args) {
          try {
              SecretCacheClient client = SecretCacheClientBuilder.newCacheClientBuilder(
                      BaseSecretManagerClientBuilder.standard().withCredentialsProvider(CredentialsProviderUtils
                              .withAccessKey(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))).withRegion("#regionId#").build()).build();
              SecretInfo secretInfo = client.getSecretInfo("#secretName#");
              System.out.println(secretInfo);
          } catch (CacheSecretException e) {
              e.printStackTrace();
          }
      }
  }

Python

• 方式一：通過系統(tǒng)環(huán)境變量或配置文件（secretsmanager.properties）構(gòu)建客戶端

  系統(tǒng)環(huán)境變量的詳細(xì)信息，請參見附錄一：系統(tǒng)環(huán)境變量。配置文件的詳細(xì)信息，請參見附錄二：配置文件。需要注意配置文件名稱固定為secretsmanager.properties。

  請將示例代碼中的#secretName#替換為您的憑據(jù)名稱。

  from alibaba_cloud_secretsmanager_client.secret_manager_cache_client_builder import SecretManagerCacheClientBuilder
  
  if __name__ == '__main__':
      #構(gòu)建憑據(jù)客戶端
      secret_cache_client = SecretManagerCacheClientBuilder.new_client()
      #使用構(gòu)建好的客戶端獲取憑據(jù)信息
      secret_info = secret_cache_client.get_secret_info("#secretName#")
      print(secret_info.__dict__)

• 方式二：通過指定參數(shù)（accessKey、accessSecret、regionId）構(gòu)建客戶端

  說明

  阿里云賬號AccessKey擁有所有OpenAPI的訪問權(quán)限，建議您使用RAM用戶進行API訪問或日常運維。強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導(dǎo)致AccessKey泄露，威脅您賬號下所有資源的安全。

  本示例以將AccessKey配置在環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET的方式來實現(xiàn)身份驗證為例。

  • 更多認(rèn)證信息配置方式，請參見管理訪問憑據(jù)。

  • 不同操作系統(tǒng)的環(huán)境變量配置方法不同，具體操作，請參見在Linux、macOS和Windows系統(tǒng)配置環(huán)境變量。

  請將示例代碼中的#regionId#替換為實際地域ID，#secretName#替換為您的憑據(jù)名稱。

  import os
  
  from alibaba_cloud_secretsmanager_client.secret_manager_cache_client_builder import SecretManagerCacheClientBuilder
  from alibaba_cloud_secretsmanager_client.service.default_secret_manager_client_builder import DefaultSecretManagerClientBuilder
  
  if __name__ == '__main__':
      secret_cache_client = SecretManagerCacheClientBuilder.new_cache_client_builder(DefaultSecretManagerClientBuilder.standard() \
          .with_access_key(os.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), os.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")) \
          .with_region("#regionId#").build()) \
      .build();
      secret_info = secret_cache_client.get_secret_info("#secretName#")
      print(secret_info.__dict__)

Go

• 方式一：通過系統(tǒng)環(huán)境變量或配置文件（secretsmanager.properties）構(gòu)建客戶端

  系統(tǒng)環(huán)境變量的詳細(xì)信息，請參見附錄一：系統(tǒng)環(huán)境變量。配置文件的詳細(xì)信息，請參見附錄二：配置文件。需要注意配置文件名稱固定為secretsmanager.properties。

  請將示例代碼中的#secretName#替換為您的憑據(jù)名稱。

  package main
  
  import (
      "fmt"
      "github.com/aliyun/aliyun-secretsmanager-client-go/sdk"
  )
  func main() { 
     //構(gòu)建憑據(jù)客戶端
      client, err := sdk.NewClient()
      if err != nil {
          // Handle exceptions
          panic(err)
      }
     //使用構(gòu)建好的客戶端獲取憑據(jù)信息
      secretInfo, err := client.GetSecretInfo("#secretName#")
      if err != nil {
          // Handle exceptions
          panic(err)
      }
      fmt.Printf("SecretValue:%s\n",secretInfo.SecretValue)
  }

• 通過指定參數(shù)（accessKey、accessSecret、regionId）構(gòu)建客戶端

  說明

  阿里云賬號AccessKey擁有所有OpenAPI的訪問權(quán)限，建議您使用RAM用戶進行API訪問或日常運維。強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導(dǎo)致AccessKey泄露，威脅您賬號下所有資源的安全。

  本示例以將AccessKey配置在環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET的方式來實現(xiàn)身份驗證為例。

  • 更多認(rèn)證信息配置方式，請參見客戶端初始化和請求方式。

  • 不同操作系統(tǒng)的環(huán)境變量配置方法不同，具體操作，請參見在Linux、macOS和Windows系統(tǒng)配置環(huán)境變量。

  請將示例代碼中的#regionId#替換為實際地域ID，#secretName#替換為您的憑據(jù)名稱。

  package main
  
  import (
  	"github.com/aliyun/aliyun-secretsmanager-client-go/sdk/service"
  	"github.com/aliyun/aliyun-secretsmanager-client-go/sdk"
  	"os"
  )
  
  func main() {
  	client, err := sdk.NewSecretCacheClientBuilder(service.NewDefaultSecretManagerClientBuilder().Standard().WithAccessKey(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")).WithRegion("#regionId#").Build()).Build()
  	if err != nil {
  		// Handle exceptions
  		panic(err)
  	}
  	secretInfo, err := client.GetSecretInfo("#secretName#")
  	if err != nil {
  		// Handle exceptions
  		panic(err)
  	}
  }