...
To be able to operate , you need to be defined as a user in the system. Your access to various applications is defined by the access group that you are assigned withto. The Execute permission means that members of an access group can use a certain application. For applications that include configurable parameters, you apply the Write permission.
Note | ||
---|---|---|
| ||
|
To open the Access Controller, click the
button in the upper left part of the Desktop, and then select from the menu.Users Tab
InIn , the default user, mzadmin, will always have full permissions permission for any activity.
It is recommended that the password for mzadmin is changed and kept in a safe place. Instead, personal accounts should be created and used for handling the system in order to track changes.
...
Setting | Description | ||||||||||
Check to enable the user's predefined access rights | |||||||||||
Username | Enter the name of the user. Valid characters are: A-Z, a-z, 0-9, '-' and '_'.
| ||||||||||
Full Name | Enter a the descriptive name of the user. | ||||||||||
Enter the user's e-mail address. This address will be automatically applied to applications from which e-mails may be sent. | |||||||||||
Enter a password for the user account. | |||||||||||
Re-enter the password. | |||||||||||
Successor | A successor must be defined in the case you want to remove a user that has ownership of configuration objects. | ||||||||||
Validity Period | A defined period of time when a particular user has access rights to .When the validity period expires, the user will be unable to login log in or access until the validity period is renewed by an administrator.
| ||||||||||
Group | Enter a comma-delimited list of all the access groups that the user is a member of. | ||||||||||
Member | If enabled, the user is registered as a member of the specific group. | ||||||||||
Default | If enabled, this group is set as the default group for the user. By default, this group will have read, write and execute permissions for new configurations created by the user. |
For details of on how to change your password see The File Menu in 1.3 Desktop User Interface.
Access Groups Tab
The Administrator is a predefined access group. By default, this group has full access to all the activities and functions in the system and it cannot be deleted. You can only change the Access Controller permissions for the Administrator group.
...
Setting | Description | |||||
---|---|---|---|---|---|---|
Name | Enter the name of the group. Valid characters are : A-Z, a-z, 0-9, '-' and '_' | |||||
Description | Descriptive information about the group. | |||||
Allow Access Through SCIM | Allows the group to be accessed using SCIM.
| |||||
Application | This column is a list of the all applications in the system. | |||||
Execute | Check to enable the members of the access group to start an instance of the relevant application. Clear to prohibit the access group members from using it. | |||||
Write | Check to enable the members of the access group to edit and save a configuration within the relevant application. Clear to prohibit the user from doing so.
| |||||
A drop-down menu that allows the user to filter on application type. Options are All, Configuration, Inspection, Tools, or Web interface. | ||||||
Select All | Enables Write (if applicable) and Execute for all permissions in the chosen category. | |||||
Disables Write and Execute for all permissions in the chosen category. |
...
Advanced Tab
You use the Advanced tab to specify the number of consecutive erroneous login attempts permitted by a user, enable logging in the System Log when a user fails to login to, and configure user authentication by selecting the relevant authentication method.
Access Controller - Advanced tab
Number of Consecutive Erroneous Login Attempts
In order to configure the maximum number consecutive number of consecutive failed login attempts, open the Advanced tab, and set a value in Number Of Consecutive Erroneous Login Attempts. The default is 3.
When the maximum number of failed login attempts is reached, the user must restart the Desktop. If enhanced user security is enabled, the user account is also locked. For more information, see the section below, Enhanced User Security.
Enable Logging for User Login
In order to configure the system to log failed attempts in the System Log, open the Advanced tab, and select the check box Enable Logging For User Login. Successful logins and locked accounts are always logged regardless of this setting.
Reauthenticate Users after Inactivity
In order to configure the system to reauthenticate users after a period of inactivity in the Desktop or mzsh shell (interactive mode), open the Advanced tab, and select the check box Reauthenticate Users After Inactivity. Then set the maximum inactive time in Time of Inactivity Before Reauthentication (Minutes).
In On the Desktop, the duration of time that the user does not perform any actions is counted as inactive time, regardless of ongoing processes.
However, users are not logged out due to inactivity , but must authenticate again in order to continue the session.
In the mzsh shell, the duration of time that the user does not press any key is counted as inactive time, provided that there is no ongoing command execution. Users are logged out as a result of due to inactivity and are prompted to enter the password again.
Enhanced User Security
The security user control can be enhanced by changing the Platform property mz.security.user.control.enabled
in the platform.conf
. By default, this property is set to false
. If set to true
a number of rules regarding the passwords apply as soon as the platform is restarted.
...
Be at least eight characters long
Include at least one special character and one that is either a number or a capital letter
The password must not:
Contain more than two identical characters in an uninterrupted sequence. Such as "aaa".
Note title Note! Repetitive characters that are not consecutively sequenced are still valid. Such as "adadad".
Include the username.
- Be in alphabetical sequencesequences, such as Abcd.
- Be in numerical sequencesequences, such as 1234.
- Be in any US keyboard pattern, such as Qwerty.
- Contain any whitespace.
Be identical to any of the recent twelve (minimum) passwords used for the user ID
The default maximum password age is 30 days for administrators that which means the users that are members of the Administrator group, and 90 days for other users.
You can modify the password rules with the following Platform properties:
...
Property | Description | |||||
---|---|---|---|---|---|---|
mz.security.max.password.age.enabled | Default value: false Enables or disables the password expiration check. This property is only applicable when mz.security.user.control.enabled is also set to true. If both properties above are set to true, the user is required to change the password every N days set in mz.security.max.password.age.admin and mz.security.max.password.age.user. | |||||
mz.security.max.password.age.admin | Default value: This property specifies the maximum password age for administrator users in days. Please refer mz.security.max.password.age.enabled column. | |||||
mz.security.max.password.age.user | Default value: This property specifies the maximum password age for users in days. Please refer mz.security.max.password.age.enabled column. | |||||
mz.security.max.password.history | Default value: This property specifies how many passwords back that are required to be unique before reusing an old password. | |||||
mz.security.user.control.enabled | Default value: This property enables or disables enhanced user security. If set to
| |||||
mz.security.user.control.password.length.count | Default value: This property specifies the minimum total number of characters in a password.
| |||||
mz.security.user.control.password.numcaps.count | Default value: The minimum number of upper case characters characters or number of numerical characters, in a password. | |||||
mz.security.user.control.password.numcaps.message | Default value: The message to be displayed for the user when they have not met the condition for the minimum number of upper case or numerical characters in the password. | |||||
mz.security.user.control.password.numcaps.pattern | Default value: The pattern of the permitted values in the regular expression. The password will be matched to the pattern to determine if the condition is met. | |||||
mz.security.user.control.password.length.count | Default value: The minimum total number of characters in a password. | |||||
mz.security.user.control.password.length.message | Default value: The message to be displayed for the user when they have not met the condition for the minimum length of the password. | |||||
mz.security.user.control.password.lowercase.count | Default value: | |||||
mz.security.user.control.password.uppercase.count | Default value: The minimum total number of uppercase characters in a password. | |||||
mz.security.user.control.password.number.count | Default value: The minimum total number of numeric characters in a password. | |||||
mz.security.user.control.password.special.count | Default value: The minimum number of special characters, in a password. | |||||
mz.security.user.control.password.special.message | Default value: The message to be displayed for the user when they have not met the condition for the minimum number of special characters in the password. | |||||
mz.security.user.control.password.special.pattern | Default value: The pattern of the permitted values in the regular expression. The password will be matched to the pattern to determine if the condition is met. | |||||
mz.security.user.control.password.repetition.message | Default value: The message to be displayed for the user when they have not met the condition for the password having the least amount of multiple repeated characters in a sequence. | |||||
mz.security.user.control.password.username.message | Default value: The message to be displayed for the user when they have the username contained withing within the password. | |||||
mz.security.user.control.password.history.message | Default value: The message to be displayed for the user when they are reusing a password that they have used before. | |||||
mz.security.user.control.password.extra.count | Default value: The minimum number of characters for the extra user policy. | |||||
mz.security.user.control.password.extra.message | Default value: The message to be displayed for the user when they did not meet the requirements of the extra user policy. | |||||
mz.security.user.control.password.extra.pattern | Default value: The pattern of the permitted values. The password will be matched to the pattern to determine if the condition is met. | |||||
mz.security.user.control.password.extra.type | Default value: The type that determines what the extra pattern will be. The value of this property can be set to regexp or none. Setting it to regexp ensures that the pattern has to conform to regular expressions. |
...
User authentication is by performed default performed in. As an alternative, you can connect to connect the system to an external LDAP directory for delegated authentication. This facilitates the automation of administrative tasks such as the creation of users and assigning access groups.
If the external authentication server returns an error or cannot be accessed, will the system will perform the authentication internally as a fallback method.
...
This section does not apply if authentication is to be performed by the system.
Note | ||
---|---|---|
| ||
For Active directory specific settings check Active Directory Important Information. |
...
The LDAP directory that is used for authentication must conform to the following requirements:
The cn attribute of group entries must match an access group defined in the system.
Note title Note! The system performs case sensitive comparisons of the cn attributes and access groups.
- For each user in a group entry, the
memberUid
attribute must be set. - All group entries must belong to the object class
posixGroup
. All user entries must belong to the objectclass
posixAccount
.The username must be unique. It cannot duplicate a username that already exists in the system.
Note | ||
---|---|---|
| ||
If a user requires administration rights, they must be added to the Administrator access group, which is a default access group in, and you must create a group named Administrator in the LDAP directory. |
...
The following steps are required before the configuration of authentication with LDAPS or LDAP over TLS:
...
All user entries must belong to the
objectclass
user .User 's groups have to be provided via
memberOf
attribute.UserThe user's login has to be provided via
samaccountname
attribute.The username must be unique. It cannot duplicate a username that already exists in the system.
Note | ||
---|---|---|
| ||
If a user requires administration rights, they must be added to the Administrator access group, which is a default access group inin the system, and you must create a group named Administrator in the LDAP directory. |
...
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Authentication Methods | The Authentication Methods setting is only available if LDAP Authentication is installed.
The default setting is authentication performed by the system.
| ||||||||||
URL | Enter the URL for the external authentication server. The default ports, 389 for LDAP and 686 for LDAPS , are used unless other ports are specified in the URL. When using LDAP, you may connect via LDAPS by entering
| ||||||||||
Test Connection | Click this button to test the connection to the authentication server. LDAP attributes and other settings than the URL are not used when testing the connection. | ||||||||||
User Base DN | Enter the LDAP attributes for user lookups in the external authentication server. The substring %s in this value will be replaced with the username entered at login to produce an identifier that is passed to the LDAP server.
| ||||||||||
Group Base DN | Enter the LDAP attributes for group lookups in the external authentication server.
The name of the groups must be identical to the names configured in Access Groups. | ||||||||||
TLS | Select this check box to enable Transport Layer Security.
| ||||||||||
AD Naming | Select this check box if you want to use Active directory specific naming. | ||||||||||
Enable | Select this check box if you want to enable group search bind credentials. You must also populate the Bind DN and Password fields. If you want to run an anonymous lookup, leave this check box empty. | ||||||||||
Bind DN | If you want to use a specific Bind DN to search for the group, enter the Bind DN. | ||||||||||
Password | If you want to use a specific Bind DN to search for the group, enter the password for the Bind DN. |
...
It is possible to use SCIM via the REST HTTP interface to POST, GET, DELETE, PUT and PATCH user and group configurations. This section will cover the schemas used to create, update and remove users and groups, as well as the limitations when using SCIM for the system.
For more information regarding the specifications for SCIM, please see RFC: https://tools.ietf.org/html/rfc7643
...
Note | ||
---|---|---|
| ||
When importing the user configurations into or the system or when upgrading the system, the users will be disabled after the import operation or the upgrade. In order to enable the users, you can use PATCH or PUT, a user with the attribute active: true. You can also enable the user by ticking the checkbox for the users you want to enable from the User tab in Access Controller on the desktop. When creating a new user from SCIM, the user will be enabled by default. |
These are the limitations for using SCIM instead of the desktopthe desktop.
- A user can only be created once using the HTTP method POST
- The password attribute is not mandatory when you create a user with POST, however, the user will not be able to login to without to the system without a password.
- All user details can be modified except the username.
- The users assigned group can only be updated using the HTTP method PUT
- When using PUT to assign a user's group, no default group will be selected.
- You can only POST an access group with the same name one time, the group name can not be changed.
It is not possible to set or change the applications connected to the access group using the HTTP methods available via SCIM, this is only possible using the desktop.
Custom Schema
has The system has an additional schema for the "User" resource. The Schema URI for it is:
...
This section will cover all the REST HTTP APIs that are used for user-related operations.
Retrieving Users
...
Info | ||
---|---|---|
| ||
The schemas, Operations, op, and value fields as shown below are mandatory. They must be filled in. The rest of the fields are optional |
...
This section will cover all the REST HTTP APIs that are used for group-related operations.
Retrieving Groups
...
Code Block |
---|
URL: http://<host>:9000/scim/api/v1/Groups/a85d8e8c-0b6d-4653-b7c6-33c1fd6c1921 Method: DELETE Accept: */* Content-Type: */* |
Scroll ignore | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||