Error2String

Der Error2String-Hilfsbefehl in key_mgmt_util gibt den Fehler zurück, der einem hexadezimalen Fehlercode von key_mgmt_util entspricht. Verwenden Sie diesen Befehl bei der Fehlerbehebung von Befehlen und Skripten.

Bevor Sie einen key_mgmt_util-Befehl ausführen, müssen Sie key_mgmt_util starten und sich am HSM als Crypto-Benutzer (CU) anmelden.

Syntax

Error2String -h

Error2String -r <response-code>

Beispiele

Diese Beispiele zeigen, wie Sie mit Error2String den Fehlerstring für einen key_mgmt_util-Fehlercode abrufen können.

Beispiel ; Anfordern einer Fehlerbeschreibung

Dieser Befehl ruft die Fehlerbeschreibung für den 0xdb-Fehlercode auf. Die Beschreibung erklärt, dass ein Anmeldeversuch bei key_mgmt_util fehlgeschlagen ist, da der Benutzer nicht über den richtigen Benutzertypen verfügt. Nur Crypto-Benutzer (CU) können sich bei key_mgmt_util anmelden.

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

Beispiel : Finden des Fehlercodes

Dieses Beispiel zeigt, wo der Fehlercode in einem key_mgmt_util-Fehler gefunden werden kann. Der Fehlercode 0xc6 wird nach der Zeichenfolge angezeigt: Cfm3command-name returned: .

getKeyInfoZeigt in diesem Beispiel an, dass der aktuelle Benutzer (Benutzer 4) den Schlüssel für kryptografische Operationen verwenden kann. Wenn der Benutzer jedoch deleteKey verwendet, um den Schlüssel zu löschen, gibt der Befehl den Fehlercode 0xc6 zurück.

        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
        

Wen Ihnen der Fehler 0xc6 zurückgegeben wird, können Sie einen Error2String-Befehl wie diesen verwenden, um den Fehler nachzuschlagen. In diesem Fall schlug der Befehl deleteKey aufgrund eines „Zugriff verweigert“-Fehlers fehl, da der Schlüssel für den aktuellen Benutzer freigegeben wurde, der Eigentümer aber ein anderer Benutzer ist. Nur die Eigentümer eines Schlüssels haben die Berechtigung, einen Schlüssel zu löschen.

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

Parameter

-h

Zeigt Hilfe für den Befehl an.

Erforderlich: Ja

-r

Gibt einen hexadezimalen Fehlercode an. Die hexadezimalen Anzeige 0x ist erforderlich.

Erforderlich: Ja