本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 CMU 設定 AWS CloudHSM 金鑰的屬性
使用 AWS CloudHSM cloudhsm\_mgmt\_util 中的 **setAttribute**命令來變更 HSMs 中金鑰的標籤值、加密、解密、包裝和取消包裝屬性。您也可以在 key\_mgmt\_util 中使用 [setAttribute](key_mgmt_util-setAttribute.md) 命令，將工作階段金鑰轉換為持久性金鑰。您只能變更您所擁有金鑰的屬性。
啟動 CMU 並登入 HSM 後，方可執行任何 CMU 命令。請確認您所登入的使用者帳戶類型能夠執行您要使用的命令。
如果您新增或刪除 HSM，請更新 CMU 的組態檔案。否則，您所進行的變更可能無法在叢集中的所有 HSM 上生效。
## 使用者類型
下列使用者可以執行此命令。
+ 加密使用者 (CU)
## 語法
因為此命令未指明具體參數，所以您須依照語法圖表中指定的順序輸入引數。
```
setAttribute {{}} {{}}
```
## 範例
此範例說明如何停用對稱金鑰的解密功能。您可使用這樣的命令來設定包裝金鑰，該金鑰應該能夠包裝和取消包裝其他金鑰，但不能加密或解密資料。
第一步是建立包裝金鑰。此命令在 key\_mgmt\_util 中使用 [genSymKey](key_mgmt_util-genSymKey.md) 來產生 256 位元 AES 對稱金鑰。輸出顯示新金鑰的金鑰控制代碼是 14。
```
$ genSymKey -t 31 -s 32 -l aes256
Cfm3GenerateSymmetricKey returned: 0x00 : HSM Return: SUCCESS
Symmetric Key Created. Key Handle: 14
Cluster Error Status
Node id 0 and err state 0x00000000 : HSM Return: SUCCESS
```
接著，我們想要確認目前解密屬性的值。若要取得解密屬性的屬性 ID，請使用 [listAttributes](cloudhsm_mgmt_util-listAttributes.md)。輸出顯示代表 `OBJ_ATTR_DECRYPT` 屬性的常數是 `261`。如需金錀屬性的解譯說明，請參閱 [AWS CloudHSM KMU 的金鑰屬性參考](key-attribute-table.md)。
```
aws-cloudhsm> listAttributes
Following are the possible attribute values for getAttribute:
OBJ_ATTR_CLASS = 0
OBJ_ATTR_TOKEN = 1
OBJ_ATTR_PRIVATE = 2
OBJ_ATTR_LABEL = 3
OBJ_ATTR_TRUSTED = 134
OBJ_ATTR_KEY_TYPE = 256
OBJ_ATTR_ID = 258
OBJ_ATTR_SENSITIVE = 259
OBJ_ATTR_ENCRYPT = 260
OBJ_ATTR_DECRYPT = 261
OBJ_ATTR_WRAP = 262
OBJ_ATTR_UNWRAP = 263
OBJ_ATTR_SIGN = 264
OBJ_ATTR_VERIFY = 266
OBJ_ATTR_DERIVE = 268
OBJ_ATTR_LOCAL = 355
OBJ_ATTR_MODULUS = 288
OBJ_ATTR_MODULUS_BITS = 289
OBJ_ATTR_PUBLIC_EXPONENT = 290
OBJ_ATTR_VALUE_LEN = 353
OBJ_ATTR_EXTRACTABLE = 354
OBJ_ATTR_NEVER_EXTRACTABLE = 356
OBJ_ATTR_ALWAYS_SENSITIVE = 357
OBJ_ATTR_DESTROYABLE = 370
OBJ_ATTR_KCV = 371
OBJ_ATTR_WRAP_WITH_TRUSTED = 528
OBJ_ATTR_WRAP_TEMPLATE = 1073742353
OBJ_ATTR_UNWRAP_TEMPLATE = 1073742354
OBJ_ATTR_ALL = 512
```
如要取得金鑰 14 目前解密屬性的值，下一個命令會在 cloudhsm\_mgmt\_util 中使用 [getAttribute](cloudhsm_mgmt_util-getAttribute.md)。
輸出顯示在叢集的兩個 HSM 上，解密屬性的值均為 true (1)。
```
aws-cloudhsm> getAttribute 14 261
Attribute Value on server 0(10.0.0.1):
OBJ_ATTR_DECRYPT
0x00000001
Attribute Value on server 1(10.0.0.2):
OBJ_ATTR_DECRYPT
0x00000001
```
此命令使用 **setAttribute**，將金鑰 14 的解密屬性 (屬性 `261`) 的值變更為 `0`。這將停用該金鑰的解密功能。
輸出顯示該命令在叢集中的兩個 HSM 上均成功執行。
```
aws-cloudhsm> setAttribute 14 261 0
*************************CAUTION********************************
This is a CRITICAL operation, should be done on all nodes in the
cluster. AWS does NOT synchronize these changes automatically with the
nodes on which this operation is not executed or failed, please
ensure this operation is executed on all nodes in the cluster.
****************************************************************
Do you want to continue(y/n)? y
setAttribute success on server 0(10.0.0.1)
setAttribute success on server 1(10.0.0.2)
```
最後的命令會重複 **getAttribute** 命令。同樣地，執行該命令會取得金鑰 14 的解密屬性 (屬性 `261`)。
此時，輸出顯示在叢集中的兩個 HSM 上，解密屬性的值均為 false (0)。
```
aws-cloudhsm > getAttribute 14 261
Attribute Value on server 0(10.0.3.6):
OBJ_ATTR_DECRYPT
0x00000000
Attribute Value on server 1(10.0.1.7):
OBJ_ATTR_DECRYPT
0x00000000
```
## 引數
```
setAttribute {{}} {{**
指定您擁有金鑰的金鑰控制代碼。每一個命令中只能指定一個金鑰。若要取得金鑰的金鑰控制代碼，請在 key\_mgmt\_util 中使用 [findKey](key_mgmt_util-findKey.md)。如要尋找金鑰的使用者，請使用 [getKeyInfo](cloudhsm_mgmt_util-getKeyInfo.md)。
必要：是
****
指定常數，其代表您要變更的屬性。每一個命令中只能指定一個屬性。如要取得屬性及其整數值，請使用 [listAttributes](key_mgmt_util-listAttributes.md)。如需金錀屬性的解譯說明，請參閱 [AWS CloudHSM KMU 的金鑰屬性參考](key-attribute-table.md)。
有效值：
+ **3**：`OBJ_ATTR_LABEL`。
+ **134**：`OBJ_ATTR_TRUSTED`。
+ **260**：`OBJ_ATTR_ENCRYPT`。
+ **261**：`OBJ_ATTR_DECRYPT`。
+ **262**：`OBJ_ATTR_WRAP`。
+ **263**：`OBJ_ATTR_UNWRAP`。
+ **264**：`OBJ_ATTR_SIGN`。
+ **266**：`OBJ_ATTR_VERIFY`。
+ **268**：`OBJ_ATTR_DERIVE`。
+ **370**：`OBJ_ATTR_DESTROYABLE`。
+ **528**：`OBJ_ATTR_WRAP_WITH_TRUSTED`。
+ **1073742353**：`OBJ_ATTR_WRAP_TEMPLATE`。
+ **1073742354**：`OBJ_ATTR_UNWRAP_TEMPLATE`。
必要：是
## 相關主題
+ key\_mgmt\_util 中的 [setAttribute](key_mgmt_util-setAttribute.md)
+ [getAttribute](cloudhsm_mgmt_util-getAttribute.md)
+ [listAttributes](cloudhsm_mgmt_util-listAttributes.md)
+ [金錀屬性參考](key-attribute-table.md)