Skip to main content
Skip table of contents

SuperADMIN Settings - cfg

The following commands set global SuperADMIN properties.

Local ID Store

Description

Default settings for account locking (these settings will apply to all accounts unless specifically overridden for an individual account):

defaultLockTime
The amount of time to lock an account for once the user has exceeded the maximum failed login attempts. During this time the user will not be able to login even if they specify the correct credentials.
defaultMaxAttempts
The maximum number of failed login attempts before an account will be locked.

You can also check and set these properties using the account command.

Usage

View the current configuration:

CODE 
cfg global superadmin.localIdStore

Update the configuration:

CODE 
cfg global superadmin.localIdStore.defaultLockTime set "<time>"
cfg global superadmin.localIdStore.defaultMaxAttempts set "<attempts>"
Examples
CODE 
cfg global superadmin.localIdStore.defaultLockTime set "30 seconds"
cfg global superadmin.localIdStore.defaultLockTime set "5 minutes"
CODE 
cfg global superadmin.localIdStore.defaultMaxAttempts set "10"
More InformationUnlock a User Account

Migration

Description

These properties are set automatically by SuperADMIN when it migrates your data from the old XML files to the relational database. You should not need to make any changes to these settings.

Usage

View the current configuration:

CODE 
cfg global superadmin.migration

Update the configuration:

CODE 
cfg global superadmin.migration.displayOptionsCatalog set {true|false}
cfg global superadmin.migration.legacyFls set {true|false}
cfg global superadmin.migration.userCatalog set {true|false}
Examples
CODE 
cfg global superadmin.migration.displayOptionsCatalog set true
cfg global superadmin.migration.displayOptionsCatalog set false
cfg global superadmin.migration.legacyFls set true
cfg global superadmin.migration.legacyFls set false
cfg global superadmin.migration.userCatalog set true
cfg global superadmin.migration.userCatalog set false

Self Reg

Description

Settings for user registration.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg
More InformationUser Registration

The following commands set properties for user registration.

Groups

Description

Settings for groups to which a new registered user is added.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.addToGroups

Update the configuration:

CODE 
cfg global superadmin.selfreg.addToGroups set ["<value>"]
cfg global superadmin.selfreg.addToGroups set ["<value>", "<value>", ...]
cfg global superadmin.selfreg.addToGroups add "<value>"

Clear the configuration:

CODE 
cfg global superadmin.selfreg.addToGroups remove
Examples

The following example sets a single group to which new users are added. This will override any existing configured groups.

CODE 
cfg global superadmin.selfreg.addToGroups set ["Group1"]

The following example sets an array containing multiple groups to which new users are added.  You can set an array containing only one group. This will override any existing configured groups.

CODE 
cfg global superadmin.selfreg.addToGroups set ["Group1", "Group2", "Group3"]

The following example adds a group to an existing group array. You cannot add a group if an array does not already exist.

CODE 
cfg global superadmin.selfreg.addToGroups add "Group4"
More Information

Configure User Registration

Email

Description

Email settings for user registration.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.email

Reset the configuration to default settings:

email

CODE 
cfg global superadmin.selfreg.email remove
More InformationCustomise Email Templates

The following commands set email properties for user registration.

Default Language
Description

Set the default language for user registration emails.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.email.defaultLanguage

Update the configuration:

CODE 
cfg global superadmin.selfreg.email.defaultLanguage set "<lang>"

Reset the configuration to default settings:

CODE 
cfg global superadmin.selfreg.email.defaultLanguage remove
Examples

The following example sets the default language to English.
<lang> is either a two character ISO 639-1 language code or a language code followed by a hyphen and a two character ISO 3166 country code. For example, en, de or de-AT.

CODE 
cfg global superadmin.selfreg.email.defaultLanguage set "en"
More InformationCustomise Email Templates
Format
Description

Set the format of user registration emails (HTML, plain text, or both).

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.email.format

Update the configuration:

CODE 
cfg global superadmin.selfreg.email.format set "<format>"

Reset the configuration to default settings:

CODE 
cfg global superadmin.selfreg.email.format remove
Examples

The following example sets the format of email messages to HTML.
Format can be set to html, plainText or both. You need to provide templates for all the languages and formats you set.

CODE 
cfg global superadmin.selfreg.email.format set "html"
More InformationCustomise Email Templates
From Address
Description

Set the "from address" used for emails sent by the user registration system.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.email.fromAddress

Update the configuration:

CODE 
cfg global superadmin.selfreg.email.fromAddress set "<email_address>"

