# Add LDAP object classes

If your Active Directory or LDAP server has LDAP object classes that are not defined in the SMC by default, add those object classes to the LDAP Object classes.

##

This way, the existing classes on the Active Directory or LDAP server can also be used for authentication.

For more details about the product and how to configure features, click Help or press F1.

## Steps

1. Select User Authentication.
2. Right-click Authentication Servers and select New > Active Directory Server or New > LDAP Server, or right-click an existing Active Directory Server or LDAP Server element, then select Properties.
3. Click the Object Classes tab.
4. Enter the name of the User Object Class or Group Object Class and click Add.
   The object class appears in the list.

## Active Directory Server Properties dialog box

Use this dialog box to define Active Directory Server properties.

Option | Definition
--- | ---
General tab
Name | The name of the element.
IP Address | Specifies the server IP address. IPv4 addresses, IPv6 addresses, and fully qualified domain names (FQDNs) are supported. You can enter only one IPv4, IPv6 or FQDN as the IP address.
Resolve | Automatically resolves the IP address of the server.
Location | A Location is needed if NAT is applied between a Engine or Management Server and the Active Directory server.
Contact Addresses | Default — Used by default whenever a component that belongs to another Location connects to this server. Exceptions — Opens the Exceptions dialog box.
LDAP Protocol | Specifies the LDAP protocol that is used for the LDAP connection. LDAP — The LDAP is used without encryption. LDAPS — The LDAPS protocol is used for encryption. Start TLS — Start TLS is used for encryption.
LDAP Port (Optional) | Specifies the port number if the server communicates on a port other than the default TCP 389 port. The predefined Firewall Template allows the engines to connect to the default port. If you change to a custom port, you must add an Access rule to allow the traffic.
Timeout | Specifies the time (in seconds) that SMC components wait for the server to reply.
TLS Profile (When the LDAP Protocol is LDAPS or Start TLS) | Specifies the settings for cryptography, trusted certificate authorities, and the TLS version used in TLS-protected traffic. Click Select to select a TLS Profile element.
TLS Server Identity (When the LDAP Protocol is LDAPS or Start TLS) | Determines how the identity of the LDAP server is verified. Edit — Opens the TLS Server Identity dialog box. Remove — Removes the configured TLS Server Identify.
Base DN | Enter the LDAP tree under which the authenticating users accounts are stored. Example: (DNS-based tree) dc=example,dc=com Example: ("O-based" tree used, for example, in Novell eDirectory) ou=astronauts,o=government,st=Florida,c=US
Anonymous (Optional) | When selected, allows Security Engines and Management Servers to connect to the LDAP server without a user name and password. When the option is selected, the Bind User ID and Bind Password options are not available.
Bind User ID | Define the Distinguished Name of the User ID that the Engines and Management Servers use to connect to the server. This user account must exist in the user database. Make sure the account you use has the permissions to manage other user accounts. Example: (DNS-based tree) uid=ExampleOrganization,ou=Administrators,dc=example,dc=com Example: ("O-based" tree used, for example, in Novell eDirectory) uid=ExampleOrganization,ou=Administrators,ou=astronauts, o=government,st=Florida,c=US
Bind Password | Specifies the password for the user account that the Engines and Management Servers use to connect to the server. By default, passwords and keys are not shown in plain text. To show the password or key, deselect the Hide option.
Category (Optional) | Includes the element in predefined categories. Click Select to select a category.
Tools Profile | Adds commands to the element right-click menu.Click Select to select an element.
Comment (Optional) | A comment for your own reference.
Check Connectivity | Tests connectivity to the Active Directory Server.

