App Layering

Directory service

You can configure the appliance to connect to a directory service, for example, Active Directory. When you connect to your directory service, you will create one or more Directory Junctions to access specific domains or OUs. The appliance does not modify the directory service you connect to. The software caches the attributes for each directory service entry, so that if the connection to the directory service is lost temporarily, the software can use the cached information for management tasks.

When creating a Directory Junction, you use the following industry standard acronyms:

  • OU - Organizational Unit
  • DC - Domain Component

About connecting the appliance to a directory service

In the Management Console, the System > Directory Services displays information on Users and Groups.

Supported protocols

When binding to a directory service, the App Layering appliance is compatible with the following secure socket and transport layer protocols:

  • Secure Socket Layer:
    • SSL 3.0
  • Transport Layer Security:
    • TLS 1.1
    • TLS 1.2

What happens when you add Directory Junctions

Each Directory Junction that you create specifies a starting node in the directory tree. A new directory junction cannot include users who are already members of another junction, and junctions cannot be nested.

If you add a Parent Directory Junction, all of its children are migrated to that junction. All imported Users and Groups will be moved to the Parent, along with all Elastic Assignments. After being moved, the Child Directory Junctions are deleted.

**If you’re creating several Distinguished Names **

The system compares the Domain Component first—the portions of the Distinguished Name that start with “DC=”. Please be aware that in Distinguished Names, order matters. For example, DC=A,DC=B is different than DC=B,DC=A. The system adds separate Directory Junctions if their DC components differ, or if their DC components match and the remaining components do not overlap. Directory Junctions are merged if their DC components match and their other components are related.

User attributes are imported from the directory service

The App Layering software imports and caches user and group attributes from your directory service when:

  • You assign administrator privileges to a user.
  • The values of the attributes change in the directory service.

The attributes that the software caches are read only. All changes to the attributes for directory service users come from the directory server.

Imported attributes are synchronized regularly

The software synchronizes the information it caches for directory service users with the directory service every 12 hours. If the software discovers that a user is no longer an object in the directory service, it classifies the user as abandoned (you can view this information in the Information view for the user).

Create a directory junction

  1. Click System > Directory Services.

  2. Click Add Directory Junction.

  3. Specify the details for the directory server:

    • Server address - The name for the server that you use for the directory service (IP Address or DNS Name).
    • Port - Specify the port number for communicating with the directory server.
    • Use SSL - Click to enable Secure Sockets Layer (SSL) communication. If certificate errors occur, a list of these errors displays. If you are sure it is safe to ignore them, click Accept and Continue.
    • Bind Distinguished Name (DN) - To determine the correct syntax for the Bind DN or user name, see the documentation for your directory. The following examples show some of the ways you can specify a user for the directory service:
      • domain\username
      • username@domain.com.
    • Bind Password - Type the password.
    • Base Distinguished Name - Specify where the software starts searching for users and groups in the remote directory service.
    • Directory Junction Name - The name of the folder that you see in the tree view. You can use any name, including the name of a domain in your directory service tree.
  4. CLick Confirm and Complete.

Directory service