> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/en/integrations/connector/contacts-ldap.md).

# Contacts from LDAP Directory

Synchronise your LDAP Telephone Book Entries

## "Telephone Book from LDAP" Connector Profile

Create a new connector profile by logging into the PASCOM Web UI and navigating to **Settings** > **Connector** > **Add**.

Select the option *Telephone book from LDAP* and enter the following information:

| Field             | Description                                                                  |
| ----------------- | ---------------------------------------------------------------------------- |
| **Name**          | Connector profile name                                                       |
| **LDAP URI**      | URL to the LDAP directory                                                    |
| **Base DN**       | BaseDN specifies the position within the LDAP directory which should be read |
| **Username**      | User with LDAP directory access permissions (LDAP bindDN)                    |
| **Password**      | Password for LDAP Authentication                                             |
| **Search Filter** | Filter for more detailed LDAP directory searches                             |

After saving, the template can be modified according to requirements under the tab **Basic Data**.

### Basic Data

Under the basic data tab, you can configure your LDAP connection more precisely or update the previously configured settings.

| Field                         | Description                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Title**                     | Connector profile name (*is automatically filled*)                                                                                                                                                                                                                                                                                                                       |
| **Mode**                      | <p><strong>Create and update records. Remove missing records from previous imports.</strong>: (<em>default setting</em>) Imports only new phone book entries and compares updated entries, old entries will be removed.<br><strong>Create and update records</strong>: Imports only new phone book entries and compares updated entries. No entries will be removed.</p> |
| **URI**                       | LDAP URI (*is automatically filled*)                                                                                                                                                                                                                                                                                                                                     |
| **Base DN**                   | Base DN LDAP entries (*is automatically filled*)                                                                                                                                                                                                                                                                                                                         |
| **Username** and **Password** | LDAP authentication credentials for the added PASCOM user (*is automatically filled*)                                                                                                                                                                                                                                                                                    |
| **Search Filter**             | LDAP search filter for filtering the destination telephone book read folders (*is automatically filled*)                                                                                                                                                                                                                                                                 |
| **Comments**                  | Serves as a documentation / description for the connector                                                                                                                                                                                                                                                                                                                |

### Pre Filter

Per default, the template will import all users from the LDAP directory. Using the **Pre Filter** tab you can restrict the import according to certain factors e.g. *company-phonebook* is populated. Simply replace "*return true;*" with the following code:

```
if (strpos($row['memberOf'],'company-phonebook') !== false) {
return true;
}
return false;
```

### Telephone Book Fields in LDAP

Via the **Variables** tab, in the **Source** column it is possible to define from which LDAP telephone book fields the information can be read from. The **Variables** in the left column define which information sets can be imported into the PASCOM cloud phone system.

The preset fields are suggestions for the template. It is possible to add, modify and remove fields i.e. completely alter the import structure to match your requirements.

### Test and Activate the Import Process

After you have finalised your configuration, you can test the connector profile to determine which datasets will be imported using the **Save and Simulate** button. Once you are satisfied with the results, it is possible to either perform a one off import using the **Action** > **Import Now** option or automate the import to be performed at regular intervals by clicking the **Automate** button.

### Optional Modifications

Do you want to make changes to source variables or the Connector structure? Then follow the links below to the appropriate instructions:

[Variable Assignment](/en/integrations/connector/variables-assignment.md)

[Variables structure](/en/integrations/connector/variables-structure.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pascom.net/en/integrations/connector/contacts-ldap.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.