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_365 [06.06.2023 14:51] – [Modul konfigurieren] richard.neubertinstallationshandbuch:contactsync_365 [15.04.2024 13:52] (aktuell) – [Benutzergruppe vorbereiten] richard.neubert
Zeile 1: Zeile 1:
-<WRAP hide>{{tag>[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>
  
  
Zeile 7: Zeile 8:
  
 Voraussetzung ist, dass Sie den UCware Server **vorab** als zugreifende Anwendung im Azure Active Directory registrieren und mit entsprechenden API-Berechtigungen ausstatten. Dabei erhalten Sie die erforderlichen Anmeldedaten, die bei der Installation des ContactSync-Moduls abgefragt werden. Voraussetzung ist, dass Sie den UCware Server **vorab** als zugreifende Anwendung im Azure Active Directory registrieren und mit entsprechenden API-Berechtigungen ausstatten. Dabei erhalten Sie die erforderlichen Anmeldedaten, die bei der Installation des ContactSync-Moduls abgefragt werden.
 +
 +<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>
  
  
Zeile 82: Zeile 85:
 ==== 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 91: Zeile 94:
   - Beantworten Sie die Frage nach **office365.com** mit **Yes**.   - Beantworten Sie die Frage nach **office365.com** mit **Yes**.
   - Geben Sie nacheinander die kopierten Zeichenketten aus Azure AD ein. Bestätigen Sie jeweils mit **OK**:\\ \\ <WRAP 800px>   - Geben Sie nacheinander die kopierten Zeichenketten aus Azure AD ein. Bestätigen Sie jeweils mit **OK**:\\ \\ <WRAP 800px>
-^ <wrap lo>Abfrage im\\ </wrap> ContactSync-Installer ^ <wrap lo>Kopierte Zeichenkette aus\\ </wrap> Azure AD ^ <wrap lo>Zugehöriger Schlüssel im\\ </wrap> Key-Value-Store ^ +^ <sup>Abfrage im\\ </sup> ContactSync-Installer  ^ <sup>Kopierte Zeichenkette aus\\ </sup> Azure AD  ^ <sup>Zugehöriger Schlüssel im\\ </sup> Key-Value-Store  ^ 
-| Directory (tenant) ID         | Verzeichnis-ID                        | tenant_id                                | +| Directory (tenant) ID                           | Verzeichnis-ID                                    | ''tenant_id''                                           | 
-| Application (client) ID       | Anwendungs-ID                         | client_id                                | +| Application (client) ID                         | Anwendungs-ID                                     | ''client_id''                                           | 
-| Secret                        | Wert des geheimen Clientschlüssels    | client_secret                            |+| Secret                                          | Wert des geheimen Clientschlüssels                | ''client_secret''                                       |
 </WRAP> </WRAP>
 <WRAP clear /> <WRAP clear />
Zeile 105: Zeile 108:
   - 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 117: Zeile 120:
 ===== Manueller Import ===== ===== Manueller Import =====
  
-  - Greifen Sie über Secure Shell (SSH) auf den UCware Server zu. +Um den Import der Telefonbucheinträge erstmals auszuführen oder zu testen, gehen Sie wie folgt vor:  
-  - 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> <wrap lo>Dadurch importiert der UCware Server die Kontakte der beteiligten Benutzer sofort. Sie erhalten eine entsprechende Erfolgs- oder Fehlermeldung.</wrap>+ 
 +  - 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> 
 + 
 +Dadurch importiert der UCware Server die Kontakte der beteiligten Benutzer sofort. Sie erhalten eine entsprechende Erfolgs- oder Fehlermeldung.