user role import

Home >	LunaSH Command Reference Guide > LunaSH Commands > user > user role import

user role import

Import a role description or definition from a file.

A role definition file is a UNIX-format file containing a list of lunash commands that are allowed for the role, for example:

exit
help
hsm init
hsm login
hsm logout
hsm show
my file list
partition create ... etc.

All lines must end with a UNIX-style linefeed (lf) character - if you create your file in Windows, be sure to convert before sending to an HSM appliance.

When the definition is applied to a named role, that role will have access ONLY to commands that are named in the file. Each Custom User Role definition file is secure-copied to the "admin" user space on the target HSM appliance (scp <your custom role file> admin@<your LunaSA>:).

The system does not pre-detect the purpose of the file, so it is up to you to name your role definition files usefully, and to recognize them when you import them via Lunash user role import -file somefilename -role somerolename command.

Syntax

user role import -file <filename> -role <rolename>

Option	Shortcut	Parameter	Description
-file	-f	<filename>	Name of the file being imported, containing a role definition.
-role	-r	<rolename string>	The name of the administrative role for which a description file is being imported.

Example

lunash:>user role import -file rolefile1 -role indigo

"rolefile1" was successfully imported. 

Command Result : 0 (Success)