audit init

Home >	LunaSH Command Reference Guide > LunaSH Commands > audit > audit init

audit init

Initialize the Audit role. The audit init command is available only to the audit user of the HSM appliance and initializes the Audit role on the HSM. This command attaches an audit domain and a role password for password-authenticated HSMs, and creates a white Audit PED key for PED-authenticated HSMs. For PED-auth HSMs audit init also creates an audit domain, or receives an existing domain, so that selected HSMs are able to validate each others' HSM audit log files.

Note: Because this command destroys any existing Audit role on the HSM, the user is asked to “proceed” unless the -force switch is provided at the command line.

Syntax

audit init [-serial <serialnum>] [-domain <auditdomain>] [-defaultdomain] [-password <password>] [-force]

(Option)	Parameter	Description
-defaultdomain	-de	Specifies that the default domain string is to be used as key cloning domain for the HSM. Using the default domain implies that the HSM can be used in HSM Audit Log file validation operations with any other HSM in the world that retains the default domain - retaining the default domain is not recommended. This option is deprecated and will be discontinued in a future release. -defaultdomain and -domain are mutually exclusive -defaultdomain is ignored for PED-authenticated HSMs
-domain	-do	Specifies the string to be used as key cloning domain for the HSM. If no value is given for a SafeNet HSM with Password Authentication, you are prompted interactively. -defaultdomain and -domain are mutually exclusive -domain is ignored for PED-authenticated HSMs
-force	-f	Force the action without prompting.
-password	-p	Specifies the current password for the HSM Audit role. If you do not use this parameter, you are prompted for the password. This parameter applies to password-authenticated HSMs only.
-serial	-s	Specifies the serial number of the HSM. This option allows the system to distinguish between two connected HSMs, as might occur with a PKI bundle configuration (secondary USB-attached SafeNet USB HSM).

Example

[mypwlunasa] lunash:>audit init

        The AUDIT role will be initialized.

        Are you sure you wish to continue?


        Type proceed to continue, or quit to quit now -> proceed

  Please enter a domain to use for initializing the Audit role:
  > ********

  Please re-enter domain to confirm:
  > ********

  Please enter the password:
  > ********

  Please re-enter password to confirm:
  > ********


Command Result : 0 (Success)

Note: For PED-authenticated HSMs, after you type "proceed" you are referred to the PED (which must be connected and 'Awaiting command...') which prompts you for domain (red PED Key) and Audit authentication (white PED Key).