Key Management Service:RAM シークレットプラグイン

Maven を使用して、RAM 認証情報プラグインをプロジェクトにインポートできます。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-tea-openapi-sdk-managed-credentials-provider</artifactId>
    <version>[1.3.5,]</version>
</dependency>

Java 版 Alibaba Cloud SDK クライアントを取得し、Alibaba Cloud サービスを呼び出します。

次の例は、ECS の DescribeInstances 操作を呼び出す方法を示しています。

1. Elastic Compute Service (ECS) の ecs20140526 依存関係を追加します。

   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>ecs20140526</artifactId>
       <version>7.1.0</version>
   </dependency>

2. DescribeInstances 操作を呼び出します。

   import com.aliyun.ecs20140526.Client;
   import com.aliyun.ecs20140526.models.DescribeInstancesResponse;
   import com.aliyun.kms.secretsmanager.plugin.tea.openapi.ProxyClientCreator;
   import com.google.gson.Gson;
   
   public class AliyunTeaOpenApiProviderSample {
   
       public static void main(String[] args) throws Exception {
           // 手順 1：管理対象シークレットの名前 (KMS で作成したシークレット名) を指定します。
           String secretName = "your-secret-name";
   
           /*
             アプリケーションがクラスパスや実行可能 JAR パッケージからデフォルトの設定ファイル (managed_credentials_providers.properties) を読み取れない場合、
             または設定ファイル名をカスタマイズする場合は、次のコードを呼び出してカスタム設定ファイルを設定できます。ファイルは次の順序で読み取られます：
             1. "your-config-name" がファイル名付きの絶対パスである場合、その絶対パスのファイルが読み取られます。
             2. "your-config-name" がファイル名のみである場合、ファイルはまずクラスパスから読み取られ、次に実行可能 JAR パッケージから読み取られます。
           */
           //ConfigLoader.setConfigName("your-config-name");
   
           // 手順 2：OpenAPI クライアントを設定します。
           com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
           config.endpoint = "your-product-endpoint"; // 実際のサービスエンドポイントに置き換えます。
   
           // 手順 3：クライアントインスタンスを作成します。
           Client client = ProxyClientCreator.createClient(config, Client.class, secretName);
   
           // 手順 4：Alibaba Cloud サービスの API を呼び出します。
           com.aliyun.ecs20140526.models.DescribeInstancesRequest request = new com.aliyun.ecs20140526.models.DescribeInstancesRequest();
           request.setRegionId("cn-hangzhou"); // リージョン ID を設定します。
           DescribeInstancesResponse response = client.describeInstances(request);
   
           // 手順 5：結果を出力します。
           System.out.println(new Gson().toJson(response.getBody()));
       }
   }

Maven を使用して、RAM 認証情報プラグインをプロジェクトにインポートします。

<dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>aliyun-java-sdk-core</artifactId>
   <version>[4.3.2,5.0.0]</version>
</dependency>
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core-managed-credentials-provider</artifactId>
  <version>[1.3.1,]</version>
</dependency>

Java 版 Alibaba Cloud SDK クライアントを取得し、Alibaba Cloud サービスを呼び出します。

次の例は、ECS の DescribeInstanceStatus 操作を呼び出す方法を示しています。

1. ECS の aliyun-java-sdk-ecs 依存関係を追加します。

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>aliyun-java-sdk-ecs</artifactId>
     <version>5.11.20</version>
   </dependency>

