Account naming rules

Definition

Account naming rules define how to generate account names to connect with final systems. The normal case is the account name will be the same as the user name, in other cases, here you could define the customize account name rules.

When you are configuring an agent, you have to indicate the user domain which will be used to create new accounts, that user domain refers to the Account naming rules defined on Soffid console. You can visit the Agents page for more information.

Standard attributes

Code: code use to identify the account naming rule.
Description: brief description of the rule. That value will be displayed to select the user domain on the agent's setup.
User domain type: use to define the kind of
- Main user name: use the main user name.
- Assigned by the operator: the operator will assign the account name.
- Script: allows you to configure the script condition and script creation of account naming.
- Server Addon: allows to select an addon to generate the account naming rules.
Generator: allows you to select an addon when the user domain type selected is "Server addon".
Create account condition: defines the conditions to enable or prevent the creation of the account. It is only available when the Script option is selected in the User domain type.
Script: computes the name to assign to the user account. If the script returns null, the account is not going to be created. It is only available when the Script option is selected in the User domain type.

Create account condition

The create account condition enables or prevents the creation of the account.

Available objects

user	User object: Details
attributes	User attributes map
groups	The groups that the user belongs to. It's composed of a java map. The key is the group name, and the value is the Group object
groupsList	The groups that the user belongs to. It's composed of a java list of Group objects
serviceLocator	Helper to get access to Soffid microservices
userDomain	User domain object
system	Target system object

Examples

~~Example:~~

// Only users with mail address in soffid.com can have an accountaccount:
"soffid.com".equals(user.mailDomain)

Only upper case:

user.getUserName().toUpperCase()
Expected result



boolean
Return true if the account can be created.



Account name Script
The create account script computes the name to assign to the user account. If the script returns null, the account is not going to be created.
Available objects



user
User object: Details


attributes
User attributes map


groups

The groups that the user belongs to.
It's composed of a java map. The key is the group name, and the value is the Group object



groupsList

The groups that the user belongs to.
It's composed of a java list of Group objects



serviceLocator
Helper to get access to Soffid microservices


userDomain
User domain object


system
Target system object



Expected result



String
Return the account name to use



Example:
// Uses the email address as the account name
user.shortName+"@"+user.mailDomain
Actions
Account naming rules query




Add new


Allows you to add a new account naming rule in the system. To add a new agent it is necessary to fill in the required fields.




Delete


Allows you to remove one or more agents by selecting one or more records on the list.




Export


Allows you to export a CSV file with the account naming rules configuration.




Import


Allows you to upload a CSV file with the account naming rules configuration to add new rules to the system.
First, you need to pick up a CSV file, that CSV has to contain a specific configuration. Then you need to check the contents. And finally, you need to select the mappings for each column of the CSV file to import the data correctly and to click the Import button.




Account naming rules detail




Apply changes


Allows you to save a new account naming rules or to save an updated account naming rules.




Undo


Allows you to undo any changes made.




Delete


Allows you to remove one account naming rule.

Add new	Allows you to add a new account naming rule in the system. To add a new agent it is necessary to fill in the required fields.
Delete	Allows you to remove one or more agents by selecting one or more records on the list.
Export	Allows you to export a CSV file with the account naming rules configuration.
Import	Allows you to upload a CSV file with the account naming rules configuration to add new rules to the system. First, you need to pick up a CSV file, that CSV has to contain a specific configuration. Then you need to check the contents. And finally, you need to select the mappings for each column of the CSV file to import the data correctly and to click the Import button.

Apply changes	Allows you to save a new account naming rules or to save an updated account naming rules.
Undo	Allows you to undo any changes made.
Delete	Allows you to remove one account naming rule.