TcHmiLdap

General properties

Symbol name

Text

Description

HOST

Host

A host name, a domain name or an IP address. IPv6 is currently not supported.

PORT

Port

The most common ports are 636 for TLS and 389 for unencrypted connections.

USE_TLS

Use TLS

Strongly recommended, especially when using the 'Simple' authentication mechanism.

TRUST_ALL_CERTIFICATES

Trust all certificates

If 'false', the system checks whether the server certificate was issued by a certification authority that the operating system trusts.

TIMEOUT

Timeout

This timeout is used for all LDAP requests, including search requests.

BASE_DN

Base DN

Entry point for LDAP search queries. If empty, the domain components of the host are used.

LDAP_OPT_REFERRALS

Follow referrals

Specifies whether the referrals returned by the LDAP server should be followed automatically.

CASE_SENSITIVE_ATTRIBUTE_VALUE_COMPARISON

Attribute values compared taking upper/lower case into account

DNs and attributes are not case-sensitive by default. It is possible to change this setting in the LDAP schema of the attribute, but this is rare.

HMI authentication

Symbol name

Text

Description

AUTHENTICATION_MECHANISM

Authentication mechanism

The most common mechanism is 'Simple'. 'Digest-MD5' is recommended if TLS is not available.

USER_FILTER

User filter

Is used to search for user entries. {input} which is replaced by what the user enters in the registration form. {username_attribute} is a placeholder that is replaced by the configured username attribute.

USERNAME_ATTRIBUTE

User name attribute

Attribute used to identify the user.

IGNORE_DOMAIN_SUFFIX_DURING_LOGIN

Ignore the domain during login

Ignore anything after the first @ in the name you enter during login. For example, if the 'userPrincipalName' is used on ActiveDirectory, this setting must be disabled as the 'userPrincipalName' contains an @.

APPEND_DOMAIN_DURING_LOGIN

Append the domain during login

If, for example, the 'email' or 'userPrincipalName' is used for login, the domain suffix can be added automatically with this setting so that it does not have to be entered during login. A case-insensitive check is carried out to find out whether the domain already exists.

USE_LDAP_SEARCH_FOR_LISTUSERS

Use LDAP search request for ListUsers

Depending on the size of the directory, the search may take too long or return too many results. If disabled, the user names from the TcHmiSrv configuration are collected.

LDAP authentication

Symbol name

Text

Description

BIND_USER_AUTHENTICATION_MECHANISM

Authentication mechanism for the bind user. 'None' indicates that there is no bind user.

'None' means that there is no bind user. In this case, the bind request is made with what the user enters in the registration form.

BIND_USER_DN

Bind user DN

The full DN of the bind user, which is used to search for the DN of the user attempting to log in. This setting is ignored if the authentication mechanism is 'Anonymous', 'Kerberos Credential Cache' or 'None'.

BIND_USER_PASSWORD

Bind user password

Is saved as plain text in the configuration database.

Group mappings

Symbol name

Text

Description

GROUP_MAPPINGS

Group mappings

Set HMI user groups based on the attributes of an LDAP user.

BLOCK_USERS

Block specific users

Blocked users cannot log in, even if they have logged in successfully in the past.