SCP and PSCP
Use the scp (Linux/Unix) or pscp (Windows) command to securely move updates and certificates and other files from a source computer onto the SafeNet appliance, or to move appliance certificates or log files out to a client computer.
All packages from SafeNet are signed and encrypted and come with an authorization code (authcode) that must be provided to decrypt and use the package.
Syntax
Client to appliance
scp [options] [<user>@]<host/IP>:<source> <target>
Appliance to client
scp [options] <source> [<source>...] [<user>@]<host/IP>:<target>
List files on the appliance
scp [options] -ls <user>@<host/IP>:<file_path>
NOTE When using scp or pscp over an IPv6 network, enclose addresses in square brackets.
Argument(s) | Description |
---|---|
-p | Preserve file attributes. |
-q | Quiet -- do not show statistics. |
-r | Copy directories recursively. |
-S <path_to_SSH> | Specify the location of SSH. |
-v | Show verbose messages. |
-P <port> | Connect to the specified port. |
-pw <password> | Login with specified password. |
-unsafe | Allow server-side wildcards (dangerous). |
Examples
The following examples illustrate how to transfer files from a SafeNet Luna HSM Client to a SafeNet Luna Network HSM, and from a SafeNet Luna Network HSM to a SafeNet Luna HSM Client.
Transferring a file from a SafeNet Luna HSM Client to a SafeNet Luna Network HSM
/usr/safenet/lunaclient/>scp test-file.txt admin@myluna: admin@myluna's password: ******** test-file.txt | 0 kB | 0.1 kB/s | ETA: 00:00:00 | 100% /usr/safenet/lunaclient/>
The colon is required. Type nothing after the colon when moving files onto
the SafeNet appliance. All files that are scp’d to the SafeNet appliance go
to a predetermined directory, which you cannot change (for security reasons).
While it is possible to change the filename during scp (by typing a new
filename after the colon in the scp command), this is not recommended
since most operations expect certain filenames and can fail if those are
not found.
/usr/safenet/lunaclient/>scp test-file.txt admin@myluna:different-file.txt admin@myluna's password: ******** test-file.txt | 0 kB | 0.1 kB/s | ETA: 00:00:00 | 100% /usr/safenet/lunaclient/>
If the arriving file carries an unexpected name, it might not be handled correctly by subsequent commands.
If you have SSH located in a non-standard (UNIX) location, launch the scp command with the "-S" option (that's an uppercase "s"), followed by the path to SSH, before supplying the paths to the source and target files, like:
scp -S /usr/bin/ssh <source file> <dest file>
Transferring a file from a SafeNet Luna Network HSM to a SafeNet Luna HSM Client
bash-2.05# scp admin@myLuna3:server.pem . admin@myLuna3's password: ********* server.pem 100% |*******************************************************| 928 00:0
Note the dot (.) at the end of the command, denoting “place the resulting file in the current directory”.