3.2. User Management
Access user management via Settings > Users. This section
allows administrators to add or edit user accounts.
The 2FA field in the overview indicates whether a
user has Two Factor Authentication enabled.
When creating a user, you can enforce a password change and the use of 2FA. If those options are selected, the user can only use the Management Center with limited functionality until the password has been changed and 2FA has been enabled.
Add User Account
Editing a user account does not require a password, even though the fields are shown in the dialog. An initial password is required for user creation.
Access the user roles in Settings > Roles.
You can download a list of all users in CSV format.
The overview lists local accounts as well as accounts provisioned
through LDAP and Single Sign-On. The Type field indicates the
origin of an account:
Type |
Description |
|---|---|
Local |
Account created and managed in the Management Center |
LDAP |
Account provisioned from the directory (see LDAP Configuration) |
SSO |
Account provisioned by the identity provider (see Single Sign-On) |
Regardless of their origin, all accounts carry roles, permissions and
preferences in the same way. Fields that are managed outside the
Management Center cannot be edited here: the password and role fields
are hidden for LDAP users, and SSO users are read-only except for the
Disabled toggle.
3.2.1. User Defaults
You can set user defaults to preselect certain options when a new user is created. These are not strict enforcements. They set the default values when the User Creation modal is opened.
The dialog also holds the password policy and the automatic deactivation of inactive users. In contrast to the preselected options, these two settings are enforced.
User Defaults
3.2.1.1. Password Policy
The password policy applies to local accounts and is enforced whenever a password is set or changed. Passwords of LDAP and Single Sign-On users are governed by the directory or the identity provider.
Setting |
Description |
|---|---|
Minimum Length |
Shortest accepted password. The default is 15 characters, in line with NIST SP 800-63B |
Minimum Length with 2FA |
Separate, typically lower minimum for users who have two-factor authentication enabled |
Maximum Length |
Longest accepted password |
Character Classes |
Require a digit, a symbol, an upper case or a lower case character |
NIST SP 800-63B Mode |
Enforces the recommendations of NIST SP 800-63B - This will flag any of the above settings if they are not adhering to the NIST SP 800-63B standard |
Note
The policy is applied the next time a password is changed. Existing passwords remain valid until then. To apply a new policy immediately, enforce a password change for the affected users.
3.2.1.2. Automatic Deactivation
Local users can be deactivated automatically after a configurable number of days without a login. The value set in the user defaults applies to newly created users and can be adjusted for each user individually. A deactivated user can be enabled again by an administrator.
LDAP and Single Sign-On accounts are governed by the directory or the identity provider and are not deactivated this way.
3.2.2. Roles
By default, the Management Center ships with the following pre-configured user roles. The pre-configured roles can be modified or deleted. The role model is fully configurable.
User Roles – Factory Defaults
All users except users with the Readonly right can run scans on endpoints.
The following section describes the predefined rights and restrictions that each role can have.
3.2.3. Rights
Role |
Permissions |
|---|---|
Administrator |
Unrestricted |
Manage Scan Templates |
Allows scan template management |
Remote Console |
Connect to endpoints via remote console |
View Remote Console Log |
Review the recordings of all remote console sessions |
Response Control |
Run playbooks, including playbooks for evidence collection, to kill processes or isolate an endpoint |
Service Control |
User can manage services on endpoints, e.g. Aurora |
3.2.4. Restrictions
Role |
Restrictions |
|---|---|
Force Scan Template [2] |
Force user to use predefined scan templates that are not restricted |
No Inactive Assets [2] |
Cannot view inactive assets in asset management. |
No Task Start [2] |
Cannot start scans or tasks (playbooks) |
Readonly [2] |
Cannot change anything or run scans or response tasks. Used to generate read-only API keys |
3.2.5. LDAP Configuration
To configure LDAP, navigate to Settings > LDAP.
In the left column you can test and configure the LDAP connection itself.
In the right column, the mapping of LDAP groups to Management Center
groups (and its associated permissions) is defined.
First, check whether your LDAP server is reachable by the Management Center by clicking "Test Connection".
Note
If you are using LDAPS with a self-signed certificate or a custom CA,
you must trust the signer on the Management Center.
Copy the CA certificate to /usr/local/share/ca-certificates.
Run sudo update-ca-certificates.
Restart the Management Center service:
sudo systemctl restart asgard-management-center.
Configure the LDAP Server
Then check the bind user you want to use for the Management Center. Read
permissions on the bind user are sufficient. To find out
the distinguished name, use an LDAP browser or query it
using the PowerShell AD module command Get-ADUser <username>.
Configure the LDAP Bind User
Next, configure the LDAP filters used to identify the groups and users and their preferred attributes in your LDAP structure. A default for LDAP and AD in a flat structure is given in the "Use recommended filters" drop-down menu, but you can adapt it to your environment. The test button shows whether a login with that user would be successful and which groups the Management Center identified and could be used for a mapping to Management Center groups.
Configure the LDAP User and Group Filters
If you need to adapt the recommended configuration or want to customize it,
we recommend an LDAP browser such as ADExplorer
from Sysinternals to browse your LDAP structure. For example, you could
use your organization's email address as a user login name if you change the "User Filter"
to (&(objectClass=user)(objectCategory=user)(userPrincipalName=%s))
Note
You need to save the configuration by clicking Update LDAP Config.
Using the test buttons only uses the data in the forms, but does not
save it. You can use the test buttons for testing at any time
without changing your working configuration.
After the LDAP configuration is set up, provide role mappings from LDAP
groups to Management Center groups. This is done in the right column with the
Add LDAP Role feature.
LDAP Group to Role Mapping