CloudHSM CLI 的金鑰屬性 - AWS CloudHSM

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

CloudHSM CLI 的金鑰屬性

本主題旨在說明如何使用 CloudHSM CLI 設定金鑰屬性。CloudHSM CLI 中的金鑰屬性可以定義金鑰的類型、金鑰的運作方式或金鑰的標記方式。某些屬性定義唯一的特性 (例如,金鑰的類型)。其他屬性可以設定為 true 或 false (變更它們會啟動或停用金鑰功能的一部分)。

如需展示如何使用金鑰屬性的範例,請參閱父命令 金錀 下列出的命令。

支援的屬性

最佳實務是,只為您希望更具有限制性的屬性設定值。如果您未指定值,CloudHSM CLI 會使用下表中指定的預設值。

下表列出金鑰屬性、可能值、預設值及相關註記。欄位中的空白儲存格表示屬性沒有獲派指定預設值。

CloudHSM CLI屬性 Value 可以使用密鑰集屬性進行修改 可在建立金鑰時設定
always-sensitive

如果 sensitive 一直被設置為 True 並且從未更改過,则該值是 True

check-value 金鑰的金鑰檢查值。如需詳細資訊,請參閱其他詳細資訊
class

可能的值:secret-keypublic-keyprivate-key

curve

用於產生 EC 金鑰對的橢圓曲線。

有效值:secp224r1secp256r1prime256v1secp384r1secp256k1secp521r1

可使用 RSA 設定,而無法使用 EC 進行設定
decrypt

預設:False

derive

預設:False

destroyable

預設:True

ec-point

如果是 EC 金鑰,則以十六進位格式對 ANSI X9.62 ECPoint 值「Q」進行 DER 編碼。

對於其他金鑰類型,這個屬性不存在。

encrypt

預設:False

extractable

預設:True

id 預設值:空
key-length-bytes

產生 AES 密鑰所需。

有效值:162432 位元組。

key-type

可能的值:aesrsaec

label 預設值:空
local

預設值:True 適用於在 HSM 中產生的金鑰,False 適用於匯入至 HSM 的金鑰。

modifiable

預設:True

modulus 用於產生 RSA 金鑰對的模數。對於其他金鑰類型,這個屬性不存在。
modulus-size-bits

產生 RSA 金鑰對時需要。

最小值為 2048

可使用 RSA 設定,而無法使用 EC 進行設定
never-extractable

如果可擷取值從未設置為 False,則該值為 True

如果可擷取值已被設置為 True,則該值為 False

private

預設:True

public-exponent

產生 RSA 金鑰對時需要。

有效值:值必須為大於或等於 65537 的奇數。

可使用 RSA 設定,而無法使用 EC 進行設定
sensitive

預設:

  • 此值為 True,適用於 AES 金鑰以及 EC 和 RSA 私有金鑰。

  • 此值為 False,適用於 EC 和 RSA 公有金鑰。

可使用私有金鑰設定,而不能使用公有金鑰設定。
sign

預設:

  • 此值為 True,適用於 AES 金鑰。

  • 此值為 False,適用於 RSA 和 EC 金鑰。

token

預設:False

trusted

預設:False

unwrap 預設:False
unwrap-template 這些值應使用已套用於以此包裝金鑰取消包裝之任何金鑰的屬性範本。
verify

預設:

  • 此值為 True,適用於 AES 金鑰。

  • 此值為 False,適用於 RSA 和 EC 金鑰。

wrap 預設:False
wrap-template 這些值應使用屬性範本來匹配使用此包裝金鑰所包裝的金鑰。
wrap-with-trusted

預設:False

其他詳細資訊

檢查值

檢查值是 HSM 匯入或產生金鑰時所產生之金鑰的 3 位元組雜湊或總和檢查碼。您也可以在 HSM 之外計算檢查值,例如在匯出金鑰之後。然後,您可以比較檢查值以確認金鑰的身分和完整性。如需獲取金鑰的檢查值,請使用帶有詳細標誌的金鑰列表

AWS CloudHSM 使用下列標準方法來產生檢查值:

  • 對稱密鑰:使用金鑰加密零塊的結果的前 3 個位元組。

  • 非對稱金鑰配對:公有金鑰 SHA-1 雜湊的前 3 個位元組。

  • HMAC 金鑰:目前不支援 HMAC 金鑰的 KCV。

相關主題