2. DescribeInstanceStatus 操作を呼び出します。

   import com.aliyuncs.IAcsClient;
   import com.aliyuncs.ecs.model.v20140526.DescribeInstanceStatusRequest;
   import com.aliyuncs.ecs.model.v20140526.DescribeInstanceStatusResponse;
   import com.aliyun.kms.secretsmanager.plugin.sdkcore.ProxyAcsClient;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.exceptions.ServerException;
   
   public class AliyunSdkProviderSample {
       public static void main(String[]args) {
           String secretName="******";
           /*
             アプリケーションがクラスパスや実行可能 JAR パッケージからデフォルトの設定ファイル (managed_credentials_providers.properties) を読み取れない場合、
             または設定ファイル名をカスタマイズする場合は、次のコードを呼び出してカスタム設定ファイルを設定できます。ファイルは次の順序で読み取られます：
             1. "your-config-name" がファイル名付きの絶対パスである場合、その絶対パスのファイルが読み取られます。
             2. "your-config-name" がファイル名のみである場合、ファイルはまずクラスパスから読み取られ、次に実行可能 JAR パッケージから読み取られます。
           */
           //ConfigLoader.setConfigName("your-config-name");
           
           // 1. aliyun-java-sdk-managed-credentials-provider を使用して ACSClient を取得します。
           IAcsClient client = null;
           try {
               client = new ProxyAcsClient("<the regionId of ECS>", secretName);
           } catch (ClientException e) {
                e.printStackTrace();
            }
           // 2. ECS の OpenAPI を呼び出してビジネス機能を実装します。
           DescribeInstanceStatusRequest request = new DescribeInstanceStatusRequest();
           DescribeInstanceStatusResponse response;
           try {
                response = client.getAcsResponse(request);
           } catch (ServerException e) {
                e.printStackTrace();
            } catch (ClientException e) {
                e.printStackTrace();
            }
           // 3. 次のメソッドを呼び出してクライアントをシャットダウンし、プラグインに関連するリソースを解放します。
           client.shutdown();
       }
   }

Maven を使用して、RAM 認証情報プラグインをプロジェクトにインポートできます。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.17</version>
</dependency>
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>[2.1.0,3.10.2]</version>
<exclusions>
    <exclusion>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-kms</artifactId>
    </exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-sdk-oss-managed-credentials-provider</artifactId>
<version>[1.3.1,]</version>
</dependency>

Java 版 OSS SDK クライアントを取得し、Alibaba Cloud サービスを呼び出します。

import com.aliyun.kms.secretsmanager.plugin.oss.ProxyOSSClientBuilder;
import com.aliyun.oss.OSS;
import com.aliyun.oss.model.Bucket;

import java.util.List;

public class OssProviderSample {

    public static void main(String[] args) throws Exception {
        String secretName = "******";
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";

        /*
          アプリケーションがクラスパスや実行可能 JAR パッケージからデフォルトの設定ファイル (managed_credentials_providers.properties) を読み取れない場合、
          または設定ファイル名をカスタマイズする場合は、次のコードを呼び出してカスタム設定ファイルを設定できます。ファイルは次の順序で読み取られます：
          1. "your-config-name" がファイル名付きの絶対パスである場合、その絶対パスのファイルが読み取られます。
          2. "your-config-name" がファイル名のみである場合、ファイルはまずクラスパスから読み取られ、次に実行可能 JAR パッケージから読み取られます。
        */
        //ConfigLoader.setConfigName("your-config-name");

        // OSS クライアントを取得します。
        OSS ossClient = new ProxyOSSClientBuilder().build(endpoint, secretName);


        // 以下はビジネスコードです：Alibaba Cloud OSS サービスを呼び出してビジネス機能を実装します。
        List<Bucket> buckets = ossClient.listBuckets();
        for (Bucket bucket : buckets) {
            if (bucket != null) {
                // ...
            }
        }

        // 次のメソッドを呼び出してクライアントをシャットダウンし、プラグインに関連するリソースを解放します。
        ossClient.shutdown();
    }

}

pip コマンドを実行して、プロジェクトで RAM 認証情報プラグインを使用します。

pip install aliyun-openapi-python-sdk-managed-credentials-provider

Python 版 Alibaba Cloud SDK クライアントを取得し、Alibaba Cloud サービスを呼び出します。

from aliyun_sdk_secretsmanager_sdk_core_plugin.proxy_acs_client import ProxyAcsClient

   region="cn-hangzhou"
   secretName="******"

   # 1. ACSClient を取得します。
   client = ProxyAcsClient(region_id=region, secret_name=secretName )

   # 2. ビジネスコード：クライアントを使用して、コードを変更せずに Alibaba Cloud サービスを呼び出します。
   ...

   # 3. 次のメソッドを呼び出してクライアントをシャットダウンし、プラグインに関連するリソースを解放します。
   client.shutdown()