Reset the configuration to default settings:

CODE 
cfg global superadmin.selfreg.email.fromAddress remove
Examples

The following example sets the from email address.

CODE 
cfg global superadmin.selfreg.email.fromAddress set "registrations@mycompany.com"
More InformationCustomise Email Templates
Localisation
Description

Settings for language and the message contents of emails.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.email.localized

Update the configuration:

CODE 
cfg global superadmin.selfreg.email.localized.<lang>.template set "<htmltemplate>"
cfg global superadmin.selfreg.email.localized.<lang>.plainTemplate set "{message}"

Remove the configuration entry:

CODE 
cfg global superadmin.selfreg.email.localized remove
Examples

The following example defines the message content for a global HTML email template for English language messages. 
<lang> is either a two character ISO 639-1 language code or a language code followed by a hyphen and a two character ISO 3166 country code. For example, en, de or de-AT.
Any double quotes within the template are escaped with a preceding backslash: \

CODE 
cfg global superadmin.selfreg.email.localized.en.template set "<html><body style=\"font-family: Helvetica, Calibri, Verdana, sans-serif\"><p><img src=\"https://wingarc.com.au/email/str.png\" width=\"151\" height=\"65\" alt=\"Space-Time Research Logo\"/></p>{message}</body></html>"

The following example defines a global plain text email template for English language messages.

CODE 
cfg global superadmin.selfreg.email.localized.en.plainTemplate set "{message}"
More InformationCustomise Email Templates

Token Duration

Description

Settings for the duration of time that verification links sent to users by email are valid. Time period in minutes or hours. By default, links are valid for 4 hours.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.tokenDuration

Update the configuration:

CODE 
cfg global superadmin.selfreg.tokenDuration set "<time>"

Clear the configuration:

CODE 
cfg global superadmin.selfreg.tokenDuration remove
Examples

The following example sets the duration to 10 hours.

CODE 
cfg global superadmin.selfreg.tokenDuration set "10 hours"

The following example sets the duration to 2 minutes.

CODE 
cfg global superadmin.selfreg.tokenDuration set "2 minutes"

The following example removes the set token duration and returns the value to the default of 4 hours.

CODE 
cfg global superadmin.selfreg.tokenDuration remove
More Information

Rate Limiting and Token Duration

Web Client

Description

Settings for path and files used for password reset, registration rejection, and registration verification in email templates.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.webClient

Reset the configuration to default settings:

CODE 
cfg global superadmin.selfreg.webClient remove
More InformationConfigure User Registration

The following commands set properties for web client user registration.

Password Reset Path
Description

Set the file used for the password reset path link in email templates. 

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.webClient.passwordResetPath

Update the configuration:

CODE 
cfg global superadmin.selfreg.webClient.passwordResetPath set "<filename>"

Reset the configuration to default:

CODE 
cfg global superadmin.selfreg.webClient remove
Examples

The following example sets the file used to reset a password in email templates.

CODE 
cfg global superadmin.selfreg.webClient.root set "resetPassword.xhtml"
Reject Path
Description

Set the file used for the reject path link in email templates. 

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.webClient.rejectPath

Update the configuration:

CODE 
cfg global superadmin.selfreg.webClient.rejectPath set "<filename>"

Reset the configuration to default:

CODE 
cfg global superadmin.selfreg.rejectPath remove
Examples

The following example sets the file used to reject registration in email templates.

CODE 
cfg global superadmin.selfreg.webClient.rejectPath set "reject.xhtml"
Verify Path
Description

Set the file used for the verify path link in email templates. 

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.webClient.verifyPath

Update the configuration:

CODE 
cfg global superadmin.selfreg.webClient.verifyPath set "<filename>"

Reset the configuration to default:

CODE 
cfg global superadmin.selfreg.webClient.verifyPath remove
Examples

The following example sets the file used for verification in email templates.

CODE 
cfg global superadmin.selfreg.webClient.verifyPath set "verifyPath.xhtml"
Root
Description

Set the base URL of the path for links in email templates.

Usage

View the current configuration:

CODE 
cfg global superadmin.selfreg.webClient.root

Update the configuration:

CODE 
cfg global superadmin.selfreg.webClient.root set "<url>/webapi/jsf/user"

Remove the configuration entry:

CODE 
cfg global superadmin.selfreg.webClient.root remove
Examples

The following example sets the base URL of your deployment for the links used in email templates.

CODE 
cfg global superadmin.selfreg.webClient.root set "https://mydomain/webapi/jsf/user"
More InformationConfigure User Registration
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close