Kontakte aus Microsoft Active Directory

Microsoft Active Directory

Um die Daten aus dem Active Directory auslesen zu dürfen brauchen Sie einen Benutzer mit entsprechender Berechtigung. Natürlich könnten Sie dazu den Active Directory Administrator verwenden. Da pascom die Zugangsdaten für den wiederholten Import abspeichern muss und der Administrator mit wesentlich mehr als den benötigten Rechten ausgestattet ist, bietet es sich an einen eigenen Benutzer für pascom anzulegen:

Wenn Sie mobydick als Benutzernamen verwenden wird dieser beim Import durch den LDAP-Filter erkannt und nicht automatisch als Benutzer auf der Telefonanlage mit angelegt.

Vergeben Sie für den pascom Benutzer ein Passwort und markieren Sie Kennwort läuft nie ab. pascom authentifiziert sich am Active Directory bei jedem Connector-Lauf. Wenn Sie das Passwort ändern möchten müssen Sie das sowohl in Active Directory als auch im pascom Connector machen:

Connector-Profil “Telefonbuch aus AD”

Erstellen Sie ein neues Connector-Profil indem Sie in der pascom Web-UI unter dem Menüpunkt Einstellungen > Connector auf Hinzufügen klicken.

Wählen Sie die Vorlage Telefonbuch aus AD und tragen Sie folgende Daten ein:

Feld	Beschreibung
Bezeichung	Name des Connectors
AD Domäne	Active Directory Domain Name
AD Server	Server IP oder DNS-Name des Hosts
SSL aktivieren	JA: zu Active Directory via sicherer SSL-Verbindung verbinden. NEIN: zu Active Directory ohne SSL verbinden.
Benutzername und Passwort	Der zuvor im AD angelegte pascom Benutzer zur Authentifizierung

Nach dem Speichern kann die Vorlage im Reiter Basisdaten bei Bedarf angepasst werden.

Basisdaten

In den Basisdaten konfigurieren Sie die Verbindung zu Ihrem Active Directory genauer oder können die zuerst konfigurierten Einstellungen ändern.

Feld	Beschreibung
Bezeichung	Name des Connectors (wird automatisch befüllt)
Modus	Neue Sätze importieren, geänderte abgleichen und früher importiere Datensätze entfernen: (Standardauswahl) Importiert nur neue Telefonbucheinträge und gleicht geänderte Einträge ab, alte Einträge werden entfernt. Neue Sätze importieren und geänderte abgleichen: Importiert neue Telefoneinträge und gleicht geänderte ab. Es werden keine Einträge entfernt.
URI	Uri zur Active Directory Domain (wird automatisch befüllt)
Basis DN	Basis DN Einträge zum Active Directory (wird automatisch befüllt)
Benutzername und Passwort	Der zuvor im AD angelegte pascom Benutzer zur Authentifizierung (wird automatisch befüllt)
Suchfilter	LDAP-Suchfilter zur Filterung des auszulesenen Telefonbuch-Ordners (wird automatisch befüllt)
Dokumentation	Dient zur Dokumentation/ Beschreibung des Connectors

Pre Filter

Im Standard importiert die Vorlage alle globalen Telefonbucheinträge mit ausgefülltem “Anzeigenamen” aus dem AD. Über den Reiter Pre Filter können Sie den Import eines bestimmten Telefonbuchs, z. B. company-phonebook, einschränken. Fügen Sie dazu folgenden Code ein:

# only import contacts with membership
if (!array_key_exists("memberOf", $row)) return false;

$groups = $row["memberOf"];
# turn a single group membership (string) into a list of memberships (array)
if (!is_array($groups)){
  $groups = array($row["memberOf"]);
}

# always search in a list of memberships
return preg_grep('/company-phonebook/i', $groups);

Telefonbuchfelder im AD

Active Directory	pascom	Beschreibung
Allgemein > Anzeigename	Anzeigename	Der Anzeigename erscheint im Telefondisplays und im pascom Client Journal. Pflichtfeld.
Rufnummer > Privat	Telefon	Die Rufnummer des Kontakts.
Allgemein > Vorname	Vorname	Vorname des Kontakts.
Allgemein > Nachname	Nachname	Nachname des Kontakts.
Organisation > Firma	Organisation	Firma des Kontakts.
Rufnummer > Fax	Fax	Faxnummer des Kontakts.
Allgemein > E-Mail	EMail	E-Mail Adresse des Kontakts.
Rufnummern > Mobil	Handy	Mobilnummer des Kontakts.

Die Felder sind lediglich ein Vorschlag der Vorlage. Sie können Felder hinzufügen und entfernen bzw. die gesamte Import-Struktur beliebig anpassen.

Importlauf testen und aktivieren

Nachdem Sie die Konfiguration abgeschlossen haben, können Sie durch die Schaltfläche Speichern und Simulieren testen welche Datensätze importiert werden würden. Wenn Sie mit dem Ergebnis zufrieden sind können Sie den Import entweder einmalig unter Aktion > Import jetzt durchführen ausführen oder durch die Schaltfläche Automatisieren eine regelmäßige Durchführung des Importes einrichten.

Anzeigenamen individualisieren

Der Anzeigename im pascom Telefonbuch wird bei ein- und ausgehenden Anrufen sowohl im Display Ihres Tischtelefons, als auch in Ihrem pascom Client angezeigt. Wenn Sie den Anzeigenamen von Kontakten anpassen möchten, da der im Active Directory hinterlegte Anzeigename nicht Ihren Bedürfnissen oder den Anforderungen der Telefonanlage entspricht, können Sie dieses Feld natürlich individuell befüllen.

Woher die die Informationen aus Active Directory stammen finden Sie im Reiter Variablen. Standardmäßig wird der Anzeigename (displayName) aus dem Active Directory direkt übernommen.

Variable	Quelle
displayname	return $row['displayName'];

Da jedoch in der pascom Telefonanlage der Anzeigename nicht mehr als 80 Zeichen betragen darf, kann es notwendig sein den Anzeigenamen aus Active Directory heraus zu kürzen, oder falls gewünscht, aus anderen Feldern auszulesen.

Im nachfolgenden Beispiel wird der Anzeigename aus Active Directory auf die Länge geprüft und im Falle, dass der Anzeigename im Active Directory gar nicht gesetzt wurde, automatisch durch den Nachnamen (Surname) und Vornamen (Givenname) des Benutzers ersetzt und ebenfalls auf die maximale Länge von 80 Zeichen gekürzt.

Dazu wird im Reiter Variablen die Quelle der Variable displayname ersetzt durch folgenden Inhalt:

# check if displayname is empty
if (!empty($row['DisplayName'])) {

  # check if displayname has more than 80 chars and cut it if necessary
  if (strlen($row['DisplayName']) <= 80) {
    return $row['DisplayName'];
  }
  # displayname will be cut from 0 to 80 chars
  return substr($row['DisplayName'],0,80);
}

# if displayname is empty use a combination of "Surname" and "Givenname" 
# and also cut it if it's longer than 80 chars
return substr($row['Surname'] . ', ' . $row['GivenName'],0,80);

Anstelle von Vorname und Nachname, kann natürlich auch jedes andere Feld aus Active Directory ausgelesen und als Quelle für den Anzeigenamen dienen.

Optionale Änderungen

Sie möchten Änderungen an Quellvariablen oder der Connector Struktur vornehmen? Dann folgen Sie den folgenden Links zu den entsprechenden Anleitungen:

[Variablen Zuweisung]( https://www.pascom.net/doc/de/connector/variables-assignment/ )
[Variablen Struktur]( https://www.pascom.net/doc/de/connector/variables-structure/ )