Key Management Service:Dedicated KMS SDK for Go

Langkah 1: Konfigurasikan sertifikat CA

Semua permintaan ke instans Dedicated KMS menggunakan mTLS. Atur bidang Verify dalam RuntimeOptions ke konten sertifikat CA Anda.

import (
    dedicatedkmsopenapiutil "github.com/aliyun/alibabacloud-dkms-gcs-go-sdk/openapi-util"
    "github.com/alibabacloud-go/tea/tea"
    "io/ioutil"
)

// Baca sertifikat CA dari disk.
ca, err := ioutil.ReadFile("path/to/PrivateKmsCA_kst-******.pem")
if err != nil {
    log.Fatalf("failed to read CA certificate: %v", err)
}

runtimeOptions := &dedicatedkmsopenapiutil.RuntimeOptions{
    Verify: tea.String(string(ca)),
}

// Hanya untuk lingkungan pengembangan — menonaktifkan verifikasi TLS.
runtimeOptions := &dedicatedkmsopenapiutil.RuntimeOptions{
    IgnoreSSL: tea.Bool(true),
}

Langkah 2: Buat client

Buat klien dengan menyediakan konten client key, kata sandi dekripsinya, dan titik akhir instans Dedicated KMS Anda. Titik akhir tidak mencakup skema https://.

import (
    dedicatedkmsopenapi "github.com/aliyun/alibabacloud-dkms-gcs-go-sdk/openapi"
    dedicatedkmssdk "github.com/aliyun/alibabacloud-dkms-gcs-go-sdk/sdk"
    "github.com/alibabacloud-go/tea/tea"
)

config := &dedicatedkmsopenapi.Config{
    // Protokol koneksi. Harus https.
    Protocol: tea.String("https"),
    // Konten file client key (ClientKey_******.json).
    ClientKeyContent: tea.String("<your-client-key-content>"),
    // Password yang digunakan untuk mendekripsi client key.
    Password: tea.String("<your-client-key-password>"),
    // Titik akhir instans Dedicated KMS, tanpa skema https://.
    Endpoint: tea.String("<service_id>.cryptoservice.kms.aliyuncs.com"),
}

client, err := dedicatedkmssdk.NewClient(config)
if err != nil {
    log.Fatalf("failed to create Dedicated KMS client: %v", err)
}

Ganti placeholder berikut:

Enkripsi data

Enkripsi data dengan CMK simetris menggunakan EncryptWithOptions. Respons mencakup CiphertextBlob dan Iv (vektor inisialisasi). Simpan Iv bersama ciphertext — Anda harus memberikan nilai yang sama saat mendekripsi.

Untuk contoh lengkap, lihat Kode sumber.

import (
    dedicatedkmssdk "github.com/aliyun/alibabacloud-dkms-gcs-go-sdk/sdk"
    "github.com/alibabacloud-go/tea/tea"
)

plaintext := []byte("your plaintext data")
// ID atau alias CMK simetris.
keyId := "<your-cmk-id>"

encryptRequest := &dedicatedkmssdk.EncryptRequest{
    KeyId:     tea.String(keyId),
    Plaintext: plaintext,
}

encryptResponse, err := client.EncryptWithOptions(encryptRequest, runtimeOptions)
if err != nil {
    log.Fatalf("encrypt failed: %v", err)
}

// Simpan kedua nilai ini — keduanya diperlukan untuk dekripsi.
ciphertextBlob := encryptResponse.CiphertextBlob
iv := encryptResponse.Iv
requestId := tea.StringValue(encryptResponse.RequestId)

Dekripsi data

Berikan CiphertextBlob dan Iv yang dikembalikan oleh Encrypt ke DecryptWithOptions. Iv harus persis sama.

Untuk contoh lengkap, lihat Kode sumber.

import (
    dedicatedkmssdk "github.com/aliyun/alibabacloud-dkms-gcs-go-sdk/sdk"
    "github.com/alibabacloud-go/tea/tea"
)

// ID atau alias CMK simetris yang digunakan saat enkripsi.
keyId := "<your-cmk-id>"
// Ciphertext dan IV dari respons enkripsi.
ciphertextBlob := []byte("<ciphertext-blob>")
iv := []byte("<iv-from-encrypt-response>")

decryptRequest := &dedicatedkmssdk.DecryptRequest{
    KeyId:          tea.String(keyId),
    CiphertextBlob: ciphertextBlob,
    Iv:             iv,
}

decryptResponse, err := client.DecryptWithOptions(decryptRequest, runtimeOptions)
if err != nil {
    log.Fatalf("decrypt failed: %v", err)
}

plaintext := decryptResponse.Plaintext
requestId := tea.StringValue(decryptResponse.RequestId)

Sign data

Hasilkan tanda tangan digital menggunakan CMK asimetris dengan SignWithOptions.

Untuk contoh lengkap, lihat Kode sumber.

import (
    dedicatedkmssdk "github.com/aliyun/alibabacloud-dkms-gcs-go-sdk/sdk"
    "github.com/alibabacloud-go/tea/tea"
)

// ID atau alias CMK asimetris.
signerKeyId := "<your-asymmetric-cmk-id>"
message := []byte("<data-to-sign>")
// Jenis pesan. Untuk nilai yang valid, lihat repositori open source.
messageType := "<message-type>"

signRequest := &dedicatedkmssdk.SignRequest{
    KeyId:       tea.String(signerKeyId),
    Message:     message,
    MessageType: tea.String(messageType),
}

signResponse, err := client.SignWithOptions(signRequest, runtimeOptions)
if err != nil {
    log.Fatalf("sign failed: %v", err)
}

signature := signResponse.Signature
requestId := tea.StringValue(signResponse.RequestId)

Verifikasi signature

Verifikasi signature terhadap pesan aslinya menggunakan VerifyWithOptions. Bidang Value dalam respons menunjukkan apakah signature valid.

Untuk contoh lengkap, lihat Kode sumber.

import (
    dedicatedkmssdk "github.com/aliyun/alibabacloud-dkms-gcs-go-sdk/sdk"
    "github.com/alibabacloud-go/tea/tea"
)

// ID atau alias CMK asimetris yang digunakan saat signing.
signerKeyId := "<your-asymmetric-cmk-id>"
message := []byte("<original-data>")
signature := []byte("<signature-to-verify>")
// Harus sesuai dengan messageType yang digunakan saat signing.
messageType := "<message-type>"

verifyRequest := &dedicatedkmssdk.VerifyRequest{
    KeyId:       tea.String(signerKeyId),
    Message:     message,
    MessageType: tea.String(messageType),
    Signature:   signature,
}

verifyResponse, err := client.VerifyWithOptions(verifyRequest, runtimeOptions)
if err != nil {
    log.Fatalf("verify failed: %v", err)
}

// true jika signature valid, false jika tidak.
isValid := tea.BoolValue(verifyResponse.Value)
requestId := tea.StringValue(verifyResponse.RequestId)

Ambil nilai rahasia

Untuk contoh lengkap, lihat Kode sumber.

import (
    dedicatedkmssdk "github.com/aliyun/alibabacloud-dkms-gcs-go-sdk/sdk"
    "github.com/alibabacloud-go/tea/tea"
)

secretName := "<your-secret-name>"

getSecretValueRequest := &dedicatedkmssdk.GetSecretValueRequest{
    SecretName: tea.String(secretName),
}

response, err := client.GetSecretValueWithOptions(getSecretValueRequest, runtimeOptions)
if err != nil {
    log.Fatalf("GetSecretValue failed: %v", err)
}

secretData := tea.StringValue(response.SecretData)
requestId := tea.StringValue(response.RequestId)