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

getAttribute

cloudhsm_mgmt_util 中的 getAttribute 命令可從叢集內的所有 HSM 取得金鑰的一個屬性值，並將其寫入 stdout (標準輸出) 或檔案。只有加密使用者 (CU) 可以執行此命令。

金鑰屬性是金鑰的屬性。其中包括的特性，例如金鑰類型、類別、標籤和 ID，以及代表您可對金鑰執行之動作的值，例如加密、解密、包裝、取消包裝和驗證。

您只可以對您擁有的金鑰和與您共用的金鑰使用 getAttribute。您可以執行此命令或 key_mgmt_util 中的 getAttribute 命令，將金鑰的一個或所有屬性值寫入檔案。

若要取得屬性的清單和代表它們的常數，請使用 listAttributes 命令。若要變更現有金鑰的屬性值，請使用 key_mgmt_util 中的 setAttribute 和 cloudhsm_mgmt_util 中的 setAttribute。如需金錀屬性的解譯說明，請參閱 金錀屬性參考。

啟動 CMU 並登入 HSM 後，方可執行任何 CMU 命令。請確認您所登入的使用者帳戶類型能夠執行您要使用的命令。

如果您新增或刪除 HSM，請更新 CMU 的組態檔案。否則，您所進行的變更可能無法在叢集中的所有 HSM 上生效。

使用者類型

下列使用者可以執行此命令。

語法

因為此命令未指明具體參數，所以您須依照語法圖表中指定的順序輸入引數。

getAttribute <key handle> <attribute id> [<filename>]

範例

此範例在 HSM 中取得金鑰之可擷取屬性的值。您可以使用如下命令，以判斷您是否可以從 HSM 匯出金鑰。

第一個命令使用 listAttributes，以尋找代表可擷取之屬性的常數。輸出顯示 OBJ_ATTR_EXTRACTABLE 的常數是 354。您也可以在金錀屬性參考中找到這項資訊以及屬性和其值的描述。

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
    

第二個命令使用 getAttribute，在 HSM 中取得金鑰 (金鑰控點為 262170) 之可擷取屬性的值。為了指定可擷取屬性，此命令使用 354，這是代表屬性的常數。因為此命令未指定檔案名稱，所以 getAttribute 會將輸出寫入 stdout。

輸出顯示在所有 HSM 上，可擷取之屬性的值都是 1。這個值表示金鑰擁有者可以匯出金鑰。當值為 0 (0x0) 時，表示無法從 HSM 匯出金鑰。您在建立金鑰時會設定可擷取屬性的值，但無法變更。

aws-cloudhsm> getAttribute 262170 354

Attribute Value on server 0(10.0.1.10):
OBJ_ATTR_EXTRACTABLE
0x00000001

Attribute Value on server 1(10.0.1.12):
OBJ_ATTR_EXTRACTABLE
0x00000001

Attribute Value on server 2(10.0.1.7):
OBJ_ATTR_EXTRACTABLE
0x00000001

引數

因為此命令未指明具體參數，所以您須依照語法圖表中指定的順序輸入引數。

getAttribute <key handle> <attribute id> [<filename>]

相關主題