- 19 Nov 2024
- 5 Minutes to read
- Print
- DarkLight
- PDF
Assign Active Directory Group to Users
- Updated on 19 Nov 2024
- 5 Minutes to read
- Print
- DarkLight
- PDF
Assign Active Directory Group to Users adds or removes an Active Directory group to or from the users returned by the selected query or assets selected on the relevant asset page.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
Required Fields
These fields must be configured to run the Enforcement Set.
- Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
- Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
- Use stored credentials from the Active Directory adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.
- When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.
- To use this option, you must successfully configure an Active Directory adapter connection.
- The user name and the password used for the adapter connection must have the Required Permissions to fetch assets.
- Group DNs - A semicolon (;) separated list of group distinguished names to add to or remove from the users. Note that commas (,) are allowed in distinguished names. For example:
CN=Group One,OU=Groups,DC=example,DC=com;CN=Group Two,OU=Groups,DC=example,DC=com
- Add/Remove assignment - Select the action to perform: Add or Remove.
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Additional Fields
These fields are optional.
DC Address - The address of the Domain Controller (DC). Can be either an IP address or a valid DNS name that Axonius can communicate with via the Required Ports.
Port - You can configure the DC Address field with a customized LDAP port. To add the customized LDAP port enter a DC Address and a port number separated with a colon in the following format DC_NAME:PORT_NUMBER. When you use this format you direct the system to use the value following DC_NAME: as a custom port.
Fallback DC Address, Fallback Port - Enter a secondary DC address and port as a secondary server to be connected if the first one fails.
SASL Mechanism - SASL authentication is supported. The following authentication methods are available: No SaSL, External, GSSAPI, Digest MD5 and Plain. Each method requires different authentication parameters:
- No SASL - Authenticate using User Name and Password
- External - Authenticate using User Name
- GSSAPI - Optional authentication using UserName
- Digest MD5 - Authenticate using Username, Password, Enable signing, and Realm (optional) Authorization ID (optional)
- Plain - Authenticate using Username/Authentication ID and Password and Authorization ID (optional)
Parameters depending on the SASL Mechanism selection
a. Username and Password - A user with regular LDAP query rights and its password. Enter the userPrincipalName (username@domain) OR domain\username. When connecting over SSL, the username must be in the format username@domain.
b. Authentication ID - Use for SASL Plain Mechanism.
c. Realm - The LDAP Realm.
d. Authorization ID (authzid) - The SASL authzid.
e. Enable signing - Enable LDAP signing, refer to LDAP Signing for AD.DNS Server Address - Axonius assumes that Domain Controller listed in each connection is also a DNS server. If your Domain Controller does not have the DNS role installed and you would like to use a different system for name resolution of discovered assets you can enter an alternate IP address here (even if it is installed, but you enter a field here, Axonius will use it). Please note that this setting is only used for discovered assets and will not affect resolution of the Domain Controller name entered in the connection configuration. This configuration value is used in conjunction with the Enable IP Resolving advanced setting.
Alternative DNS Suffix - Replace the device original DNS suffix for DNS resolving. For example, if the device name is windows8.acme.corp , and the Alternative DNS Suffix defined is 'acme-corp.lan', DNS resolving will be done for windows8.acme-corp.lan.
Use SSL for connection (optional, default: Unencrypted) - Select either Unencrypted (LDAP) or Verified / Unverified to use LDAPS (LDAP over SSL). Note that the DC Address in the adapter configuration must be the FQDN provided by the certificate.
CA File - If you choose the Verified option to use LDAPS (LDAP over SSL), you need to add SSL certificates (PEM format CA file) to the credentials.
SSL cipher - Enter an SSL cipher to use for the TLS object of the connection. Using a stronger cipher can solve connection failures when using the default cipher. Examples of OpenSSl ciphers.
Do Not Fetch Users - Select this option if you do not want to fetch users.
Fetch Disabled Devices and Fetch Disabled Users - Select to fetch disabled devices or users. By default, Axonius fetches only enabled devices and users.
Filter Deleted Devices - By default Axonius fetches deleted devices. Select this option to not fetch deleted devices.
Filter Deleted Users by default Axonius fetches deleted users. Select this option to not fetch deleted users.
Connect to Global Catalog (GC) - Select this option if the configured DC has a Global Catalog role.
Organizational units include list - Set one or more OUs so Axonius will fetch entities that reside only in the listed organizational units. Each item in the list should represent an 'OU' value of the desired OU DN. For example, for OU DN (“Ireland Office/acme/corp , New York Office/acme/corp”), specify the organizational units of Acme corporation of the Ireland Office and New York Office.
Organizational units to exclude - Set one or more OUs so that Axonius will not fetch entities that belong to the specified organizational units. Each item in the list should represent an 'OU' value of the OU DN that should be excluded. For example, for OU DN (“Ireland Office/acme/corp , New York Office/acme/corp”), specify the organizational units of Acme corporation of the Ireland Office and New York Office.
Search Base - When you enter a path, a search only happens under the path configured. This option should not generally be configured and fetch should normally be for the complete domain. It can be useful in a case where there might be more than one AD subdomain, and you only want to fetch resources for a specific subdomain.
- Justification reason - Enter reason for adding or removing the listed groups to/from the users.
- Gateway Name - Select the Gateway through which to connect to perform the action.
Required Ports
Axonius must be able to communicate via the following ports:
- TCP/UDP port 389.
If you choose to use the stored credentials from the adapter then refer to Required Ports for information about all additional ports required.
Required Permissions
For more details about other Enforcement Actions available, see Action Library.