Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
exportPrivateKey
exportPrivateKeyPerintah di key_mgmt_util mengekspor kunci pribadi asimetris dari HSM ke file. HSM tidak mengizinkan ekspor langsung kunci dalam cleartext. Perintah membungkus kunci pribadi menggunakan kunci pembungkus AES yang Anda tentukan, mendekripsi byte yang dibungkus, dan menyalin kunci pribadi cleartext ke file.
exportPrivateKeyPerintah tidak menghapus kunci dari HSM, mengubah atribut kuncinya, atau mencegah Anda menggunakan kunci dalam operasi kriptografi lebih lanjut. Anda dapat mengekspor kunci yang sama beberapa kali.
Anda hanya dapat mengekspor kunci privat yang memiliki atribut OBJ_ATTR_EXTRACTABLE
bernilai 1
. Anda harus menentukan kunci pembungkus AES yang memiliki OBJ_ATTR_WRAP
dan nilai OBJ_ATTR_DECRYPT
atribut. 1
Untuk menemukan atribut kunci, gunakan perintah getAttribute.
Sebelum Anda menjalankan perintah key_mgmt_util, Anda harus memulai key_mgmt_util dan masuk ke HSM sebagai pengguna kripto (CU).
Sintaks
exportPrivateKey -h exportPrivateKey -k
<private-key-handle
-w<wrapping-key-handle>
-out<key-file>
[-m<wrapping-mechanism>
] [-wk<wrapping-key-file>
]
Contoh
Contoh ini menunjukkan cara menggunakan exportPrivateKey untuk mengekspor kunci privat dari HSM.
contoh : Ekspor kunci pribadi
Perintah ini mengekspor kunci privat dengan handel 15
menggunakan kunci pembungkus dengan handel 16
ke file PEM bernama exportKey.pem
. Ketika perintah berhasil, exportPrivateKey mengembalikan pesan sukses.
Command:
exportPrivateKey -k 15 -w 16 -out exportKey.pem
Cfm3WrapKey returned: 0x00 : HSM Return: SUCCESS Cfm3UnWrapHostKey returned: 0x00 : HSM Return: SUCCESS PEM formatted private key is written to exportKey.pem
Parameter
Perintah ini membawa parameter berikut.
-h
-
Menampilkan bantuan baris perintah untuk perintah.
Wajib: Ya
-k
-
Menentukan handel kunci dari kunci privat yang akan diekspor.
Wajib: Ya
-w
-
Menentukan handel kunci dari kunci pembungkus. Parameter ini diperlukan. Untuk menemukan handel kunci, gunakan perintah findKey.
Untuk menentukan apakah kunci dapat digunakan sebagai kunci pembungkus, gunakan getAttribute untuk mendapatkan nilai dari atribut
OBJ_ATTR_WRAP
(262). Untuk membuat kunci pembungkus, gunakan genSymKey untuk membuat kunci AES (tipe 31).Jika Anda menggunakan parameter
-wk
untuk menentukan kunci pembuka pembungkus eksternal, kunci pembungkus-w
digunakan untuk membungkus, tapi tidak membuka, kunci selama ekspor.Wajib: Ya
-out
-
Menentukan nama file tempat kunci privat yang diekspor akan ditulis.
Wajib: Ya
-m
-
Menentukan mekanisme pembungkus yang digunakan untuk membungkus kunci privat yang diekspor. Satu-satunya nilai yang valid adalah
4
, yang mewakiliNIST_AES_WRAP mechanism.
Default: 4 (
NIST_AES_WRAP
)Wajib: Tidak
-wk
-
Menentukan kunci yang akan digunakan untuk membuka kunci yang diekspor. Masukkan jalur dan nama file yang berisi kunci AES plaintext.
Bila Anda menyertakan parameter ini, exportPrivateKey menggunakan kunci dalam file
-w
untuk membungkus kunci yang diekspor dan menggunakan kunci yang ditentukan oleh parameter-wk
untuk membukanya.Default: Gunakan kunci pembungkus yang ditentukan dalam parameter
-w
untuk membungkus dan membuka.Wajib: Tidak