E-Mail Kalendereinladungen

So konfigurieren Sie E-Mail Kalendereinladungen für Azure Outlook in Salto IDM

Um die Konfiguration der E-Mail Kalendereinladungen für die Verwendung von Outlook zu konfigurieren, müssen Sie eine neue App-Registrierung in Azure erstellen, diese mit Berechtigungen versehen und anschließend in Salto IDM die Anmeldeinformationen eingeben.

Schritt 1: Erstellen einer Azure-App-Registrierung in Ihrem Azure AD-Mandanten

1. Navigieren Sie zur Seite Azure-Portal – App-Registrierungen.

2. Wählen Sie entweder eine vorhandene Anwendung auf der Registerkarte Alle Anwendungen oder Neue Registrierung aus.

3. Wenn die Seite Anwendung registrieren angezeigt wird, geben Sie die Registrierungsinformationen Ihrer Anwendung ein:

   • Geben Sie im Abschnitt Name einen aussagekräftigen Namen ein (z. B. Salto-IDM-Calendar-Integration-Production)
   • Wählen Sie im Abschnitt Unterstützte Kontotypen die Option Nur Konten in diesem Organisationsverzeichnis (nur Ihr Mandantenname – Einzelmandant) aus.
   • Sie können den Abschnitt Redirect URI (optional) leer lassen, da unsere Umgebung die Weiterleitung automatisch verarbeitet.

   

4. Klicken Sie auf Registrieren, um die Anwendung zu erstellen.

Schritt 2: Bereitstellen von Berechtigungen für Ihre App-Registrierung

1. Öffnen Sie in der App-Registrierung die Seite API-Berechtigungen
2. Klicken Sie auf Berechtigung hinzufügen
3. Klicken Sie in dem daraufhin geöffneten Fenster auf Microsoft Graph und dann auf Anwendungsberechtigungen
4. Scrollen Sie nach unten und suchen Sie den Abschnitt Kalender und fügen Sie Calendars.ReadWrite hinzu

5. Fügen Sie eine weitere Microsoft Graph-Berechtigung hinzu, verwenden Sie diesmal jedoch Delegierte Berechtigungen
6. Scrollen Sie nach unten und suchen Sie den Abschnitt Benutzer und fügen Sie User.Read hinzu

7. Klicken Sie nach dem Hinzufügen der Berechtigungen auf Admin-Einwilligung für Ihren Mandanten erteilen. Ihre konfigurierten Berechtigungen sollten wie folgt aussehen:

Schritt 3: Client-Secret hinzufügen

1. Klicken Sie auf die Registerkarte Zertifikate & Secrets und dann auf Neues Client-Secret.
2. Fügen Sie Ihrem Secret eine aussagekräftige Beschreibung hinzu und wählen Sie ein Ablaufdatum gemäß Ihren eigenen Sicherheits- und Wartungsregeln.

3. Sobald Sie das Secret erstellt haben, sollten Sie den geheimen Wert (nicht die geheime ID) kopieren und an einem sicheren Ort aufbewahren (z. B. einem Passwort-Manager). Sobald Sie diese Seite verlassen, können Sie den Wert nicht mehr sehen. Wenn Sie ihn nicht speichern, müssen Sie das Secret neu erstellen.

Schritt 4: Abruf der erforderlichen IDs für die Verknüpfung des Postfachs mit der App-Registrierung

1. Klicken Sie auf die Registerkarte Übersicht und kopieren Sie die Verzeichnis- (Mandanten-) ID (<TENANT_ID>)

2. Suchen Sie in der oberen Suchleiste nach „Microsoft Entra ID“ und klicken Sie darauf

3. Kopieren Sie auf der angezeigten Seite Übersicht den Namen (<APP_DISPLAY_NAME>), die Anwendungs-ID (<APPLICATION_ID>) und die Objekt-ID (<ENTERPRISE_OBJECT_ID>).

4. Erstellen Sie ein neues Postfachkonto oder verwenden Sie ein vorhandenes und kopieren Sie die E-Mail-Adresse (<EMAIL_ADDRESS>), die von Benutzern verwendet wird, um Kalender-Ereignisse zu erstellen.

Schritt 5: Befehle in PowerShell ausführen, um das Postfach zu registrieren

1. Führen Sie abschließend die folgenden Befehle einzeln in PowerShell als Administrator (in Windows) aus, um die zuvor erstellte E-Mail-Adresse mit der App-Registrierung zu verknüpfen.

Install-Module -Name ExchangeOnlineManagement
Import-Module ExchangeOnlineManagement
Connect-ExchangeOnline -OrganizationId "<TENANT_ID>"
New-ServicePrincipal -AppId "<APPLICATION_ID>" -ObjectId "<ENTERPRISE_OBJECT_ID>"
Set-ServicePrincipal -Identity "<ENTERPRISE_OBJECT_ID>" -DisplayName "<APP_DISPLAY_NAME>"
Add-MailboxPermission -Identity "<EMAIL_ADDRESS>" -User "<ENTERPRISE_OBJECT_ID>" -AccessRights FullAccess

Schritt 6: Eine neue Konfiguration für E-Mail Kalendereinladungen über Azure Outlook in Salto IDM einrichten

1. Melden Sie sich bei Salto IDM an. Öffnen Sie dann Administration > Automatisierungen > Automatisierung erstellen

2. Wählen Sie die Umgebung aus, in der die Automatisierung ausgeführt werden soll, fügen Sie einen Namen für sie hinzu und markieren Sie sie als aktiviert

3. Wählen Sie als Zeitplantyp Kalender-Ereignisse und wählen Sie aus, wie oft nach neuen Einladungen gesucht werden soll (z. B. alle 5 Minuten)

4. Wählen Sie auf der rechten Seite Outlook als Protokoll

5. Geben Sie die folgenden Details ein:

   a. E-Mail-Adresse: Das zuvor konfigurierte Postfach

   b. Zeitzone, in der die Umgebung ausgeführt wird

   c. Anwendung (Client-) ID: <APPLICATION_ID>

   d. Client Secret (Wert): Geheimer Schlüssel (Wert), der zuvor erstellt wurde

   e. Verzeichnis-ID (Mandant): <TENANT_ID>

6. Klicken Sie auf Speichern. Wenn alles korrekt ist, sollte eine Erfolgsmeldung angezeigt werden.