Key Management Service:CreateKey

Deskripsi kunci.
Deskripsi dapat memiliki panjang 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 materi kunci. Nilai yang valid:

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

• EXTERNAL: Materi kunci diimpor.

• Jika Anda menyetel parameter ini ke EXTERNAL, impor materi kunci. Untuk informasi selengkapnya, lihat Impor materi kunci untuk kunci simetris atau Impor materi 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 HSM terkelola tersedia di region tersebut, KMS akan menyetel parameter ini ke HSM. Jika tidak, KMS akan menyetelnya ke SOFTWARE. Untuk informasi selengkapnya, lihat Ikhtisar HSM terkelola.

Menentukan apakah akan mengaktifkan rotasi kunci otomatis. Nilai yang valid:

• true: mengaktifkan rotasi kunci otomatis.

• false (default): menonaktifkan rotasi kunci otomatis.

Parameter ini hanya valid jika tipe manajemen kunci dari kunci tersebut 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 mewakili periode 7 hari.

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

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

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

Spesifikasi kunci. Nilai yang valid bervariasi berdasarkan tipe manajemen kunci. Untuk informasi selengkapnya tentang spesifikasi kunci, standar yang didukung, dan algoritma, lihat Tipe manajemen kunci dan spesifikasi kunci.

ID instance KMS.

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

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

Setiap kunci tag dan nilai tag dapat memiliki panjang hingga 128 karakter dan dapat berisi huruf besar, huruf kecil, angka, garis miring (/), garis miring terbalik (\), garis bawah (_), tanda hubung (-), titik (.), tanda tambah (+), tanda sama dengan (=), titik dua (:), dan tanda at (@).

Konten kebijakan kunci. Nilai dalam format JSON. Kebijakan dapat memiliki panjang hingga 32.768 byte. Untuk informasi selengkapnya tentang kebijakan kunci, lihat Ikhtisar kebijakan kunci. Jika Anda tidak menentukan parameter ini, kebijakan kredensial default akan digunakan.

Sebuah kebijakan kunci berisi konten berikut:

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

• Statement: Pernyataan dalam kebijakan kunci. Setiap kebijakan kunci berisi satu atau lebih 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"
        }
      }
    }
  ]
}

Detail tentang sebuah pernyataan:

• Sid: (Opsional) Pengenal pernyataan kustom. Pengenal dapat memiliki panjang hingga 128 karakter dan dapat berisi huruf besar (A-Z), huruf kecil (a-z), angka (0-9), dan karakter khusus, termasuk garis bawah (_), garis miring (/), tanda tambah (+), tanda sama dengan (=), titik (.), tanda at (@), dan tanda hubung (-).

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

• Principal: (Wajib) Principal yang diberi izin. Setel parameter ini ke akun Alibaba Cloud saat ini (akun Alibaba Cloud yang memiliki kunci tersebut), 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. Nilai harus diawali dengan "kms:". Untuk daftar operasi yang didukung, lihat Ikhtisar kebijakan kunci. Jika Anda menentukan operasi yang tidak ada dalam daftar, pengaturan tidak akan berlaku.

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

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

Lokasi penyimpanan kunci. Parameter ini hanya valid jika DKMSInstanceId ditentukan untuk instance manajemen kunci perangkat keras. Nilai yang valid:

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

• HsmEncryptedDatabase: Kunci disimpan dalam basis data.

  • Kunci simetris: Rotasi didukung.

  • Kunci asimetris: Rotasi tidak didukung.