Option | Definition
--- | ---
Object Classes tab
User ObjectClass | Allows you to add user objectclasses manually. If your Active Directory server has Active Directory server user object classes that are not defined in the SMC by default, you must add those object classes to the Active Directory Server Object classes in the server properties. This way, the existing classes on the LDAP server can also be used for authentication.
Add | Adds the user objectclass name to the list of available classes.
Remove | Removes the user objectclass name from the list of available classes.
Group ObjectClass | Allows you to add group objectclasses manually. If your Active Directory server has Active Directory group object classes that are not defined in the SMC by default, you must add those object classes to the Active Directory Object classes in the server properties. This way, the existing classes on the Active Directory server can also be used for authentication.
Add | Adds the group objectclass name to the list of available classes.
Remove | Removes the group objectclass name to the list of available classes.

Option | Definition
--- | ---
Attributes tab
Short UserId | Specifies the login name attribute in short form without the domain part. By default, in Active Directory the attribute is sAMAccount name and with LDAP server it is the cn field. This attribute can be used to identify users by their Short UserID in user authentication. Note: This becomes optional if the Long UserID is configured. In order to use only Long UserID in user authentication, leave this field empty.
Long UserId | Specifies the name of the attribute for storing the User Principal Name (UPN) or the email address of the user. In Active Directory the attribute is userPrincipalName and with LDAP server it is mail. This attribute can be used to identify users by their Long UserID in user authentication. Note: By default, for Active Directory Server elements this is set to userPrincipalName.
Group Member | Specifies the name that the server uses for the Group Member Attribute. The default value is member for standard schema, and sgMember for updated schema.
Display Name | Specifies the name that the server uses for the Display Name attribute.
Photo | Attribute for storing user photo.
E-mail | Specifies the name of the attribute that is used for storing user email addresses. This attribute can be used to identify users by their email address in certificate authentication.
Mobile | Specifies the name of the attribute for storing user mobile phone numbers.
Job Title | Attribute for storing job title of a user.
Office Location | Attribute for storing office location of a user.
Framed IP | This option is included for backward compatibility with legacy software versions.
Group ObjectId (Optional) | Allows you to add group objectID manually. For example, group object IDs used in Microsoft Entra ID. If your identity and access management service uses group object IDs that are not defined in the SMC by default, you must add those object IDs to the Active Directory Server properties. This ensures that the existing object IDs in the identity and access management service can also be used for authentication.

Option | Definition
--- | ---
Client Certificate tab
User Search for Client Certificate Authentication | Specifies the name of the value in the distinguished name that is checked to verify the client identity. The following values are supported: CN — The client identity is checked against the UserId attribute specified for the server. The value of the UserId field on the Attributes tab must match the attribute that contains the user's common name. email — The client identity is checked against the E-mail attribute specified for the server. The value of the E-mail field on the Attributes tab must match the attribute that contains the user's email address. UID — The client identity is checked against the UserId attribute specified for the server. The value of the UserId field on the Attributes tab match the attribute that contains the user's UID.

Option | Definition
--- | ---
Authentication tab
User Network Policy Server Method (NPS) | When selected, uses the Windows server IAS/NPS.
Port Number | Specifies the port for your Windows server IAS/NPS.
Shared Secret | Specifies the shared secret defined for RADIUS clients on the Active Directory server. By default, passwords and keys are not shown in plain text. To show the password or key, deselect the Hide option.
Number of Retries | If an SMC component's attempts to connect to the Active Directory server fails, specifies the number of times it tries to connect again before giving up on the authentication.
IP Address (Optional) | Specifies the IP address for authentication when the authentication service on the Active Directory server uses a different IP address than the server itself.
Authentication Methods | Specifies the supported authentication methods for the Active Directory Server. Click Add to select authentication methods. Note: The User password authentication method requires you to update the schema with SMC-specific attributes. Alternatively, you can use the LDAP Authentication authentication method to authenticate users using user names and passwords stored in the external LDAP database without updating the schema. Note: If you use the Active Directory Server with the Integrated User ID Service for user identification, the supported authentication methods are User Password and LDAP Authentication.
Remove | Removes the selected elements from the External Authentication Methods list.

