Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
installationshandbuch:contactsync_exchange [07.06.2023 09:31] – [Sequenz 1] richard.neubertinstallationshandbuch:contactsync_exchange [15.04.2024 13:53] (aktuell) – [Benutzergruppe vorbereiten] richard.neubert
Zeile 1: Zeile 1:
-<WRAP hide>{{tag>[todo gui:UCC-Client func:Installation func:Inbetriebnahme func:Telefonbuch func:Kontakte]}}</WRAP>+<WRAP hide>{{tag>red:initial}}</WRAP> 
 +<WRAP>{{tag>gui:UCC-Client func:Installation func:Inbetriebnahme func:Telefonbuch func:Kontakte}}</WRAP>
  
  
-====== Telefonbücher von einem Exchange-Server importieren ======+====== 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. 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.
  
 <WRAP tip>**Hinweis:**\\ Alternativ lassen sich [[adhandbuch:benutzer_gruppen:gruppen:telefonbuch_csv|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.</WRAP> <WRAP tip>**Hinweis:**\\ Alternativ lassen sich [[adhandbuch:benutzer_gruppen:gruppen:telefonbuch_csv|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.</WRAP>
-===== Exchange Server vorbereiten ===== 
  
-==== Sequenz 1 ==== 
  
-Vor der Installation müssen folgende Voraussetzungen erfüllt sein: +===== Voraussetzungen =====
-  * 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 Wert ''True'' 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 [[intern:server:knowledgebase:ad-sync|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.+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 [[https://learn.microsoft.com/de-de/exchange/client-developer/exchange-web-services/impersonation-and-ews-in-exchange|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.
  
-  * 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 ====== ===== Contact-Sync-Modul installieren ======
  
 ==== Paket bereitstellen ==== ==== Paket bereitstellen ====
  
-  - Greifen Sie über Secure Shell (SSH) auf den UCware Server zu.+  - Greifen Sie per SSH auf den UCware Server zu.
   - Lesen Sie die Paketquellen neu ein: <code bash>sudo apt update</code>   - Lesen Sie die Paketquellen neu ein: <code bash>sudo apt update</code>
   - Installieren Sie das Paket **ucware-contactsync**: <code bash>sudo apt install ucware-contactsync</code> Folgen Sie während der Installation den Anweisungen im nächsten Abschnitt.   - Installieren Sie das Paket **ucware-contactsync**: <code bash>sudo apt install ucware-contactsync</code> Folgen Sie während der Installation den Anweisungen im nächsten Abschnitt.
Zeile 42: Zeile 42:
 <WRAP clear /> <WRAP clear />
  
-<WRAP tip>**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.</WRAP>+<WRAP tip>**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.</WRAP>
  
  
Zeile 49: Zeile 49:
   - Melden Sie sich am Admin-Client an.   - Melden Sie sich am Admin-Client an.
   - Stellen Sie sicher, dass alle am Import beteiligten Outlook-Benutzer auch auf dem UCware Server [[adhandbuch:benutzer_gruppen:benutzer:erstellen|angelegt sind]].\\ \\ <WRAP tip>**Hinweis:**\\ Die auf dem UCware Server hinterlegte E-Mail-Adresse des jeweiligen Benutzers muss seiner **primären** Outlook-Adresse entsprechen.</WRAP>   - Stellen Sie sicher, dass alle am Import beteiligten Outlook-Benutzer auch auf dem UCware Server [[adhandbuch:benutzer_gruppen:benutzer:erstellen|angelegt sind]].\\ \\ <WRAP tip>**Hinweis:**\\ Die auf dem UCware Server hinterlegte E-Mail-Adresse des jeweiligen Benutzers muss seiner **primären** Outlook-Adresse entsprechen.</WRAP>
-  - Erstellen Sie eine [[adhandbuch:benutzer_gruppen:gruppen:benutzer#Benutzergruppen erstelllen|neue Benutzergruppe]].+  - Erstellen Sie eine [[adhandbuch:benutzer_gruppen:gruppen:allg#Gruppe erstellen|neue Benutzergruppe]].
   - Weisen Sie der Gruppe den **Parameter** ''ews_synccontacts'' mit dem **Wert** ''true'' zu.   - Weisen Sie der Gruppe den **Parameter** ''ews_synccontacts'' mit dem **Wert** ''true'' zu.
-  - Klicken Sie auf{{:adhandbuch:schaltflaeche_plus_schwarz_alpha.png?nolink|}}und übernehmen Sie die Einstellungen mit {{:adhandbuch:button_erstellen_blau_alpha.png?direct|}}. +  - Klicken Sie auf{{:adhandbuch:schaltflaeche_plus_schwarz_alpha.png?nolink|}}und übernehmen Sie die Einstellungen mit {{:adhandbuch:button_erstellen_blau_alpha.png?nolink|}}. 
-  - Weisen Sie die gewünschten Benutzer als [[adhandbuch:benutzer_gruppen:gruppen:benutzer#Benutzer zuweisen|Mitglieder der Gruppe]] zu.+  - Weisen Sie die gewünschten Benutzer als [[adhandbuch:benutzer_gruppen:gruppen:allg#Mitglieder oder Inhalte zuweisen|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. 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.
Zeile 63: Zeile 63:
 Um den Import der Telefonbucheinträge erstmals auszuführen oder zu testen, gehen Sie wie folgt vor:  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.+  - Greifen Sie per SSH auf den UCware Server zu.
   - Führen Sie den folgenden Befehl aus: <code bash>sudo -u ucservices python3 /usr/lib/python3/dist-packages/ucware/services/ews/contactsync/contactsync.pyc -v</code>   - Führen Sie den folgenden Befehl aus: <code bash>sudo -u ucservices python3 /usr/lib/python3/dist-packages/ucware/services/ews/contactsync/contactsync.pyc -v</code>
  
 Dadurch importiert der UCware Server die Kontakte der beteiligten Benutzer sofort. Sie erhalten eine entsprechende Erfolgs- oder Fehlermeldung. Dadurch importiert der UCware Server die Kontakte der beteiligten Benutzer sofort. Sie erhalten eine entsprechende Erfolgs- oder Fehlermeldung.