翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS CloudHSM KMU のキー属性リファレンス
<a name="key-attribute-table"></a>

 AWS CloudHSM key\_mgmt\_util コマンドは定数を使用して、ハードウェアセキュリティモジュール (HSM) 内のキーの属性を表します。このトピックは、属性の識別、コマンドでその属性を表す定数の検索、およびその値の理解に役立ちます。

キーの作成時に、キー属性を設定します。キーが永続的であるかセッションにのみ存在するかを示すトークン属性を変更するには、key\_mgmt\_utilの [setAttribute](key_mgmt_util-setAttribute.md) コマンドを使用します。ラベルを変更、属性をラップ、アンラップ、暗号化、または復号化するには、cloudhsm\_mgmt\_util の `setAttribute`コマンドを使用します。

属性とその定数のリストを取得するには、[listAttributes](key_mgmt_util-listAttributes.md) を使用します。キーの属性値を取得するには、[getAttribute](key_mgmt_util-getAttribute.md) を使用します。

次の表に、キーの属性、その定数、および有効な値を示します。


| 属性 | 定数 | 値 | 
| --- | --- | --- | 
| OBJ\_ATTR\_ALL | 512 | すべての属性を表します。 | 
| OBJ\_ATTR\_ALWAYS\_SENSITIVE | 357 | **0**: False。<br />**1**: True。 | 
| OBJ\_ATTR\_CLASS | 0 | **2** : 公開 - プライベートキーのキーペアの公開キー。3 : 公開 - プライベートキーのキーペアの公開キー。<br />**4**: シークレット (対称) キー。 | 
| OBJ\_ATTR\_DECRYPT | 261 | **0**: False。<br />**1**: True。キーはデータの復号に使用できます。 | 
| OBJ\_ATTR\_DERIVE | 268 | **0**: False。<br />**1**: True。この関数は、キーを派生させます。 | 
| OBJ\_ATTR\_DESTROYABLE | 370 | **0**: False。<br />**1**: True。 | 
| OBJ\_ATTR\_ENCRYPT | 260 | **0**: False。<br />**1**: True。キーはデータの暗号化に使用できます。 | 
| OBJ\_ATTR\_EXTRACTABLE | 354 | **0**: False。<br />**1**: True。キーは HSM からエクスポートできます。 | 
| OBJ\_ATTR\_ID | 258 | ユーザー定義の文字列。クラスター内で一意である必要があります。デフォルトは空の文字列です。 | 
| OBJ\_ATTR\_KCV | 371 | キーのキーチェック値。詳細については、「[その他の詳細](#key-attribute-table-details)」を参照してください。 | 
| OBJ\_ATTR\_KEY\_TYPE | 256 | **0**: RSA。<br />**1**: DSA。<br />**3**: EC。<br />**16**: 汎用秘密。<br />**18**: RC4。<br />**21**: Triple DES (3DES)。<br />**31**: AES。 | 
| OBJ\_ATTR\_LABEL | 3 | ユーザー定義の文字列。クラスター内で一意である必要はありません。 | 
| OBJ\_ATTR\_LOCAL | 355 | **0**. False。キーは HSM にインポートされました。<br />**1**: True。 | 
| OBJ\_ATTR\_MODULUS | 288 | RSA キーペアを生成するために使用されたモジュラス。EC キーの場合、この値は ANSI X9.62 ECPoint 値「Q」の DER エンコーディングを 16 進数形式で表します。<br />他のキータイプの場合、この属性は存在しません。 | 
| OBJ\_ATTR\_MODULUS\_BITS | 289 | RSA キーペアを生成するために使用されたモジュラスの長さ。EC キーの場合、これはキーの生成に使用された楕円曲線の ID を表します。<br />他のキータイプの場合、この属性は存在しません。 | 
| OBJ\_ATTR\_NEVER\_EXTRACTABLE | 356 | **0**: False。<br />**1**: True。このキーは HSM からエクスポートできません。 | 
| OBJ\_ATTR\_PUBLIC\_EXPONENT | 290 | RSA キーペアを生成するために使用された公開指数。<br />他のキータイプの場合、この属性は存在しません。 | 
| OBJ\_ATTR\_PRIVATE | 2 | **0**: False。<br />**1**: True。この属性は、認証されていないユーザーがキーの属性を表示できるかどうかを示します。CloudHSM PKCS\#11 プロバイダーでは、現在パブリックセッションはサポートされていないため、すべてのキー (パブリックキーとプライベートキーのペアのパブリックキーを含む) のこの属性は 1 に設定されています。 | 
| OBJ\_ATTR\_SENSITIVE | 259 | **0**: False。公開 - プライベートキーのキーペアの公開キー。<br />**1**: True。 | 
| OBJ\_ATTR\_SIGN | 264 | **0**: False。<br />**1**: True。キーは署名 (プライベートキー) に使用できます。 | 
| OBJ\_ATTR\_TOKEN | 1 | **0**: False。セッションキー。<br />**1**: True。永続キー。 | 
| OBJ\_ATTR\_TRUSTED | 134 | **0**: False。<br />**1**: True。 | 
| OBJ\_ATTR\_UNWRAP | 263 | **0**: False。<br />**1**: True。キーはキーの復号に使用できます。 | 
| OBJ\_ATTR\_UNWRAP\_TEMPLATE | 1073742354 | 値は、このラッピングキーを使用してラップ解除されたキーに適用される属性テンプレートを使用する必要があります。 | 
| OBJ\_ATTR\_VALUE\_LEN | 353 | キーの長さ (バイト単位) | 
| OBJ\_ATTR\_VERIFY | 266 | **0**: False。<br />**1**: True。キーは検証 (パブリックキー) に使用できます。 | 
| OBJ\_ATTR\_WRAP | 262 | **0**: False。<br />**1**: True。キーはキーの暗号化に使用できます。 | 
| OBJ\_ATTR\_WRAP\_TEMPLATE | 1073742353 | 値は、属性テンプレートを使用し、このラッピングキーでラップされたキーと一致させる必要があります。 | 
| OBJ\_ATTR\_WRAP\_WITH\_TRUSTED | 528 | **0**: False。<br />**1**: True。 | 

## その他の詳細
<a name="key-attribute-table-details"></a>

**キーチェック値 (KCV)。**  
*キーチェック値* (KCV) は、HSM がキーをインポートまたは生成するときに生成されるキーの 3 バイトのハッシュまたはチェックサムです。キーをエクスポートした後など、HSM の外部で KCV を計算することもできます。次に、KCV 値を比較して、キーのアイデンティティと整合性を確認できます。キーの KCV を取得するには、[getAttribute](key_mgmt_util-getAttribute.md) を使用します。  
AWS CloudHSM は、次の標準メソッドを使用してキーチェック値を生成します。  
+ **対称キー**: ゼロブロックをキーで暗号化した結果の最初の 3 バイト。
+ **非対称キーペア**: 公開キーの SHA-1 ハッシュの最初の 3 バイト。
+ **HMAC キー**: 現時点では HMAC キーの KCV はサポートされていません。