keyExecute (Command)
  • 19 Dec 2024
  • 2 Minutes à lire
  • Sombre
    Lumière
  • PDF

keyExecute (Command)

  • Sombre
    Lumière
  • PDF

The content is currently unavailable in French. You are viewing the default English version.
Résumé de l’article

The keyExecute command executes cryptographic key–related administrative operations.

  Table: keyExecute commands
CommandDescription
KEYCMD_CREATECreates a new key (see  KEYCMD_CREATE).
KEYCMD_DELETEDeletes a key (see  KEYCMD_DELETE).
KEYCMD_QUERY_STATUSQueries the status of a key rotation operation currently in progress (see  KEYCMD_ROTATE_STATUS).
KEYCMD_ROTATE_ABORTAborts a key rotation operation currently in progress (see  KEYCMD_ROTATE_ABORT).
KEYCMD_ROTATE_KEYRotates a key (see  KEYCMD_ROTATE_KEY).
KEYCMD_UPDATEUpdates a key (see  KEYCMD_UPDATE).
KEYCMD_VIEWRetrieves the settings of the specified key (see  KEYCMD_VIEW).

The following field attributes are available for the operations of this command:

  Table: keyExecute field attributes
Attribute nameData typeDescription
KEYFLD_CACHE_IDStringKey cache ID
KEYFLD_CREATE_TIMEDatetimeThe date and time the data record was created.
KEYFLD_CRYPTO_ALGOString

The cryptographic algorithm to use.

Possible values:

  • AES-256-CBC
  • AES-256-CFB
  • AES-128-CBC
  • AES-128-CBC-2
  • BF-CFB
  • CAST5-CFG
  • DES-EDE3-CFB
  • DES-EDE-CFB
KEYFLD_CRYPTO_TYPEString

The type of cryptography used by the key.

Possible values:

  • HSM – Safenet
  • SSM
KEYFLD_DEFAULT_KEYBooleanIndicates whether this is the default key.
KEYFLD_DESCRIPTIONStringKey description.
KEYFLD_KCVStringThe key check value (KCV) used for hardware security module (HSM) keys.
KEYFLD_KEY_IDStringThe cryptographic key identifier.
KEYFLD_KEY_LABELStringThe HSM key label.
KEYFLD_LEGACY_MODEBoolean 
KEYFLD_MODIFY_TIMEDateTimeThe date and time the data record was last modified.
KEYFLD_NCIPHER_KEYHASHString 
KEYFLD_NOTIFYString

Notification method.

Possible values:

  • Email
  • SMS
KEYFLD_ROTATE_ELAPSED_TIMEIntegerElapsed time of last rotation for this key.
KEYFLD_ROTATE_FAILEDIntegerThe number of records where the key rotation failed.
KEYFLD_ROTATE_FOUND_TOTALIntegerThe total number of records found for the key rotation.
KEYFLD_ROTATE_SUCCESSIntegerThe number of records where the key rotation completed successfully.
KEYFLD_SCHEDULEBooleanIndicates whether the key rotation is scheduled.
KEYFLD_SCHEDULE_DATEStringScheduled date.
KEYFLD_SCHEDULE_TIMEStringScheduled time.
KEYFLD_SLOT_IDIntegerThe HSM slot ID.
KEYFLD_TOKEN_LABELStringThe HSM token label.
KEYFLD_TOKEN_PINStringThe HSM token PIN used to access the token.
KEYFLD_USAGEString

Specifies the data that the key is used to encrypt.

Possible values:

  • Storage Data
  • Sensitive Data
KEYFLD_VALUEStringThe software security module (SSM) key value (hexadecimal).

KEYCMD_VIEW

Only the KEYFLD_KEY_ID attribute can be specified in the attribute set input parameter of this command.

The following attributes will be specified in the results output parameter of this command:

  Table: KEYCMD_VIEW (Supported output attributes)
