Key Management Service：CreateKey

Deskripsi kunci.
Panjang deskripsi dapat berkisar antara 0 hingga 8.192 karakter.

Penggunaan kunci. Nilai yang valid:

• ENCRYPT/DECRYPT: mengenkripsi dan mendekripsi data.

• SIGN/VERIFY: menghasilkan dan memverifikasi tanda tangan digital.

Nilai default: Jika kunci mendukung verifikasi tanda tangan, nilai default-nya adalah SIGN/VERIFY. Jika tidak, nilai default-nya adalah ENCRYPT/DECRYPT.

Sumber bahan kunci. Nilai yang valid:

• Aliyun_KMS (default): Bahan kunci dihasilkan oleh Alibaba Cloud KMS.

• EXTERNAL: Bahan kunci diimpor.

• Jika Anda mengatur parameter ini ke EXTERNAL, impor bahan kunci. Untuk informasi selengkapnya, lihat Impor bahan kunci untuk kunci simetris atau Impor bahan kunci untuk kunci asimetris.

Anda tidak perlu menentukan parameter ini. KMS secara otomatis menetapkan tingkat perlindungan yang sesuai untuk kunci Anda.

Tingkat perlindungan kunci. Nilai yang valid:

• SOFTWARE

• HSM

• Jika Anda tidak menentukan DKMSInstanceId, biarkan parameter ini kosong. KMS akan menetapkan tingkat perlindungan. Jika managed HSM tersedia di wilayah tersebut, KMS menetapkan parameter ini ke HSM. Jika tidak, KMS menetapkannya ke SOFTWARE. Untuk informasi selengkapnya, lihat Ikhtisar Managed HSM.

Menentukan apakah rotasi kunci otomatis diaktifkan. Nilai yang valid:

• true: mengaktifkan rotasi kunci otomatis.

• false (default): menonaktifkan rotasi kunci otomatis.

Parameter ini hanya berlaku jika jenis manajemen kunci mendukung rotasi otomatis. Untuk informasi selengkapnya, lihat Rotasi kunci.

Periode rotasi otomatis. Formatnya adalah `integer[unit]`. `integer` menunjukkan panjang periode. `unit` menunjukkan satuan waktu. Satuan yang valid: d (hari), h (jam), m (menit), dan s (detik). Misalnya, baik 7d maupun 604800s merepresentasikan periode 7 hari.

• Jika kuncinya adalah kunci default, nilainya adalah 365d.

• Jika kuncinya adalah kunci yang dilindungi perangkat lunak, nilainya dapat berkisar antara 7d hingga 365d.

• Jika kuncinya adalah kunci yang dilindungi perangkat keras, rotasi otomatis tidak didukung.

Spesifikasi kunci. Nilai yang valid bervariasi tergantung pada jenis manajemen kunci. Untuk informasi selengkapnya tentang spesifikasi kunci, standar yang didukung, dan algoritma, lihat Jenis manajemen kunci dan spesifikasi kunci.

ID instans KMS.

Tag yang akan di-bind ke kunci. Setiap tag terdiri dari pasangan kunci-nilai (Key:Value), yang mencakup kunci tag dan nilai tag.

Tentukan maksimal 20 tag. Untuk menentukan beberapa tag, gunakan format berikut: [{"TagKey":"key1","TagValue":"value1"},{"TagKey":"key2","TagValue":"value2"},...].

Panjang setiap kunci tag dan nilai tag dapat mencapai 128 karakter dan dapat berisi huruf besar, huruf kecil, angka, garis miring (/), garis miring terbalik (\), garis bawah (_), tanda hubung (-), titik (.), tanda plus (+), tanda sama dengan (=), titik dua (:), dan tanda at (@).

Konten kebijakan kunci. Nilainya dalam format JSON. Panjang kebijakan dapat mencapai 32.768 byte. Untuk informasi selengkapnya tentang kebijakan kunci, lihat Ikhtisar kebijakan kunci. Jika Anda tidak menentukan parameter ini, kebijakan kredensial default akan digunakan.

Kebijakan kunci berisi konten berikut:

• Version: Versi kebijakan kunci. Hanya versi 1 yang didukung.

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

Berikut adalah format kebijakan kunci:

{
  "Version": "1",
  "Statement": [
    {
      "Sid": "Enable RAM User Permissions",
      "Effect": "Allow",
      "Principal": {
        "RAM": ["acs:ram::112890462****:root"]
      },
      "Action": [
        "kms:*"
      ],
      "Resource": [
        "*"
      ],
      "Condition": {
        "condition operator": {
          "condition key": "condition value"
        }
      }
    }
  ]
}

Rincian pernyataan:

• Sid: (Opsional) Pengidentifikasi pernyataan kustom. Pengidentifikasi dapat mencapai panjang 128 karakter dan dapat berisi huruf besar (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 diberikan izin. Atur parameter ini ke Akun Alibaba Cloud saat ini (Akun Alibaba Cloud tempat kunci tersebut berada), RAM user atau RAM role dari Akun Alibaba Cloud saat ini, atau RAM user atau RAM role 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 kunci. Jika Anda menentukan operasi yang tidak ada dalam daftar, pengaturan tersebut tidak berlaku.

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

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

Lokasi penyimpanan kunci. Parameter ini hanya berlaku ketika DKMSInstanceId ditentukan untuk instans manajemen kunci perangkat keras. Nilai yang valid:

• HsmInternal (default): Kunci disimpan di HSM dan tidak mendukung rotasi.

• HsmEncryptedDatabase: Kunci disimpan di database.

  • Kunci simetris: Rotasi didukung.

  • Kunci asimetris: Rotasi tidak didukung.