Key Management Service:CreateSecret

Nama secret. Nama tersebut harus unik dalam wilayah yang sama. Nama dapat terdiri hingga 192 karakter dan boleh mengandung huruf, angka, garis bawah (_), garis miring (/), tanda plus (+), tanda sama dengan (=), titik (.), tanda hubung (-), dan tanda at (@). Batasan berikut berlaku untuk nama secret jenis tertentu:

• Jika SecretType diatur ke Generic, Rds, atau Redis, nama tidak boleh diawali dengan acs/.

• Jika SecretType diatur ke RAMCredentials, atur parameter ini ke nilai tetap $Auto. Dalam kasus ini, KMS secara otomatis menghasilkan nama secret yang diawali dengan acs/ram/user/ dan berisi nama tampilan Pengguna RAM.

• Jika SecretType diatur ke ECS, nama harus diawali dengan acs/ecs/.

Nomor versi dari versi awal. Nomor versi harus unik dalam satu secret. Nomor versi dapat terdiri hingga 64 karakter.

ID kunci yang digunakan untuk mengenkripsi nilai secret.

Nilai secret. Nilai tersebut dapat terdiri hingga 30.720 byte (30 KB). KMS mengenkripsi nilai secret dengan kunci yang ditentukan dan menyimpan nilai terenkripsi tersebut dalam versi awal.

• Jika SecretType diatur ke Generic, Anda dapat menentukan nilai secret kustom.

• Jika SecretType diatur ke Rds, nilai secret harus dalam format berikut: {"Accounts":[{"AccountName":"","AccountPassword":""}]}. Dalam format tersebut, AccountName menentukan username akun untuk instans RDS dan AccountPassword menentukan password akun tersebut.

• Jika SecretType diatur ke Redis, atur parameter ini ke $Auto.

• Jika SecretType diatur ke RAMCredentials, nilai secret harus dalam format berikut: {"AccessKeys":[{"AccessKeyId":"","AccessKeySecret":""}]}. Dalam format tersebut, AccessKeyId menentukan ID AccessKey dan AccessKeySecret menentukan Rahasia AccessKey. Anda harus menentukan semua Pasangan Kunci Akses Pengguna RAM.

• Jika SecretType diatur ke PolarDB, atur parameter ini ke $Auto.

• Jika SecretType diatur ke ECS, nilai secret harus dalam salah satu format berikut:

  • Jika SecretSubType dalam parameter ExtendedConfig diatur ke Password: {"UserName":"","Password": ""}. Dalam format tersebut, UserName menentukan username yang digunakan untuk login ke instans ECS dan Password menentukan password yang digunakan untuk login ke instans ECS.

  • Jika SecretSubType dalam parameter ExtendedConfig diatur ke SSHKey: {"UserName":"","PublicKey": "", "PrivateKey": ""}. Dalam format tersebut, PublicKey menentukan kunci publik dalam format SSH yang digunakan untuk login ke instans ECS dan PrivateKey menentukan kunci privat yang digunakan untuk login ke instans ECS.

Jenis nilai secret. Nilai yang valid:

• text (default): Nilai secret berupa string teks.

• binary: Nilai secret berupa string biner.

Deskripsi secret.

Tag secret. Setiap tag terdiri dari pasangan kunci-nilai. Tag terdiri dari kunci tag dan nilai tag.

Kunci tag dan nilai tag dapat terdiri hingga 128 karakter dan boleh mengandung huruf, angka, garis miring (/), garis miring terbalik (\), garis bawah (_), tanda hubung (-), titik (.), tanda plus (+), tanda sama dengan (=), titik dua (:), dan tanda at (@).

• Kunci tag tidak boleh diawali dengan aliyun atau acs:.

• Anda dapat menentukan hingga 20 pasangan kunci-nilai untuk setiap secret.

Jenis secret. Nilai yang valid:

• Generic (default): secret generik.

• Rds: secret RDS.

• Redis: secret Redis.

• RAMCredentials: secret RAM.

• ECS: secret ECS.

• PolarDB: secret PolarDB.

Konfigurasi tambahan secret. Parameter ini menentukan properti secret jenis tertentu. Nilainya dapat terdiri hingga 1.024 karakter.

• Jika SecretType diatur ke Generic, parameter ini diabaikan.

• Jika SecretType diatur ke Rds, Anda harus menentukan parameter berikut dalam ExtendedConfig:

  • SecretSubType (Wajib): Subjenis secret. Nilai yang valid:

    • SingleUser: Secrets Manager mengelola secret RDS dalam mode akun tunggal. Saat secret diputar, password akun yang ditentukan diatur ulang menjadi password acak baru.

    • DoubleUsers: Secrets Manager mengelola secret RDS dalam mode akun ganda. ACSCurrent dan ACSPrevious mengarah ke salah satu akun. Saat secret diputar, password akun yang diarahkan oleh ACSPrevious diatur ulang menjadi password acak baru. Kemudian, Secrets Manager menukar akun yang diarahkan oleh ACSCurrent dan ACSPrevious.

  • DBInstanceId (Wajib): ID instans RDS tempat akun tersebut berada.

  • CustomData (Opsional): Data kustom. Nilainya berupa pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Contoh: {"Key1": "v1", "fds":"fdsf"}. Nilai default adalah {}.