pip コマンドを実行して、プロジェクトで RAM 認証情報プラグインを使用できます。

pip install aliyun-oss-python-sdk-managed-credentials-provider

Python 版 Alibaba Cloud OSS SDK クライアントを取得し、Alibaba Cloud サービスを呼び出します。

from aliyun_sdk_secretsmanager_oss_plugin.proxy_bucket import ProxyBucket
from itertools import islice

endpoint = "******"
secret_name ="******"
bucket_name = "******"
bucket = ProxyBucket(secret_name=secret_name, endpoint=endpoint, bucket_name=bucket_name)
objects = bucket.list_objects()
for b in islice(objects.object_list, 10):
    print(b.key)
bucket.shutdown()

Go 版 Alibaba Cloud SDK 用の RAM 認証情報プラグインをインストールします。

• メソッド 1：go.mod を使用して依存関係を管理します。

  go.mod ファイルに次の内容を追加して、依存パッケージをインストールします。

  require (
      github.com/aliyun/aliyun-sdk-managed-credentials-providers-go/aliyun-sdk-managed-credentials-providers/alibaba-cloud-sdk-go-managed-credentials-provider vX.X.X
  )

• メソッド 2：go get コマンドを使用してリモートコードパッケージを取得します。

  go get -u github.com/aliyun/aliyun-sdk-mxanaged-credentials-providers-go/aliyun-sdk-managed-credentials-providers/alibaba-cloud-sdk-go-managed-credentials-provider

Go 版 Alibaba Cloud SDK のクライアントを取得し、Alibaba Cloud サービスを呼び出します。

package sample

import (
    "fmt"
    "github.com/aliyun/alibaba-cloud-sdk-go/services/ecs"
    sdkcoreprovider "github.com/aliyun/aliyun-sdk-managed-credentials-providers-go/aliyun-sdk-managed-credentials-providers/alibaba-cloud-sdk-go-managed-credentials-provider/sdk"
)

func main() {
    secretName := "********"
    regionId := "cn-hangzhou"

    client, err := sdkcoreprovider.GetClient(&ecs.Client{}, regionId, secretName)
    if err != nil {
        fmt.Println(err)
        return
    }
    ecsClient := client.(*ecs.Client)

    request := ecs.CreateDescribeInstancesRequest()
    instancesResponse, err := ecsClient.DescribeInstances(request)
    if err != nil {
        fmt.Println(err)
        return
    }

    for _, instance := range instancesResponse.Instances.Instance {
        // do something with instance
    }
}

Go 版 OSS SDK 用の RAM 認証情報プラグインをインストールします。

• メソッド 1：go.mod を使用して依存関係を管理します。

  go.mod ファイルに次の内容を追加して、依存パッケージをインストールします。

  require (
      github.com/aliyun/aliyun-sdk-managed-credentials-providers-go/aliyun-sdk-managed-credentials-providers/aliyun-oss-go-sdk-managed-credentials-provider vX.X.X
  )

• メソッド 2：go get コマンドを使用してリモートコードパッケージを取得します。

  go get -u github.com/aliyun/aliyun-sdk-managed-credentials-providers-go/aliyun-sdk-managed-credentials-providers/aliyun-oss-go-sdk-managed-credentials-provider

Go 版 Alibaba Cloud OSS SDK のクライアントを取得し、Alibaba Cloud サービスを呼び出します。

package sample

import (
    "fmt"
    ossprovider "aliyun-oss-go-sdk-managed-credentials-provider/sdk"
)

func main() {
    secretName := "********"
    endpoint := "https://oss-cn-hangzhou.aliyuncs.com"

    // プロキシ OSS クライアントを取得します。
    client, err := ossprovider.New(endpoint, secretName)
    if err != nil {
        fmt.Println(err)
        return
    }

    result, err := client.ListBuckets()
    if err != nil {
        fmt.Println(err)
        return
    }
    for _, bucket := range result.Buckets {
        // ビジネスコード
    }

    // クライアントをシャットダウンして、プラグインに関連するリソースを解放します。
    client.Shutdown()
}