hsm ped connect
Connect to a remote PED. This command instructs PedClient to attempt to connect to the Remote PED Server at the IP address and port specified on the command line, or configured using the hsm ped set command. See hsm ped set for more information.
Behavior when defaults are configured using hsm ped set
The hsm ped set command allows you to configure a default IP address and/or port for the Remote PED Server. These values are used if they are not specified when you issue the hsm ped connect command. The behavior of the hsm ped connect command when defaults are configured using hsm ped set is as follows:
| Values set with hsm ped set |
Parameters specified by hsm ped connect |
IP address used | Port used |
|---|---|---|---|
| IP address and port | None | IP address configured with hsm ped set. | Port configured with hsm ped set. |
| IP address | IP address specified by hsm ped connect | Port configured with hsm ped set. | |
| Port | IP address configured with hsm ped set. | Port specified by hsm ped connect | |
| IP address and port | IP address specified by hsm ped connect | Port specified by hsm ped connect | |
| IP address only | None | IP address configured with hsm ped set. | Port 1503 (default). |
| IP address | IP address specified by hsm ped connect | Port 1503 (default). | |
| Port | IP address configured with hsm ped set. | Port specified by hsm ped connect. | |
| IP address and port | IP address specified by hsm ped connect | Port specified by hsm ped connect. | |
| Port only | None | Error. You must use the -ip parameter to specify an IP address. | Port configured with hsm ped set. |
| IP address | IP address specified by hsm ped connect | Port configured with hsm ped set. | |
| Port | Error. You must use the -ip parameter to specify an IP address.. | Port specified by hsm ped connect | |
| IP address and port | IP address specified by hsm ped connect | Port specified by hsm ped connect |
Behavior when no defaults are configured using hsm ped set
If no defaults are configured using hsm ped set, you must specify at least an IP address. If no port is specified, the default port (1503) is used.
NOTE To set up or erase a PED vector, or to make or break the Remote PED connection, on an HSM that is externally connected to the SafeNet Luna Network HSM, use the "-serial" option to specify the target HSM. If "-serial" is not specified, then the command acts on the SafeNet Luna Network HSM's internal HSM card.
User Privileges
Users with the following privileges can perform this command:
>Admin
>Operator
Syntax
hsm ped connect [-ip <ip_address>] [-port <port>] [-serial <serial_num>] [-force]
| Argument(s) | Shortcut | Description |
|---|---|---|
| -force | -f | Force the action without prompting. |
| -ip <ip_address> | -i | Specifies the IP Address of the PED |
| -port <port> | -p |
Network Port (0-65535). Default: 1503 |
| -serial <serial_num> | -s | Token Serial Number |
Example
lunash:>hsm ped connect Luna PED operation required to connect to Remote PED - use orange PED key(s). Command Result : 0 (Success)
