How To Connect

Prerequisites:

• Admin Access to Zluri
• Access to Active Directory GUI
• .pem certificate for SSL(Optional)
• LDAP Agent Credentials
• Understanding of Sync Configuration: Guide to Sync Config

System Requirements:

• OS: Windows Server 2016 or above and Windows 10 or above.
• Processor: An Intel Pentium 4 processor or later, capable of SSE3.
• RAM: A minimum of 400MB is required for the app, and 4GB is recommended for the server.
• Storage: installer consumes 80mb + 350mb after install.
• Graphics: Integrated graphics (e.g., Intel HD Graphics 4000 or equivalent) with DirectX 11 support.
• Display: 640x480

Connect the Microsoft Active Directory (On Premises) in Zluri

1. Open the Integrations Catalog, search for “Microsoft Active Directory (On Premises)”, and click ➕ Connect underMicrosoft Active Directory (On Premises).

2. Choose the scopes for the integration, and click Continue. You can click the down-arrow button towards the right of a scope to find out what it does.

   

3. Enter the Agent Name(mandatory and unique) + download the Agent file and click *Continue.

   

4. Download the Sync Config and Copy the Installation token - valid for 30 minutes and keep it somewhere safe.

   

Installing the Agent:

1. Open the downloaded Agent file to begin installation (usually in your Downloads folder).

2. The agent will run and opens up a window.

3. Connect Server:

   1. Enter the Installation Token from previous steps.
   2. Click - Validate and Continue.
   

4. Configure Agent: Enter the Configuration Parameters

   1. On Premises Server Host: The hostname or IP address of your on-prem Active Directory server (e.g., ad.example.com).
   2. Server Port: The port used by the AD server for LDAP communication (default: 389 for LDAP / 636 for LDAPS)
   3. SSL Checkbox: Upload a certificate(pem) for SSL enablement.
   4. Base DN (Directory Domain Name): Enter the root domain DN (e.g., DC=acme,DC=com).
      1. How to find it:
         • Open Active Directory Users and Computers (ADUC).
         • Enable View > Advanced Features.
         • Right-click your domain (e.g., acme.com) > Properties.
         • Go to the Attribute Editor tab.
         • Look for the distinguishedName attribute.
           • Example value: DC=acme,DC=com
   5. Bind DN: The distinguished name (DN) of the AD account the agent uses to bind (authenticate) with Active Directory and query directory objects (e.g., CN=Admin,CN=Users,DC=example,DC=com).
   6. Password: Password for the Bind DN.
   7. Click Test and Continue.

5. Upload Configuration File:

   1. Understand and edit the configuration file as per you requirement. Sync Config Guide.
   2. Upload the configuration file in the correct format.
   3. Click Continue.

6. The setup is complete. You’ll be able to see the agent is up and running.

7. You can close the agent, it’ll be running in the background.

Agent Settings:

In order to use the settings, you’ve to pause the agent services. You can restart the service and it won’t affect the sync or workflow tasks that are pending to be executed.

1. Rotate Credentials
   1. Helps you maintain your security and compliance policy to rotate credentials whenever required.
   2. Once changes are made, you’re asked to Test and Save the configuration.
   3. A success notification toast will appear to confirm the changes.
2. Configuration File
   1. You’ll be able to see the date when was the last time the sync configuration was uploaded.
   2. You can download the previously updated config here and do changes to it and reupload.
   3. Once changes are made, you’re asked to Test and Save the uploaded file.
   4. A success notification toast will appear to confirm the changes.

After you finish updating the settings, please restart the service to continue syncs and polling for tasks.

Download Button:

Logs: There is an option to download logs from the agent directly.

Configuration File: If you wish to download the last updated configuration file without stopping the service, you’ve an option to do so.