Attribute nameReturned
KEYFLD_CREATE_TIME 
KEYFLD_CRYPTO_ALGO 
KEYFLD_CRYPTO_TYPE 
KEYFLD_DEFAULT_KEY 
KEYFLD_DESCRIPTION 
KEYFLD_KCV 
KEYFLD_KEY_ID 
KEYFLD_KEY_LABEL 
KEYFLD_MODIFY_TIME 
KEYFLD_SLOT_ID 
KEYFLD_TOKEN_LABEL 
KEYFLD_USAGE 

KEYCMD_CREATE

The following attributes can be specified in the attributeSet input parameter of this command:

  Table: KEYCMD_CREATE (Supported input attributes)
Attribute nameOptionality
KEYFLD_CRYPTO_ALGO 
KEYFLD_CRYPTO_TYPE 
KEYFLD_DESCRIPTION 
KEYFLD_KCV 
KEYFLD_KEY_ID 
KEYFLD_KEY_LABEL 
KEYFLD_SLOT_ID 
KEYFLD_TOKEN_LABEL 
KEYFLD_TOKEN_PIN 
KEYFLD_USAGE 
KEYFLD_VALUE 

The following attributes will be specified in the results output parameter of this command:

  Table: KEYCMD_CREATE (Supported output attributes)
Attribute nameReturned
KEYFLD_CRYPTO_ALGO 
KEYFLD_CRYPTO_TYPE 
KEYFLD_DEFAULT_KEY 
KEYFLD_DESCRIPTION 
KEYFLD_KCV 
KEYFLD_KEY_ID 
KEYFLD_KEY_LABEL 
KEYFLD_SLOT_ID 
KEYFLD_TOKEN_LABEL 
KEYFLD_USAGE 

KEYCMD_DELETE

Only the KEYFLD_KEY_ID attribute can be specified in the attribute set input parameter of this command.

This command returns no result attributes.

KEYCMD_UPDATE

The following attributes can be specified in the attributeSet input parameter of this command:

  Table: KEYCMD_UPDATE (Supported input attributes)
Attribute nameOptionality
KEYFLD_DESCRIPTION


KEYFLD_KEY_IDMandatory

The following attributes will be specified in the results output parameter of this command:

  Table: KEYCMD_UPDATE (Supported output attributes)
Attribute nameReturned
KEYFLD_CRYPTO_ALGO 
KEYFLD_CRYPTO_TYPE 
KEYFLD_DESCRIPTION 
KEYFLD_KCV 
KEYFLD_KEY_ID 
KEYFLD_KEY_LABEL 
KEYFLD_LEGACY_MODE 
KEYFLD_SLOT_ID 
KEYFLD_TOKEN_LABEL 
KEYFLD_USAGE 
KEYFLD_VALUE 

KEYCMD_ROTATE_KEY

The following attributes can be specified in the attributeSet input parameter of this command:

  Table: KEYCMD_ROTATE_KEY (Supported input attributes)
Attribute nameOptionality
KEYFLD_KEY_ID 
KEYFLD_SCHEDULE 
KEYFLD_SCHEDULE_DATE 
KEYFLD_SCHEDULE_NOTIFY 
KEYFLD_SCHEDULE_TIME 
KEYFLD_TOKEN_LABEL 
KEYFLD_USAGE 

The following attributes will be specified in the results output parameter of this command:

  Table: KEYCMD_ROTATE_KEY (Supported output attributes)
Attribute nameReturned
KEYFLD_CHACHE_ID 
KEYFLD_ROTATE_FOUND_TOTAL 

KEYCMD_ROTATE_ABORT

Only the KEYFLD_CACHE_ID attribute can be specified in the attribute set input parameter of this command.

This command returns no result attributes.

KEYCMD_ROTATE_STATUS

Only the KEYFLD_CACHE_ID attribute can be specified in the attribute set input parameter of this command.

The following attributes will be specified in the results output parameter of this command:

  Table: KEYCMD_ROTATE_STATE (Supported output attributes)
Attribute nameReturned
KEYFLD_ELAPSED_TIME 
KEYFLD_ROTATE_FAILED 
KEYFLD_ROTATE_SUCCESS 

Cet article vous a-t-il été utile ?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, facilitant la découverte de connaissances grâce à l’intelligence conversationnelle