Contacts

  <!-- Describes a contacts setup -->
  <contacts>
    <!-- Describes a ldap setup -->
    <ldap>
      <!-- use this service or not
        type: boolean -->
      <active>false</active>
      <!-- ldap server address fqdn or ip address
        type: string -->
      <server>ldap.example.org</server>
      <!-- ldap lts modes
        type: string
        accepted values:
          ldap
          ldapStartTls
          ldaps -->
      <ldapProtocol>ldap</ldapProtocol>
      <!-- ldap server port 389 or 636 (LDAPS)
        type: integer
        minimum: 1
        maximum: 65535 -->
      <port>389</port>
      <!-- ldap protocol version 2 or 3
        type: string
        accepted values:
          two
          three -->
      <ldapVersion>three</ldapVersion>
      <!-- username to login
        type: string -->
      <username>telephoneNumber=1234, dc=example</username>
      <!-- The password to authenticate the for the ldap server
        type: string -->
      <password></password>
      <!-- name filter according to RFC2254
        type: string -->
      <nameFilter>(|(cn=%*)(cn=* %*)(sn=%*)(sn=* %*)(givenName=%*)(givenName=* %*))</nameFilter>
      <!-- number filter according to RFC2254 for reverse number lookup
        type: string -->
      <numberFilter>(|(telephoneNumber=*%)(mobile=*%)(homePhone=*%))</numberFilter>
      <!-- number filter according to RFC2254 for the number suggestion list in the dialer
        type: string -->
      <dialerNumberFilter>(|(telephoneNumber=*%*)(mobile=*%*)(homePhone=*%*))</dialerNumberFilter>
      <!-- scope that will be searched
        type: string -->
      <baseDN>dc=example</baseDN>
      <!-- maximum size of a result list for a filtered search
        type: integer
        minimum: 1
        maximum: 32000 -->
      <maxHits>20</maxHits>
      <!-- Maximum size of a result list for an unfiltered search when starting the contacts app
        type: integer
        maximum: 32000 -->
      <maxEntriesOnStart>100</maxEntriesOnStart>
      <!-- what names are you looking for
        type: string -->
      <nameAttributes>cn sn givenName company o</nameAttributes>
      <!-- what numbers are you looking for
        type: string -->
      <numberAttributes>mobile telephoneNumber homePhone</numberAttributes>
      <!-- find contact by incoming call number
        type: boolean -->
      <reverseNumberLookupIncoming>true</reverseNumberLookupIncoming>
      <!-- find contact by outgoing call number
        type: boolean -->
      <reverseNumberLookupOutgoing>true</reverseNumberLookupOutgoing>
    </ldap>
    <!-- name sorting order for contact query results
      type: string
      accepted values:
        orderByFirstname
        orderByLastname -->
    <orderBy>orderByFirstname</orderBy>
  </contacts>