16.9 Command Line Utility of MFA Server

The utility mfa-server-cli can be used to configure MFA server.

16.9.1 Syntax

mfa-server-cli command [options]

mfa-server-cli --help

mfa-server-cli service-config

mfa-server-cli mfa-server [--port=<MFA server port> | --clientCertCAPath=<CA certificate path> | --enforceClientAuth=<true/false> | --mfaValidity=<Validity of MFA in minutes>]

mfa-server-cli auth-server [--authSrvHost=<AA server address> --endPointID=<id> --endPointSecret=<secret>]

mfa-server-cli policy-config [--event=<AA event name> | --eDirRepo=<eDirectory repository in AA server>]

mfa-server-cli mfa-manage [--printAllMfaSessions=yes | --deleteAllMfaSessions=yes]

mfa-server-cli logging [--logLevel=<error/warn/info/debug> | --logFilePath=<path> | --logTimeStampFormat=<format>]

mfa-server-cli service-cleanup

mfa-server-cli service-reconfig

mfa-server-cli print-config

16.9.2 MFA Server Commands and Options

service-config

Service configuration requires eDirectory tree administrator credentials. Confirm the host name to be used for the MFA server; it should match the DNS name in Apache server's default virtual host SSL certificate. Successful service configuration initializes the database and brings up the MFA server.

mfa-server

--port=<MFA server port>

The MFA server can use any port in range of 1024 to 65535. By default, MFA server uses port 3456. If the specified port number is not available, the MFA server uses the next available port.

--clientCertCAPath=<CA certificate path>

Path of CA certificate file used by MFA server to validate the client certificate of MFA agent. By default, this path is configured to use the eDirectory CA certificate.

--enforceClientAuth=<true/false>

If set to true, the validation of the client certificate presented by the MFA agent is enforced. By default, this value is true.

--mfaValidity=<Validity of MFA in minutes>

The period during which multifactor authentication (MFA) is valid for users. If the validity expires, the user is required to complete the second factor of authentication during their next login.

auth-config

--authSrvHost=<AA server address>

IP address or host name of the AA server.

--endPointID=<id>

ID of endpoint created in AA server.

--endPointSecret=<secret>

Secret of the AA endpoint.

policy-config

--event=<AA event name>

Name of the event created in AA server.

--eDirRepo=<eDirectory repository in AA server>

Name of the eDirectory repository in the AA server, which is used for multifactor authentication of the eDirectory users. If the repository name is not configured, the AA server searches for the user in every available repository. For Active Directory (AD) users, the repository name is automatically detected by CIFS, and no additional configuration is required.

mfa-manage

--printAllMfaSessions=<yes>

Lists all valid MFA sessions. Expired sessions are not listed.

--deleteAllMfaSessions=<yes>

Deletes all the MFA sessions.

logging

--logLevel=<error/warn/info/debug>

Configures the log level. Default log level is info.

--logFilePath=<path>

Log file path of the MFA server. By default, the log file path is /var/opt/novell/log/oes/mfaserver/mfaserver-<date>.log.

--logTimeStampFormat=<format>

Log message time stamp format. By default, the time format is YYYY-MM-DD HH:mm:ss.

service-cleanup

Reverts the service configuration and stops the MFA server.

service-reconfig

Reconfigure the MFA server after a service cleanup. eDirectory administrator credentials are not required while reconfiguring an MFA server. Confirm the hostname for the MFA server.

print-config

Prints the configuration parameters of the MFA server.

16.9.3 Examples

mfa-server print-config

Prints the MFA server configuration.

mfa-server-cli service-config

Initializes the database and brings up the MFA server.

mfa-server-cli auth-server --authSrvHost=aafservermultifactor.org -- endPointID=c8572fec304411eea6c60242ac110003 --endPointSecret=jzhleNLbwid75IA0AgQNZ30Lca0U6wh0

Adds the AA server details for the MFA server.

mfa-server-cli policy-config --event=cifs_aaf_event --eDirRepo=CIFS_USERS_AAF_REPO

Adds the AA configuration details for the MFA server.

mfa-server-cli service-cleanup

Reverts the service configuration and stops the MFA server.