cimauth(8) cimauth(8)

NAME cimauth - add, modify, remove, or list CIM namespace authorizations of users

SYNOPSIS cimauth -a -u username -n namespace [ -R ] [ -W ]

cimauth -m -u username -n namespace [ -R ] [ -W ]

cimauth -r -u username [ -n namespace ]

cimauth -l

cimauth -h

cimauth --help

cimauth --version

DESCRIPTION The cimauth command manages read and write CIM namespace authorizations of users. The operations are executed on the local host by submitting requests to the CIM Server. If the value of the configuration property enableNamespaceAuthorization is True , the CIM Server restricts access to namespaces based on user authorizations configured via cimauth . Changes to "Dynamic" authorization parameters does not require the CIM Server to be restarted. "Non Dynamic" configuration properties (E.g. enableNamespaceAuthorization ) can only be set as planned configuration and the CIM Server needs to be restarted to realize the change. (See cimconfig (8) for information on configuring the CIM Server.)

Options The cimauth command recognizes the following options:

-a Adds read and/or write authorizations to the specified user on the specified namespace. If neither the -R nor the -W option is specified, adds a read authorization by default.

-h, --help Display command usage information.

-l Lists all the authorizations configured in the CIM Server.

-m Modifies authorizations of the specified user on the specified namespace. If neither the -R nor the -W option is specified, modifies the autho- rization to be a read authorization by default.

-n namespace Specifies the R namespace for the operation.

-r Removes authorizations of the specified user on the specified namespace. If no namespaces are specified, removes authorizations on all names- paces for the specified user.

-R Specifies read authorization on the namespace.

-u username Specifies the user for the operation. The speci- fied R username must represent a valid user on the local host.

--version Display CIM Server version number.

-W Specifies write authorization on the namespace.

EXIT STATUS When an error occurs, an error message is written to stderr and an error value of 1 is returned. The following return values are returned:

0 Successful completion 1 Error

USAGE NOTE The cimauth command requires that the CIM Server is running.

EXAMPLES Add read authorizations to user "guest" on namespace "root/cimv2".

cimauth -a -u guest -n root/cimv2 -R

Add read and write authorizations to user "guest" on namespace "root/system".

cimauth -a -u guest -n root/system -R -W

Modify authorizations of the user "guest" on namespace "root/system" to read only.

cimauth -m -u guest -n root/system -R

Remove the authorizations of the user "guest" on namespace "root/sys- tem".

cimauth -r -u guest -n root/system

List all the authorizations configured in the CIM Server.

cimauth -l

SEE ALSO cimserver(8), cimconfig(8).

cimauth(8)