If you use an LDAP based directory service for storing user entries with group memberships, you can configure VAST Cluster to connect to your LDAP server as a client and query user information. Learn about how this can be used for authorizing access to NFS files here.
In order to avoid overtaxing your LDAP server resources, user entries are cached on retrieval, and your LDAP server is only queried periodically based on demand for new or aged entries. The default Time to Live (TTL) value for entries is 1800s.
From the menu (click ), select Security and then select the LDAP tab.
Click the (only) row in the grid to edit the server details:
The URI of the remote LDAP server in the format
The port of the remote LDAP server. Default value:
The authentication method the LDAP server uses to authenticate VAST Cluster as a client querying the LDAP database. Set the method according to how the LDAP server is configured to authenticate clients. The following options are available:
Anonymous. The LDAP server accepts queries without any authentication.
Simple. The LDAP server attempts to bind a specified user name to a matching LDAP user. If the LDAP bind succeeds, VAST Cluster is allowed access to perform the query. Set also Bind DN and Bind password.
The search base is the base DN (distinguished name). It specifies an entry in the LDAP directory tree to use as a starting point for queries.
To maximize the speed of authentication queries, start the search in the lowest branch of the tree under which all users can be found. For example, if the entire directory must be queried, the search base must specify the root of the tree. However, if the search can be restricted to a specific organizational unit (OU), queries may be faster.
The format for base DN is a comma separated list of components. Each component is an attribute=value pair defining an object in the directory tree. The first component defines the object at the lowest part of the tree that you want to use as the starting point of the search, the next component is its container and so on up the tree, with the last component representing the top level domain.
The following attributes can be specified:
cn: common name
ou: organizational unit
For example, supposing your user accounts are all located in a container called 'users' under a domain 'mydomain.local'. If you want to set the users container as the starting point for search queries, you would enter:
To specify the full domain as your search base, you would enter:
Enter the bind DN for authenticating to the LDAP server. The bind DN specifies the user with which VAST Cluster authenticates to the LDAP directory.
Format is as described for Search base beginning with a cn attribute component specifying the user object.
cn=admin,ou=users,dc=mydomain,dc=localspecifies user 'admin' located in the 'users' container under the domain 'mydomain.local'.
This field appears if Simple is selected in the Method field. This is the password used with the Bind DN to authenticate to the LDAP server.
Use TLS (from VAST Cluster 2.2.0)
Enable to use TLS to secure communication between VAST Cluster and the LDAP server.
The VAST Cluster TLS client is configured with the
TLS_REQCERTconfiguration parameter set to
never, which means it does not request the server's TLS certificate and ignores any certificate received. On the TLS server, make sure that
TLS_REQCERTis not set to
demandsince VAST Cluster cannot connect to a server with
Verification of the server's TLS certificate will be added in a future release.
(Version 1.2.4 onwards) Some LDAP servers, including Active Directory (AD), use attributes that are different from the default attribute set that VAST Cluster uses to query the LDAP server. You can specify a different attribute to query in place of the default attributes. To manage these attribute mappings, click Advanced-attribute mappings. The default attributes are prepopulated in the fields. Overwrite attributes as needed:
VAST Cluster supports the RFC2307 LDAP schema.
Advanced-Attribute Mappings Field
Default (RFC2307 Compliant)
The attribute that contains GIDs.
The attribute that contains UIDs, which are used as login names.
The attribute that contains UID numbers.
The attribute that contains group members.
The object class that defines a user.
The object class that defines a group.
The LDAP server details are updated.
To integrate an LDAP server, use the following CLI commands.
For full CLI command syntax, including arguments, enter the command at the CLI prompt, followed by ?.