Option | Definition
--- | ---
Advanced tab
Secondary IP Addresses | Allows you to specify any additional device IP addresses. You can enter the additional IP addresses here instead of creating additional elements for the other IP addresses. The secondary IP addresses are valid in policies and in routing and antispoofing. You can add several IPv4 and IPv6addresses (one at a time). Add — Adds a row to the table. Remove — Removes the selected IP address from the list.
Timeout | The time (in seconds) that SMC Components wait for the server to reply.
Max Entries | The maximum number of LDAP entries that are returned in an LDAP response.
No Limit | Deselect to specify the maximum number of LDAP entries returned.
Page Size (Optional) | The maximum number of LDAP entries that are returned on each page of the LDAP response.
No Pages | Deselect to specify the maximum number of LDAP entries returned on each page.

Option | Definition
--- | ---
Monitored Servers tab
Server Type | The type of server from which the Integrated User ID Service receives information about users' IP addresses. The Active Directory server can receive information from Domain Controller servers and Exchange Servers.
IP Address | The IP address of the Domain Controller server or Exchange Server. Both IPv4 and IPv6 addresses are supported.
User | The user name of a user in the domain that has permission to execute WMI queries from a remote computer. Note: Enter only the user name without any domain information. The domain information is automatically added to the user name.
Password | The password for the user account with Domain Admin credentials.
Add | Adds a row to the table. Allows you to define a Domain Controller server or an Exchange Server.
Edit | Allows you to edit the settings of the selected server.
Remove | Removes the selected row from the table.

Option | Definition
--- | ---
Monitoring tab
Log Server | The Log Server that monitors the status of the element.
Status Monitoring | When selected, activates status monitoring for the device. You must also select the Probing Profile that contains the definitions for the monitoring. When you select Status Monitoring, the element is added to the tree in the Home view.
Probing Profile | Shows the name of the selected Probing Profile. Click Select to select a Probing Profile element.
Log Reception | Activates syslog reception from this device. You must select the Logging Profile that contains the definitions for converting the syslog entries to SMC log entries. You must also select the Time Zone in which the device is located. By default, the local time zone of the computer you are using is selected.
Logging Profile | Shows the name of the selected Logging Profile. Click Select to select a Logging Profile element.
Time Zone | Selects the time zone for the logs.
Encoding | Selects the character set for log files.
SNMP Trap Reception | Enables the reception of SNMP traps from the third-party device.
NetFlow Reception | Enables the reception of NetFlow data from the third-party device. The supported versions are NetFlow v5, NetFlow v9, and IPFIX (NetFlow v10).

Option | Definition
--- | ---
NAT tab (All optional settings)
Engine | Shows the selected engine.
NAT Type | Shows the NAT translation type: Static or Dynamic.
Private IP Address | Shows the Private IP Address.
Public IP Address | Shows the defined Public IP Address.
Port Filter | Shows the selected Port Filters.
Comment | An optional comment for your own reference.
Add NAT Definition | Opens the NAT Definition Properties dialog box.
Edit NAT Definition | Opens the NAT Definition Properties dialog box for the selected definition.
Remove NAT Definition | Removes the selected NAT definition from the list.

## LDAP Server Properties dialog box

Use this dialog box to define Lightweight Directory Access Protocol (LDAP) Server properties.

