Metainformationen zur Seite
Dies ist eine alte Version des Dokuments!
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.
Exchange Server vorbereiten
Sequenz 1
Vor der Installation müssen folgende Voraussetzungen erfüllt sein:
- Auf dem Exchange-Server muss es einen Benutzer geben der das „Impersonation“ Recht für alle Benutzer hat deren Adressbücher synchronisiert werden sollen. Zur Einrichtung dieses Rechts für einen Benutzer diese Anleitung befolgen: https://docs.microsoft.com/de-de/exchange/client-developer/exchange-web-services/how-to-configure-impersonation
- Auf der UCware muss es eine neue Gruppe mit dem Parameter
ews_synccontacts
mit dem WertTrue
geben - Die Benutzer in dieser Gruppe müssen alle die email-Adresse eingetragen haben die ihre primäre Adresse auf dem Exchangeserver ist.
- ggf. muss noch das Zertifikat des Exchangeservers installiert werden, analog zu ad-sync
Um Telefonbucheinträge vom gewünschten Exchange Server zu importieren, muss der UCware Server dort über ein eigenes Benutzerkonto verfügen. Berechtigen Sie dieses Dienstkonto zum Identitätswechsel in Bezug auf die gewünschten Exchange-Benutzer. Folgen Sie dazu der entsprechenden Anleitung von Microsoft.
- Das Dienstkonto des UCware Servers muss Zugriff auf die gewünschten Exchange-Benutzer haben (s. o.).
- Die E-Mail-Adressen der UCware-Benutzer müssen den primären E-Mail-Adresse ihrer Exchange-Konten entsprechen.
- Die gewünschten Benutzer müssen einer Gruppe mit dem folgenden Parameter angehören:
Contact-Sync-Modul installieren
Paket bereitstellen
- Greifen Sie über Secure Shell (SSH) auf den UCware Server zu.
- Lesen Sie die Paketquellen neu ein:
sudo apt update
- 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
- Beantworten Sie die Frage nach office365.com mit No.
- Beantworten Sie die weiteren Abfragen wie folgt und bestätigen Sie jeweils mit OK:
Abfrage im
ContactSync-Installer
EingabeZugehöriger Schlüssel im
Key-Value-StoreHostname 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 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
- Melden Sie sich am Admin-Client an.
- 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. - Erstellen Sie eine neue Benutzergruppe.
- Weisen Sie der Gruppe den Parameter
ews_synccontacts
mit dem Werttrue
zu. - 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:
- Greifen Sie über Secure Shell (SSH) auf den UCware Server zu.
- 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.