Telefonbücher von einem Exchange Server importieren

Der UCware Server bietet die Möglichkeit, die Outlook-Kontakte ausgewählter Benutzer von einem Microsoft Exchange Server zu importieren. Dazu kommt das Zusatzmodul ucware-contactsync zum Einsatz, das Sie bei Bedarf auf dem UCware Server installieren können.

Hinweis:
Alternativ lassen sich Kontaktdaten per CSV-Datei auf den UCware Server importieren. Damit können Sie bei Bedarf auch mehrere Telefonbücher pro Benutzer anlegen und aktuell halten.

Voraussetzungen

Zum Import von Kontaktdaten greift der UCware Server als sogenannte Dienstanwendung auf den Exchange Server zu. Dabei nutzt er ein einzelnes Benutzerkonto, das über die Berechtigung zum Identitätswechsel verfügt. Dieses Dienstkonto fungiert als Schnittstelle zu allen Exchange-Benutzern, deren Adressbücher importiert werden sollen.

Zur Funktionsweise und Konfiguration des Identitätswechsels lesen Sie die Dokumentation von Microsoft.

Stellen Sie sicher, dass das Dienstkonto entsprechenden Zugriff auf alle gewünschten Exchange-Benutzer erhält.

Der UCware Server ruft die konkreten Adressbuch-Einträgen anhand der primären E-Mail-Adresse des jeweiligen Exchange-Benutzers ab. Hinterlegen Sie diese vor dem ersten Import auf den Detailseiten der gewünschten Benutzer im Admin-Client.

Für einen sicheren Datenaustausch müssen Sie ggf. das Zertifikat des Exchange-Servers auf dem UCware Server bereitstellen. Kopieren Sie es dazu als [SERVERNAME].crt ins Verzeichnis /usr/local/share/ca-certificates des UCware Servers. Führen Sie anschließend den Befehl sudo update-ca-certificates aus.

Contact-Sync-Modul installieren

Paket bereitstellen

  1. Greifen Sie per SSH auf den UCware Server zu.
  2. Lesen Sie die Paketquellen neu ein:
    sudo apt update
  3. Installieren Sie das Paket ucware-contactsync:
    sudo apt install ucware-contactsync

    Folgen Sie während der Installation den Anweisungen im nächsten Abschnitt.

Modul konfigurieren

  1. Beantworten Sie die Frage nach office365.com mit No.
  2. Beantworten Sie die weiteren Abfragen wie folgt und bestätigen Sie jeweils mit OK:

    Abfrage im
    ContactSync-Installer

    Eingabe
    Zugehöriger Schlüssel im
    Key-Value-Store
    Hostname of the EWS Server IP-Adresse oder FQDN server
    Account of the Exchange User primäre E-Mail-Adresse des Dienstkontos adminuser
    Password of the Exchange User Passwort für das Dienstkonto adminpass

Hinweis:
Zur Anbindung an einen anderen Exchange Server müssen Sie das ContactSync-Modul nicht erneut installieren. Passen Sie stattdessen die bei der Erstinstallation hinterlegten Zeichenketten über die angegebenen Schlüssel im Key-Value-Store an.

Benutzergruppe vorbereiten

  1. Melden Sie sich am Admin-Client an.
  2. Stellen Sie sicher, dass alle am Import beteiligten Outlook-Benutzer auch auf dem UCware Server angelegt sind.

    Hinweis:
    Die auf dem UCware Server hinterlegte E-Mail-Adresse des jeweiligen Benutzers muss seiner primären Outlook-Adresse entsprechen.

  3. Erstellen Sie eine neue Benutzergruppe.
  4. Weisen Sie der Gruppe den Parameter ews_synccontacts mit dem Wert true zu.
  5. Klicken Sie aufund übernehmen Sie die Einstellungen mit .
  6. Weisen Sie die gewünschten Benutzer als Mitglieder der Gruppe zu.

Im UCC-Client der Gruppenmitglieder wird ein neues Telefonbuch mit den jeweils importierten Kontakten angezeigt. Der Titel des Telefonbuchs lautet Privat, sofern Sie im Key-Value-Store vor dem ersten Import keinen anderen Wert für den Schlüssel phonebookname hinterlegt haben.

Der UCware Server synchronisiert die Kontakte einmal pro Nacht automatisch.

Hinweis:
Manuell im UCC-Client hinzugefügte Einträge des Telefonbuchs gehen dabei verloren. Verwalten Sie die zugehörigen Kontakte daher ausschließlich auf dem Exchange Server.

Manueller Import

Um den Import der Telefonbucheinträge erstmals auszuführen oder zu testen, gehen Sie wie folgt vor:

  1. Greifen Sie per SSH auf den UCware Server zu.
  2. Führen Sie den folgenden Befehl aus:
    sudo -u ucservices python3 /usr/lib/python3/dist-packages/ucware/services/ews/contactsync/contactsync.pyc -v

Dadurch importiert der UCware Server die Kontakte der beteiligten Benutzer sofort. Sie erhalten eine entsprechende Erfolgs- oder Fehlermeldung.