Option | Definition
--- | ---
General tab
Name | The name of the element.
IP Address | Specifies the server IP address. IPv4 addresses, IPv6 addresses, and fully qualified domain names (FQDNs) are supported. You can enter only one IPv4, IPv6 or FQDN as the IP address.
Resolve | Automatically resolves the IP address of the server.
Location | Specifies the location for the server if there is a NAT device between the server and other SMC components.
Contact Addresses | Default — Used by default whenever a component that belongs to another Location connects to this server. Exceptions — Opens the Exceptions dialog box.
LDAP Protocol | Specifies the LDAP protocol that is used for the LDAP connection. LDAP — The LDAP is used without encryption. LDAPS — The LDAPS protocol is used for encryption. Start TLS — Start TLS is used for encryption.
LDAP Port (Optional) | The port number if the server communicates on a port other than the default port (TCP port 389). The predefined Firewall Template allows the engines to connect to the default port. If you change to a custom port, you must add a Access rule to allow the traffic.
TLS Profile (When the LDAP Protocol is LDAPS or Start TLS) | Specifies the settings for cryptography, trusted certificate authorities, and the TLS version used in TLS-protected traffic. Click Select to select a TLS Profile element.
TLS Server Identity (When the LDAP Protocol is LDAPS or Start TLS) | Determines how the identity of the LDAP server is verified. Edit — Opens the TLS Server Identity dialog box. Remove — Removes the configured TLS Server Identify.
Base DN | The LDAP tree under which the authenticating users’ accounts are stored. Example (DNS-based tree): dc=example,dc=com Example (“O-based” tree used, for example, in Novell eDirectory): ou=astronauts,o=government,st=Florida,c=US
Anonymous (Optional) | When selected, allows Security Engines and Management Servers to connect to the LDAP server without a user name and password. When the option is selected, the Bind User ID and Bind Password options are not available.
Bind User ID | The Distinguished Name of the User ID that the Security Engines and Management Servers use to connect to the server. This user account must exist in the user database. Make sure the account you use has the privileges to manage other user accounts. Example (DNS-based tree): uid=ExampleOrganization,ou=Administrators,dc=example,dc=com Example (“O-based” tree used, for example, in Novell eDirectory): uid=ExampleOrganization,ou=Administrators,ou=astronauts, o=government,st=Florida,c=US
Bind Password | The password for the user account that the Engines and Management Servers use to connect to the server. By default, passwords and keys are not shown in plain text. To show the password or key, deselect the Hide option.
Category (Optional) | Includes the element in predefined categories. Click Select to select a category.
Tools Profile | Adds commands to the element right-click menu.Click Select to select an element.
Comment (Optional) | A comment for your own reference.
Check Connectivity | Tests connectivity to the LDAP Server.

Option | Definition
--- | ---
Object Classes tab
User ObjectClass | Allows you to add user objectclasses manually. If your LDAP server has LDAP user object classes that are not defined in the SMC by default, you must add those object classes to the LDAP Object classes in the server properties. This way, the existing classes on the LDAP server can also be used for authentication.
Add | Adds the user objectclass name to the list of available classes.
Remove | Removes the user objectclass name to the list of available classes.
Group ObjectClass | Allows you to add group objectclasses manually. If your LDAP server has LDAP group object classes that are not defined in the SMC by default, you must add those object classes to the LDAP Object classes in the server properties. This way, the existing classes on the LDAP server can also be used for authentication.
Add | Adds the group objectclass name to the list of available classes.
Remove | Removes the group objectclass name to the list of available classes.

Option | Definition
--- | ---
Attributes tab
Short UserId | Specifies the login name attribute in short form without the domain part. In Active Directory the attribute is sAMAccount name and with LDAP server it is the cn field. This attribute can be used to identify users by their Short UserID in user authentication. Note: This becomes optional if the Long UserID is configured.
Long UserId | Specifies the name of the attribute for storing the User Principal Name (UPN) or the email address of the user. In Active Directory the attribute is userPrincipalName and with LDAP server it is not set by default. This attribute can be used to identify users by their Long UserID in user authentication. Note: By default, this field is empty for LDAP Server elements.For example, if UPN support is needed this can be configured to contain User Principal Name and for non-AD case this can be configured to contain email address of the user.
Group Member | The name that the server uses for the Group Member Attribute. By default, the attribute is set to member for standard schema, and sgMember for updated schema.
Display Name | Specifies the name that the server uses for the Display Name attribute.
Photo | Attribute for storing user photo.
E-mail | Specifies the name of the attribute that is used for storing user email addresses. This attribute can be used to identify users by their email address in certificate authentication.
Mobile | Specifies the name of the attribute for storing user mobile phone numbers.
Job Title | Attribute for storing job title of a user.
Office Location | Attribute for storing office location of a user.
Framed IP | This option is included for backward compatibility with legacy software versions.
Group ObjectId (Optional) | Allows you to add group objectID manually. For example, group object IDs used in Microsoft Entra ID. If your identity and access management service uses group object IDs that are not defined in the SMC by default, you must add those object IDs to the LDAP Server properties. This ensures that the existing object IDs in the identity and access management service can also be used for authentication.

