Error2String

key_mgmt_util の Error2String helper コマンドは、key_mgmt_util の 16 進エラーコードに対応するエラーを返します。このコマンドは、コマンドとスクリプトのトラブルシューティングに使用できます。

key_mgmt_util コマンドを実行する前に、key_mgmt_util を起動し、Crypto User (CU) として HSM に ログインする 必要があります。

Syntax

Error2String -h

Error2String -r <response-code>

例

これらの例は、key_mgmt_util エラーコードのエラー文字列を取得するために Error2String を使用する方法を示しています。

例 : エラーの説明を取得する

次のコマンドでは、0xdb エラーコードに関するエラーの説明を取得します。説明では、ユーザーがユーザータイプを間違えたため、key_mgmt_util へのログインに失敗したとなります。key_mgmt_util にログインできるのは暗号ユーザー (CU) のみです。

        Command:  Error2String -r 0xdb
        
        Error Code db maps to HSM Error: Invalid User Type.

例 : エラーコードを見つける

この例は、key_mgmt_util エラーのエラーコードの場所を示しています。エラーコード 0xc6 は、文字列 Cfm3command-name returned: の後に表示されます。

この例では、 は現在のユーザー (ユーザー 4) が暗号化オペレーションで キーを使用できるgetKeyInfoことを示します。その場合でも、ユーザーが deleteKey を使用してキーを削除しようとすると、コマンドはエラーコード 0xc6 を返します。

        Command:  deleteKey -k 262162

        Cfm3DeleteKey returned: 0xc6 : HSM Error: Key Access is denied

        Cluster Error Status

        Command:  getKeyInfo -k 262162
        
        Cfm3GetKey returned: 0x00 : HSM Return: SUCCESS

       Owned by user 3

       also, shared to following 1 user(s):

                4
        

0xc6 エラーが返された場合は、次のような Error2String コマンドを使用してエラーを検索できます。この例で deleteKey コマンドが失敗しているのは、現在のユーザーがキーを共有していても、キーの所有者が別のユーザーであるために、アクセス拒否エラーとなるためです。キーを削除できるのはキーの所有者のみです。

        Command:  Error2String -r 0xa8
        
        Error Code c6 maps to HSM Error: Key Access is denied      

パラメータ

-h

コマンドに関するヘルプを表示します。

必須: はい

-r

16 進数のエラーコードを指定します。16 進数インジケータ 0x は必須です。

必須: はい