Exchange Online

Step-by-step guide

Als Sync-Modus Exchange2013 auswählen und folgende URL eintragen: https://outlook.office365.com/EWS/Exchange.asmx

Achtung: Damit die Sync funktioniert muss ein Benutzer, welcher über Impersonierungsrechte verfügt, in der O365 Exchange admin console hinterlegt werden, dazu kann folgende Anleitung konsultiert werden: Setting up Application Impersonation for Office 365

Der erfasste Benutzer in der O365 Umgebung muss nun noch im RoomsAppSettings.config File hinterlegt werden, dieses File findet man im Installationsverzeichnis von ROOMS (Default: C:\Program Files (x86)\Garaio\ROOMS\Configuration). RoomsAppSettings.config

<RoomsAppSettings>
...
    <add key="Exchange2013ServiceUser" value="service.user@domain.com" />
    <add key="Exchange2013ServicePassword" value="YourPW" />
    <add key="Exchange2013ServiceDomain" value="YourDomain.com" />
...
</RoomsAppSettings>

Ergänzen Sie das File mit den obigen drei Einträgen und den angepassten values. Config.bat ausführen, um die angepasste Konfiguration zu verteilen.

Es muss sichergestellt werden, dass ROOMS von extern erreichbar ist und Anonymous Authentication auf dem WebServices directory aktiviert ist. Dies kann überprüft werden indem Sie außerhalb Ihres Netzes folgende URL aufrufen: http(s)://[ROOMS-URL]/WebServices/SyncNotification.svc

Wenn dies klappt, muss noch sichergestellt werden, dass die Applikation Root-Url in den “Globale Parameter” von ROOMS korrekt hinterlegt ist, also in der Form http(s)://[ROOMS-URL]/[Mandant]

Ab Rooms Release 4.7.2010

Mit Rooms Release 4.7.2010 wird OAuth Authentication für Exchange Online unterstützt:

Exchange stellt folgende Authentisierungsoptionen zur Verfügung:

  1. OAuth 2.0 (Exchange Online only)
  2. NTLM (Exchange on-premises only)
  3. Basic (no longer recommended)

https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth

Rooms für OAuth Authentication konfigurieren

In Setting –> Personen –> Person muss der Sync. Modus gesetzt werden

Die korrekte URL wird bereits vorausgefüllt:

https://outlook.office365.com/EWS/Exchange.asmx

Auf dem Applikationsserver müssen die Anmeledinformationen in das RoomsAppSettings.config eingetragen werden. Dafür können diese Schritte befolgt werden:

  1. Öffnen Sie einen Browser und navigieren Sie zum Azure Active Directory Admin Center. Melden Sie sich mit einem persönlichen Konto (auch: Microsoft-Konto) oder einem Geschäfts- oder Schulkonto an.
  2. Wählen Sie in der linken Navigationsleiste Azure Active Directory aus und wählen Sie dann App-Registrierungen unter Verwalten aus.
  3. Wählen Sie Neue Registrierung aus. Legen Sie auf der Seite Anwendung registrieren die Werte wie folgt fest.
    1. Geben Sie unter Name einen Anzeigenamen für Ihre App an.
    2. Legen Sie Unterstützte Kontotypen auf den Wert fest, der für Ihr Szenario sinnvoll ist.
    3. Ändern Sie für URI umleiten die Dropdownliste in Öffentlicher Client (mobil & Desktop), und legen Sie den Wert auf urn:ietf:wg:oauth:2.0:oob fest.
  4. Wählen Sie Registrieren aus. Kopieren Sie auf der nächsten Seite den Wert der Anwendungs-ID (Client-ID), und speichern Sie ihn. Sie benötigen ihn im nächsten Schritt.
  5. Wählen Sie in der linken Navigation unter Verwalten die Option API-Berechtigungen aus.
  6. Wählen Sie Berechtigung hinzufügen aus. Wählen Sie auf der Seite API-Berechtigungen anfordern unter Unterstützte Legacy-APIs die Option Exchange aus.
  7. Wählen Sie Berechtigung hinzufügen aus. Wählen Sie auf der Seite API-Berechtigungen anfordern unter Meine Apps die Option Office 365 Exchange Online aus.
  8. Wählen Sie Anwendungsberechtigungen und dann full_access_as_app aus. Klicken Sie auf Berechtigungen hinzufügen.
  9. Wählen Sie Administratorzustimmung für Organisation gewähren aus und bestätigen Sie Ihre Auswahl im Dialogfeld "Zustimmung".
  10. Wählen Sie in der linken Navigation unter Verwalten die Option Zertifikate und Geheimnisse aus.
  11. Wählen Sie Neuer geheimer Clientschlüssel aus, geben Sie eine kurze Beschreibung ein, und wählen Sie dann Hinzufügen aus.
  12. Kopieren Sie den Wert des neu hinzugefügten geheimen Clientschlüssels und speichern Sie ihn. Sie benötigen ihn später.

Nun können die folgenden Zeilen zum RoomsAppSettings.config hinzugefügt werden und der Rooms Service neugestartet werden, xxx sollte mit den Werten, die man aus den vorherigen Schritten erlangt hat, ersetzt werden

<RoomsAppSettings>
...
    <add key="ExchangeTenantId" value="xxx" />
    <add key="ExchangeAppId" value="xxx" />
    <add key="ExchangeClientSecret" value="xxx" />
...
</RoomsAppSettings>

Push Notifikationen von Exchange Online

Eine erfolgreiche Synchronisation bedingt, dass Push Notifikationen vom Exchange Server and den WebService gesendet werden können siehe 5.1.3.

Da sich bei Exchange Online der Exchange Server bei Microsoft in der Cloud befindet, benötigt es öffentlichen Zugang zu dem WebService. Mit Rooms 4.7.2010 ist es möglich, eine separate URL für den Service anzugeben:

<RoomsAppSettings>
...
	<add key="ExchangeServiceUrl" value="https://public.example.com/Webservices/SyncNotification.svc" />
...
</RoomsAppSettings>
Zuletzt geändert December 10, 2024: fix: translate to german and fix typo (703153c)