• Jika SecretType diatur ke Redis, Anda harus menentukan parameter berikut dalam ExtendedConfig:

  • SecretSubType (Wajib): Subjenis secret. Nilai yang valid:

    • DoubleUsers: Secrets Manager mengelola secret Redis dalam mode akun ganda. ACSCurrent dan ACSPrevious mengarah ke salah satu akun. Saat secret diputar, password akun yang diarahkan oleh ACSPrevious diatur ulang menjadi password acak baru. Kemudian, Secrets Manager menukar akun yang diarahkan oleh ACSCurrent dan ACSPrevious.

  • AccountName (Wajib): Username database.

  • CloneAccountName (Wajib): Username database, yaitu nilai AccountName dengan akhiran _clone.

  • AccountPrivilege (Wajib): Izin untuk mengakses database.

  • InstanceId (Wajib): ID instans Redis.

  • RegionId (Wajib): ID wilayah tempat instans Redis berada.

  • CustomData (Opsional): Data kustom. Nilainya berupa pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Contoh: {"Key1": "v1", "fds":"fdsf"}. Nilai default adalah {}.

• Jika SecretType diatur ke RAMCredentials, Anda harus menentukan parameter berikut dalam ExtendedConfig:

  • SecretSubType (Wajib): Subjenis secret. Nilainya adalah RamUserAccessKey.

  • UserName (Wajib): Nama Pengguna RAM.

  • CustomData (Opsional): Data kustom. Nilainya berupa pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Nilai default adalah {}.

• Jika SecretType diatur ke ECS, Anda harus menentukan parameter berikut dalam ExtendedConfig:

  • SecretSubType (Wajib): Subjenis secret. Nilai yang valid:

    • Password: password ECS.

    • SSHKey: pasangan kunci SSH ECS.

  • RegionId (Wajib): ID wilayah tempat instans ECS berada.

  • InstanceId (Wajib): ID instans ECS.

  • CustomData (Opsional): Data kustom. Nilainya berupa pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Nilai default adalah {}.

• Jika SecretType diatur ke PolarDB, Anda harus menentukan parameter berikut dalam ExtendedConfig:

  • SecretSubType (Wajib): Nilai tetapnya adalah DoubleUsers.

  • RegionId (Wajib): Wilayah.

  • DBClusterId (Wajib): ID instans PolarDB.

  • DBType (Wajib): MySQL atau PostgreSQL.

  • AccountName (Wajib): Nama akun.

  • CloneAccountName: Nilainya adalah AccountName_clone.

  • AccountType: Hanya Normal yang didukung.

  • AccountPrivilege: Parameter ini hanya tersedia untuk MySQL.

  • DBName: Parameter ini hanya tersedia untuk MySQL.

  • CustomData (Opsional): Data kustom. Nilainya berupa pasangan kunci-nilai dalam format JSON. Anda dapat menentukan hingga 10 pasangan kunci-nilai. Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Contoh: {"Key1": "v1", "fds":"fdsf"}. Nilai default adalah {}.

Menentukan apakah rotasi otomatis diaktifkan. Nilai yang valid:

• true: mengaktifkan rotasi otomatis.

• false (default): menonaktifkan rotasi otomatis.

Interval untuk rotasi otomatis. Nilainya berada dalam rentang 6 jam hingga 8.760 jam (365 hari).
Nilainya dalam format integer[unit]. integer menunjukkan interval. unit menunjukkan satuan waktu.
Nilai yang valid untuk unit: d (hari), h (jam), m (menit), dan s (detik). Misalnya, baik 7d maupun 604.800s menunjukkan interval rotasi 7 hari.

ID instans KMS.

Konten kebijakan secret. Nilainya dalam format JSON. Nilainya dapat terdiri hingga 32.768 byte.

Untuk informasi selengkapnya mengenai kebijakan secret, lihat Ikhtisar kebijakan secret. Jika Anda tidak menentukan parameter ini, kebijakan secret default akan digunakan.

Kebijakan secret terdiri dari bagian-bagian berikut:

• Version: Versi kebijakan secret. Hanya 1 yang didukung.

• Statement: Pernyataan kebijakan secret. Setiap kebijakan secret dapat berisi satu atau beberapa pernyataan.

Berikut adalah format kebijakan secret:

{
    "Version": "1",
    "Statement": [
        {
            "Sid": "Enable RAM User Permissions",
            "Effect": "Allow",
            "Principal": {
              "RAM": ["acs:ram::12345678****:*"]
            },
            "Action": [
                "kms:*"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

Detail mengenai pernyataan:

• Sid: (Opsional) Pengenal kustom pernyataan. Nilainya dapat terdiri hingga 128 karakter dan boleh mengandung huruf kapital (A-Z), huruf kecil (a-z), angka (0-9), serta karakter khusus, termasuk garis bawah (_), garis miring (/), tanda plus (+), tanda sama dengan (=), titik (.), tanda at (@), dan tanda hubung (-).

• Effect: (Wajib) Efek pernyataan kebijakan. Nilai yang valid: Allow dan Deny.

• Principal: (Wajib) Pihak yang berwenang yang diberi otorisasi oleh kebijakan. Anda dapat menentukan Akun Alibaba Cloud saat ini (akun tempat secret tersebut berada), Pengguna RAM atau Peran RAM dari Akun Alibaba Cloud saat ini, atau Pengguna RAM atau Peran RAM dari Akun Alibaba Cloud lain.

• Action: (Wajib) Operasi API yang diizinkan atau ditolak. Nilainya harus diawali dengan "kms:". Untuk daftar operasi yang didukung, lihat Ikhtisar kebijakan secret. Jika Anda menentukan operasi yang tidak ada dalam daftar, pengaturan tersebut tidak berlaku.

• Resource: (Wajib) Sumber daya. Nilainya hanya dapat berupa *, yang menunjukkan secret KMS saat ini.

• Condition: (Opsional) Kondisi agar otorisasi berlaku. Anda dapat menggunakan kondisi untuk mengevaluasi konteks permintaan API guna menentukan apakah pernyataan kebijakan harus diterapkan. Formatnya adalah "Condition": {"condition operator": {"condition key": "condition value"}}. Untuk informasi selengkapnya, lihat Ikhtisar kebijakan secret.