Speaking of LDAP import filters...
By default, the first full import of Active Directory users and groups into Identity is carried out after the LDAP connection has been configured in SmartSync, when the service is started for the first time, respecting the user import and group import filters configured in the AD registry within Identity.
After this procedure, SmartSync starts monitoring new changes to the users and groups covered by the import filters, in order to synchronize their edits to TOTVS Identity.
In addition, SmartSync 5.0 will scan the entire AD base automatically every 30s from the last scan completion, based on the import filters, ensuring that all users and groups have been properly synchronized.
LDAP Filters
The LDAP protocol has a filter with its own syntax for querying the directory based on document RFC2254.
SmartSync is preconfigured with a filter that imports all users that have the first name, last name, and e-mail addresses filled in, as well as groups from the Active Directory. However, the application also allows the administrator to customize the filter that will be used for initial user import, as long as the syntax and filter entered are valid.
The following table shows the most commonly used operators for configuring filters to search for records in LDAP directories.
Logical Operator | Description |
---|---|
= | Equal to |
<= | Less than or equal to |
>= | Greater than or equal to |
& | And |
| | Or |
! | Not |
The following table shows examples of syntax for LDAP directory searches.
Description | Syntax |
---|---|
All objects | (objectClass=*) |
Users with an email filled in | (&(objectClass=user)(objectClass=person)(mail=*)) |
Groups with a description filled in | (&(objectCategory=group)(description=*)) |
Users who belong to a particular group | (&(objectClass=user)(objectClass=person)(memberOf=CN=yourgroup,OU=yourOU,DC=yourcompany,DC=com)) |
Search for a specific user by SamAccountName | (&(objectClass=user)(objectClass=person)(sAMAccountName=seunome)) |
All users except one group | (&(objectCategory=person)(objectClass=user)(!(memberOf=CN=yourgroup,OU=yourOU,DC=yourcompany,DC=com))) |
Notification!
If the default SmartSync filter is modified by another filter with incorrect syntax, or the filter conditions are not valid, the import of users may not be performed.
User import filter
When configuring a domain in SmartSync, you can set the criteria for the first import of users from Active Directory to Identity through the User Filter field.
(&(objectClass=user)(objectCategory=person))
To import users from Active Directory to Identity, the registration of these users must include the following properties. In addition, the filter configured in the User Filter field is also taken into account during the user import.
Property | Description |
---|---|
givenName | User name |
sn | User's last name |
User's email | |
userAccountControl | User status must be active |
objectGUID | Unique Global Value |
Group import filter
When configuring a domain in SmartSync, you can set the criteria for the first import of users from Active Directory to Identity through the Group Filter field.
(objectCategory=group)