Option | Definition
--- | ---
Client Certificate tab
User Search for Client Certificate Authentication | Specifies the name of the value in the distinguished name that is checked to verify the client identity. The following values are supported: CN — The client identity is checked against the UserId attribute specified for the server. The value of the UserId field on the Attributes tab must match the attribute that contains the user's common name. email — The client identity is checked against the E-mail attribute specified for the server. The value of the E-mail field on the Attributes tab must match the attribute that contains the user's email address. UID — The client identity is checked against the UserId attribute specified for the server. The value of the UserId field on the Attributes tab match the attribute that contains the user's UID.

Option | Definition
--- | ---
Authentication tab
Authentication Methods | Specifies the supported authentication methods for the LDAP Server. Click Add to select authentication methods. Note: The User password authentication method requires you to update the schema with SMC-specific attributes. Alternatively, you can use the LDAP Authentication authentication method to authenticate users using user names and passwords stored in the external LDAP database without updating the schema.
Remove | Removes the selected authentication method.

Option | Definition
--- | ---
Advanced tab
Secondary IP Addresses | Allows you to specify any additional device IP addresses. You can enter the additional IP addresses here instead of creating additional elements for the other IP addresses. The secondary IP addresses are valid in policies and in routing and antispoofing. You can add several IPv4 and IPv6addresses (one at a time). Add — Adds a row to the table. Remove — Removes the selected IP address from the list.
Timeout | The time (in seconds) that SMC Components wait for the server to reply.
Max Entries | The maximum number of LDAP entries that are returned in an LDAP response.
No Limit | Deselect to specify the maximum number of LDAP entries returned.
Page Size (Optional) | The maximum number of LDAP entries that are returned on each page of the LDAP response.
No Pages | Deselect to specify the maximum number of LDAP entries returned on each page.

Option | Definition
--- | ---
Monitoring tab
Log Server | The Log Server that monitors the status of the element.
Status Monitoring | When selected, activates status monitoring for the device. You must also select the Probing Profile that contains the definitions for the monitoring. When you select Status Monitoring, the element is added to the tree in the Home view.
Probing Profile | Shows the name of the selected Probing Profile. Click Select to select a Probing Profile element.
Log Reception | Activates syslog reception from this device. You must select the Logging Profile that contains the definitions for converting the syslog entries to SMC log entries. You must also select the Time Zone in which the device is located. By default, the local time zone of the computer you are using is selected.
Logging Profile | Shows the name of the selected Logging Profile. Click Select to select a Logging Profile element.
Time Zone | Selects the time zone for the logs.
Encoding | Selects the character set for log files.
SNMP Trap Reception | Enables the reception of SNMP traps from the third-party device.
NetFlow Reception | Enables the reception of NetFlow data from the third-party device. The supported versions are NetFlow v5, NetFlow v9, and IPFIX (NetFlow v10).

Option | Definition
--- | ---
NAT tab (All optional settings)
Engine | Shows the selected engine.
NAT Type | Shows the NAT translation type: Static or Dynamic.
Private IP Address | Shows the Private IP Address.
Public IP Address | Shows the defined Public IP Address.
Port Filter | Shows the selected Port Filters.
Comment | An optional comment for your own reference.
Add NAT Definition | Opens the NAT Definition Properties dialog box.
Edit NAT Definition | Opens the NAT Definition Properties dialog box for the selected definition.
Remove NAT Definition | Removes the selected NAT definition from the list.