Release candidate
...
Administration
LDAP settings

Groups

8min

You can view and manage security groups that Passwork loads from LDAP in the Groups tab of LDAP settings.

Document image


Each group can have one of the following values in the Status field:

  • Bound N roles indicates the number of groups matched with the group on the Synchronization tab.
  • Deleted means that after executing the DN request, the group was not uploaded into Passwork or was deleted on the LDAP server.
  • An empty Status field means that a group loaded, but no role was matched with it.

User authorization can be restricted. If the restriction is enabled, a user will only be able to log in and register if they belong to one of the activated groups.

The pop-up button allows for a quick view of the users in the group:

Document image

Document image


Security groups load from LDAP in the following sequence:

  1. Passwork authorizes on the LDAP server through an account with the user data entered on the authorization page.
  2. A group search request is sent to the LDAP server using default or edited DN and search filter.
  3. The request result is received and groups are uploaded from the LDAP server into Passwork.

If you change the DN group search request or delete a group that was previously used on the LDAP server, deleted groups and groups that were not found will receive a Deleted status when you perform a search again.

On the Groups tab, you can find the settings that Passwork will use when loading a list of security groups from LDAP:

Document image



Distinguished Name

Specify the Distinguished Name (DN) to define which part of the LDAP tree Passwork should use for importing.

Example:

ou=LDAP,ou=IT,dc=passwork,dc=local


DN Filter

The filter is used to determine what kind of data should be retrieved from the LDAP server.

Example:

(|(objectclass=group)(objectclass=organizationalRole)(objectclass=posixGroup))

Passwork allows you to add an additional DN and query filter in order to retrieve groups from two separate LDAP tree structures.

To add an additional DN and query filter, click the Add DN and Filter button located below the main filter field. This will display fields for entering the data.

Document image


Adding additional DN and filters allows you to enhance group search and management capabilities, providing more flexible system configuration. For example, if security groups are located in multiple LDAP trees, adding an extra DN and query filter for each tree helps avoid the time-consuming and resource-intensive process of loading the entire structure.

You can learn more about how filters work and see syntax examples in the section Filters for DN: Features and Examples.



Group list refresh

Select an interval from the list to update the LDAP group list, or disable automatic updates. For the automatic group list update to work, background tasks must be configured in Passwork.