Key Management Service:Secrets Manager Client

Langkah 1: Buat peran RAM dan konfigurasi izin

Langkah 2: Atur variabel lingkungan atau file konfigurasi

SDK mendukung dua metode berikut untuk memperoleh kredensial akses:

• Variabel lingkungan: Metode konfigurasi berbeda tergantung sistem operasi. Untuk informasi lebih lanjut, lihat .

  Peringatan

  Jangan ubah nama parameter. Jika tidak, SDK tidak dapat mengenalinya.

• File konfigurasi: File konfigurasi default adalah secretsmanager.properties (nama file tidak dapat diubah). Agar aplikasi Anda memuat file konfigurasi dengan benar, letakkan di direktori konfigurasi yang sesuai. Direktori konfigurasi umum untuk berbagai bahasa meliputi:

  • Java: Letakkan file konfigurasi di direktori src/main/resources agar secara otomatis dimasukkan ke classpath saat kompilasi.

  • Go: Letakkan file konfigurasi di direktori root proyek atau direktori khusus config, lalu muat melalui kode.

  • Python: Letakkan file konfigurasi di direktori proyek atau direktori khusus config, dan gunakan metode yang sesuai (seperti os.path atau pkg_resources) untuk memuatnya.

• Jika Anda menggunakan file konfigurasi kustom, Anda harus menentukan jalur file (#customConfigFileName#) saat inisialisasi client.

Langkah 1: Buat AccessKey dan konfigurasi izin

Langkah 2: Atur variabel lingkungan atau file konfigurasi

SDK mendukung dua metode berikut untuk memperoleh kredensial akses:

• Variabel lingkungan: Metode konfigurasi berbeda tergantung sistem operasi. Untuk informasi lebih lanjut, lihat .

  Peringatan

  Jangan ubah nama parameter. Jika tidak, SDK tidak dapat mengenalinya.

• File konfigurasi: File konfigurasi default adalah secretsmanager.properties (nama file tidak dapat diubah). Agar aplikasi Anda memuat file konfigurasi dengan benar, letakkan di direktori konfigurasi yang sesuai. Direktori konfigurasi umum untuk berbagai bahasa meliputi:

  • Java: Letakkan file konfigurasi di direktori src/main/resources agar secara otomatis dimasukkan ke classpath saat kompilasi.

  • Go: Letakkan file konfigurasi di direktori root proyek atau direktori khusus config, lalu muat melalui kode.

  • Python: Letakkan file konfigurasi di direktori proyek atau direktori khusus config, dan gunakan metode yang sesuai (seperti os.path atau pkg_resources) untuk memuatnya.

• Jika Anda menggunakan file konfigurasi kustom, Anda harus menentukan jalur file (#customConfigFileName#) saat inisialisasi client.

Langkah 1: Buat OIDC role ARN dan konfigurasi izin

Langkah 2: Atur variabel lingkungan atau file konfigurasi

SDK mendukung dua metode berikut untuk memperoleh kredensial akses:

• Variabel lingkungan: Metode konfigurasi berbeda tergantung sistem operasi. Untuk informasi lebih lanjut, lihat .

  Peringatan

  Jangan ubah nama parameter. Jika tidak, SDK tidak dapat mengenalinya.

• File konfigurasi: File konfigurasi default adalah secretsmanager.properties (nama file tidak dapat diubah). Agar aplikasi Anda memuat file konfigurasi dengan benar, letakkan di direktori konfigurasi yang sesuai. Direktori konfigurasi umum untuk berbagai bahasa meliputi:

  • Java: Letakkan file konfigurasi di direktori src/main/resources agar secara otomatis dimasukkan ke classpath saat kompilasi.

  • Go: Letakkan file konfigurasi di direktori root proyek atau direktori khusus config, lalu muat melalui kode.

  • Python: Letakkan file konfigurasi di direktori proyek atau direktori khusus config, dan gunakan metode yang sesuai (seperti os.path atau pkg_resources) untuk memuatnya.

• Jika Anda menggunakan file konfigurasi kustom, Anda harus menentukan jalur file (#customConfigFileName#) saat inisialisasi client.

Langkah 1: Buat RAM role ARN dan konfigurasi izin

Langkah 2: Atur variabel lingkungan atau file konfigurasi

SDK mendukung dua metode berikut untuk memperoleh kredensial akses:

• Variabel lingkungan: Metode konfigurasi berbeda tergantung sistem operasi. Untuk informasi lebih lanjut, lihat .

  Peringatan

  Jangan ubah nama parameter. Jika tidak, SDK tidak dapat mengenalinya.

• File konfigurasi: File konfigurasi default adalah secretsmanager.properties (nama file tidak dapat diubah). Agar aplikasi Anda memuat file konfigurasi dengan benar, letakkan di direktori konfigurasi yang sesuai. Direktori konfigurasi umum untuk berbagai bahasa meliputi:

  • Java: Letakkan file konfigurasi di direktori src/main/resources agar secara otomatis dimasukkan ke classpath saat kompilasi.

  • Go: Letakkan file konfigurasi di direktori root proyek atau direktori khusus config, lalu muat melalui kode.

  • Python: Letakkan file konfigurasi di direktori proyek atau direktori khusus config, dan gunakan metode yang sesuai (seperti os.path atau pkg_resources) untuk memuatnya.

• Jika Anda menggunakan file konfigurasi kustom, Anda harus menentukan jalur file (#customConfigFileName#) saat inisialisasi client.

Parameter cache_client_dkms_config_info

Gunakan konfigurasi default

SDK secara otomatis membaca informasi kredensial dari file secretsmanager.properties atau variabel lingkungan.

import com.aliyuncs.kms.secretsmanager.client.V2.0.SecretCacheClient;
import com.aliyuncs.kms.secretsmanager.client.V2.0.SecretCacheClientBuilder;
import com.aliyuncs.kms.secretsmanager.client.V2.0.exception.CacheSecretException;
import com.aliyuncs.kms.secretsmanager.client.V2.0.model.SecretInfo;

public class CacheClientEnvironmentSample {

    public static void main(String[] args) {
        try {
            SecretCacheClient client = SecretCacheClientBuilder.newClient();
            SecretInfo secretInfo = client.getSecretInfo("#secretName#");
            System.out.println(secretInfo);
        } catch (CacheSecretException e) {
            e.printStackTrace();
        }
    }
}
          

Gunakan file konfigurasi kustom

Gunakan pendekatan ini ketika file konfigurasi tidak menggunakan nama file atau jalur default. Tentukan jalur file konfigurasi (#customConfigFileName#).

import com.aliyuncs.kms.secretsmanager.client.V2.0.SecretCacheClient;
import com.aliyuncs.kms.secretsmanager.client.V2.0.SecretCacheClientBuilder;
import com.aliyuncs.kms.secretsmanager.client.V2.0.exception.CacheSecretException;
import com.aliyuncs.kms.secretsmanager.client.V2.0.model.SecretInfo;
import com.aliyuncs.kms.secretsmanager.client.V2.0.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());
        }
    }
}
          

Gunakan kredensial hard-coded

Pendekatan ini memungkinkan Anda meneruskan AccessKey dan informasi wilayah secara langsung saat inisialisasi client, tanpa menulis AccessKey ke file konfigurasi atau variabel lingkungan.

import com.aliyuncs.kms.secretsmanager.client.V2.0.SecretCacheClient;
import com.aliyuncs.kms.secretsmanager.client.V2.0.SecretCacheClientBuilder;
import com.aliyuncs.kms.secretsmanager.client.V2.0.exception.CacheSecretException;
import com.aliyuncs.kms.secretsmanager.client.V2.0.model.RegionInfo;
import com.aliyuncs.kms.secretsmanager.client.V2.0.service.BaseSecretManagerClientBuilder;
import com.aliyuncs.kms.secretsmanager.client.V2.0.utils.CredentialsProviderUtils;

public class CacheClientWithCaCertificateSample {
    public static void main(String[] args) {
        try {
            // Buat RegionInfo dengan jalur sertifikat CA
            RegionInfo regionInfo = new RegionInfo();
            regionInfo.setRegionId("#regionId#");
            // Titik akhir gateway khusus. Abaikan jika menggunakan gateway bersama.
            regionInfo.setEndpoint("<your_kms_instance_id>.cryptoservice.kms.aliyuncs.com");

            SecretCacheClient client = SecretCacheClientBuilder.newCacheClientBuilder(
                    BaseSecretManagerClientBuilder.standard()
                            .withCredentialsProvider(CredentialsProviderUtils.withAccessKey(
                                    System.getenv("#accessKeyId#"),
                                    System.getenv("#accessKeySecret#")))
                            .addRegion(regionInfo)
                            .build())
                    .build();
            SecretInfo secretInfo = client.getSecretInfo("#secretName#");
        } catch (CacheSecretException e) {
            e.printStackTrace();
        }
    }
}
          

Gunakan Default credential provider chain Alibaba Cloud

Default credential provider chain adalah strategi fallback. Strategi ini mencari kredensial dalam urutan yang telah ditentukan hingga kredensial ditemukan. Jika semua metode gagal, autentikasi gagal dan kredensial tidak dapat diperoleh.

import com.aliyuncs.kms.secretsmanager.client.V2.0.SecretCacheClient;
import com.aliyuncs.kms.secretsmanager.client.V2.0.SecretCacheClientBuilder;
import com.aliyuncs.kms.secretsmanager.client.V2.0.exception.CacheSecretException;
import com.aliyuncs.kms.secretsmanager.client.V2.0.model.SecretInfo;
import com.aliyuncs.kms.secretsmanager.client.V2.0.service.BaseSecretManagerClientBuilder;

public class CacheClientDefaultCredentialChainSample {

    public static void main(String[] args) {
        try {
            SecretCacheClient client = SecretCacheClientBuilder.newCacheClientBuilder(
                    BaseSecretManagerClientBuilder.standard()
                        .withRegion("#regionId#")
                        .build())
                    .build();
            SecretInfo secretInfo = client.getSecretInfo("#secretName#");
            System.out.println(secretInfo);
        } catch (CacheSecretException e) {
            e.printStackTrace();
        }
    }
}
          

Gunakan konfigurasi default

SDK secara otomatis membaca informasi kredensial dari file secretsmanager.properties atau variabel lingkungan.

from alibabacloud_secretsmanager_client_V2.0.secret_manager_cache_client_builder import SecretManagerCacheClientBuilder

if __name__ == '__main__':
    secret_cache_client = SecretManagerCacheClientBuilder.new_client()
    secret_info = secret_cache_client.get_secret_info("#secretName#")
    print(secret_info.__dict__)
          

Gunakan file konfigurasi kustom

Gunakan pendekatan ini ketika file konfigurasi tidak menggunakan nama file atau jalur default.

from alibabacloud_secretsmanager_client_V2.0.secret_manager_cache_client_builder import SecretManagerCacheClientBuilder
from alibabacloud_secretsmanager_client_V2.0.service.default_secret_manager_client_builder import DefaultSecretManagerClientBuilder

if __name__ == '__main__':
    secret_cache_client = SecretManagerCacheClientBuilder.new_cache_client_builder(
        DefaultSecretManagerClientBuilder.standard()
            .with_custom_config_file("#customConfigFileName#")
            .build()
    ).build()
    secret_info = secret_cache_client.get_secret_info("#secretName#")
    print(secret_info.__dict__)
          

Gunakan kredensial hard-coded

Pendekatan ini meneruskan AccessKey dan informasi wilayah secara langsung saat inisialisasi client.

import os

from alibabacloud_secretsmanager_client_V2.0.secret_manager_cache_client_builder import SecretManagerCacheClientBuilder
from alibabacloud_secretsmanager_client_V2.0.service.default_secret_manager_client_builder import \
    DefaultSecretManagerClientBuilder
from alibabacloud_secretsmanager_client_V2.0.model.region_info import RegionInfo

if __name__ == '__main__':
    # Buat RegionInfo dengan jalur sertifikat CA
    region_info = RegionInfo(
        region_id="#regionId#",
        endpoint="#kmsInstanceEndpoint#",  # Titik akhir gateway khusus. Abaikan jika menggunakan gateway bersama.
    )
    secret_cache_client = SecretManagerCacheClientBuilder.new_cache_client_builder(
        DefaultSecretManagerClientBuilder.standard()
            .with_access_key(
                os.getenv("#accessKeyId#"),
                os.getenv("#accessKeySecret#")
            )
            .add_region_info(region_info)
            .build()
    ).build()
    # ... gunakan client
          

Gunakan Default credential provider chain Alibaba Cloud

from alibabacloud_secretsmanager_client_V2.0.secret_manager_cache_client_builder import SecretManagerCacheClientBuilder
from alibabacloud_secretsmanager_client_V2.0.service.default_secret_manager_client_builder import DefaultSecretManagerClientBuilder

if __name__ == '__main__':
    secret_cache_client = SecretManagerCacheClientBuilder.new_cache_client_builder(
        DefaultSecretManagerClientBuilder.standard()
            .with_region("#regionId#")
            .build()
    ).build()
    secret_info = secret_cache_client.get_secret_info("#secretName#")
    print(secret_info.__dict__)
          

Gunakan konfigurasi default

package main

import "github.com/aliyun/alibabacloud-secretsmanager-client-go-V2.0/sdk"

func main() {
    client, err := sdk.NewClient()
    if err != nil {
        // Tangani exception
        panic(err)
    }
    secretInfo, err := client.GetSecretInfo("#secretName#")
    if err != nil {
        // Tangani exception
        panic(err)
    }
}
          

Gunakan file konfigurasi kustom

package main

import (
    "github.com/aliyun/alibabacloud-secretsmanager-client-go-V2.0/sdk"
    "github.com/aliyun/alibabacloud-secretsmanager-client-go-V2.0/sdk/service"
)

func main() {
    client, err := sdk.NewSecretCacheClientBuilder(
            service.NewDefaultSecretManagerClientBuilder().Standard().
                WithCustomConfigFile("#customConfigFileName#").Build()).Build()
    if err != nil {
        // Tangani exception
        panic(err)
    }
    secretInfo, err := client.GetSecretInfo("#secretName#")
    if err != nil {
        // Tangani exception
        panic(err)
    }
}
          

Gunakan kredensial hard-coded

package main

import (
    "github.com/aliyun/alibabacloud-secretsmanager-client-go-V2.0/sdk"
    "github.com/aliyun/alibabacloud-secretsmanager-client-go-V2.0/sdk/models"
    "github.com/aliyun/alibabacloud-secretsmanager-client-go-V2.0/sdk/service"
    "os"
)

func main() {
    regionInfo := &models.RegionInfo{
        RegionId: "#regionId#",
        // Titik akhir gateway khusus. Abaikan jika menggunakan gateway bersama.
        Endpoint: "<kmsInstanceId>.cryptoservice.kms.aliyuncs.com",
    }

    client, err := sdk.NewSecretCacheClientBuilder(
        service.NewDefaultSecretManagerClientBuilder().
            Standard().
            WithAccessKey(os.Getenv("#accessKeyId#"), os.Getenv("#accessKeySecret#")).
            AddRegionInfo(regionInfo).
            Build()).Build()
    if err != nil {
        // Tangani exception
        panic(err)
    }
    secretInfo, err := client.GetSecretInfo("#secretName#")
    if err != nil {
        // Tangani exception
        panic(err)
    }
}
          

Gunakan Default credential provider chain Alibaba Cloud

package main

import (
    "github.com/aliyun/alibabacloud-secretsmanager-client-go-V2.0/sdk"
    "github.com/aliyun/alibabacloud-secretsmanager-client-go-V2.0/sdk/service"
)

func main() {
    client, err := sdk.NewSecretCacheClientBuilder(
            service.NewDefaultSecretManagerClientBuilder().Standard().
                WithRegion("#regionId#").Build()).Build()
    if err != nil {
        // Tangani exception
        panic(err)
    }
    secretInfo, err := client.GetSecretInfo("#secretName#")
    if err != nil {
        // Tangani exception
        panic(err)
    }
}
          

Gunakan konfigurasi default

SDK secara otomatis membaca informasi kredensial dari file secretsmanager.properties atau variabel lingkungan.

import { SecretCacheClientBuilder } from 'alibabacloud-secretsmanager-client-v2';

async function example() {
  try {
    // Bangun client melalui variabel lingkungan atau konfigurasi default
    const client = await SecretCacheClientBuilder.newClient();
    const secretInfo = await client.getSecretInfo('#secretName#');
    console.log(secretInfo);
  } catch (error) {
    console.error('Error:', error);
  }
}

example();

Gunakan file konfigurasi kustom

Gunakan pendekatan ini ketika file konfigurasi tidak menggunakan nama file atau jalur default. Tentukan jalur file konfigurasi.

import {
  SecretCacheClientBuilder,
  BaseSecretManagerClientBuilder,
  CredentialsProviderUtils
} from 'alibabacloud-secretsmanager-client-v2';

async function example() {
  try {
    const client = await SecretCacheClientBuilder.newCacheClientBuilder(
      BaseSecretManagerClientBuilder.standard().withCustomConfigFile('#customConfigFileName#').build()
    ).build();

    const secretInfo = await client.getSecretInfo('#secretName#');
    console.log(secretInfo);
  } catch (error) {
    console.error('Error:', error);
  }
}

example();

Gunakan kredensial hard-coded

Pendekatan ini meneruskan AccessKey dan informasi wilayah secara langsung saat inisialisasi client.

import {
  SecretCacheClientBuilder,
  BaseSecretManagerClientBuilder,
  CredentialsProviderUtils,
  RegionInfo
} from 'alibabacloud-secretsmanager-client-v2';

async function example() {
  try {
    // Buat RegionInfo dengan jalur sertifikat CA
    const regionInfo = new RegionInfo();
    regionInfo.setRegionId('#regionId#');
    regionInfo.setEndpoint('#kmsInstanceEndpoint#'); // Tentukan alamat instans KMS
    
    const client = await SecretCacheClientBuilder.newCacheClientBuilder(
        BaseSecretManagerClientBuilder.standard()
          .withCredentialsProvider(
            CredentialsProviderUtils.withAccessKey(
              process.env['#accessKeyId#'],
              process.env['#accessKeySecret#']
            )
        )
        .addRegionInfo(regionInfo) // Gunakan RegionInfo dengan jalur sertifikat CA
        .build()
    ).build();

    const secretInfo = await client.getSecretInfo('#secretName#');
    console.log(secretInfo);
  } catch (error) {
    console.error('Error:', error);
  }
}

example();

Gunakan Default credential provider chain Alibaba Cloud

import {
  SecretCacheClientBuilder,
  BaseSecretManagerClientBuilder,
  CredentialsProviderUtils
} from 'alibabacloud-secretsmanager-client-v2';

async function example() {
  try {
    const client = await SecretCacheClientBuilder.newCacheClientBuilder(
      BaseSecretManagerClientBuilder.standard()
        .withCredentialsProvider(CredentialsProviderUtils.withDefaultCredential())
        .withRegion('#regionId#')
        .build()
    ).build();

    const secretInfo = await client.getSecretInfo('#secretName#');
    console.log(secretInfo);
  } catch (error) {
    console.error('Error:', error);
  }
}

example();