Facility-Management

IC2657 - Mailabruf mit Daten aus Microsoft Entra ID konfigurieren

Hinweis: Microsoft hat ab dem 1. Oktober 2022 die Basic-Auth (Standardauthentifizierung) deaktiviert. Modern Authentication verwendet das als sicher geltende Protokoll OAuth 2.0.

Du kannst den Abruf von E-Mails im FM-Portal durch die Einstellung von vier Konfigurationsparametern aktivieren. Modern Authentication stellst du dabei durch Nutzung des Konfigurationsparameters "SmtpUseOAuth" ein.

Musst du in derMicrosoft Entra ID die Anmeldung am FM-Portal noch einrichten, findest du weitere Informationen hier.

Voraussetzungen:

  • Du verfügst sowohl in eurem Office-Konto als auch im eTASK.FM-Portal über Administrationsrechte.

Vorgehensweise

  1. Melde dich auf https://portal.azure.com mit deinen Microsoft-Zugangsdaten an.

  2. Klicke auf Microsoft Entra ID.

    Screenshot des Bereichs auf der Startseite von portal.azure.com, über den man zur Verwaltung des Active Directorys kommt. Unten einem Bild mit einem geschlossenen Schloss, einem blauen Schild und zwei Computern steht der Text "Azure Active Directory verwalten" und darunter "Verwakten Sie den Zugriff, legen Sie intelligente Richtlinien fest, und erhöhen Sie die Sicherheit mit Azure Active Directory". Darunter gibt es die Button "Anzeigen" und rechts daneben "Weitere Informationen".

  3. Klicke links im Menü auf App-Registrierungen

  4. Öffne die Übersicht.

  1. Melde dich in deinem eTASK.FM-Portal an und gehe zu Systemsteuerung - Portal-Optionen - Portal-Verwaltung - Systemkonfiguration.

    Übersicht der App-Registrierungen in MS Azure

    1. Öffne den Systemparameter "AZURECLIENTID". Den Wert für den Systemparameter "AZURECLIENTID" findest du in der Übersicht als "Anwendungs-ID (Client)". Füge die dort hinterlegte ID als Konfigurationswert in den Parameter ein und klicke in der Arbeitsleiste auf Speichern.

    2. Öffne den Systemparameter "AZURETENANTID". Den Wert für den Systemparameter "AZURETENANTID" findest du in der Übersicht als "Verzeichnis-ID (Mandant)". Füge die dort hinterlegte ID als Konfigurationswert in den Parameter ein und klicke in der Arbeitsleiste auf Speichern.

    3. Öffne den Systemparameter "AZURELOGINAKTIV". Trage im Merkmal Konfigurationswert eine 1 ein. Klicke in der Arbeitsleiste auf Speichern.

      Hinweis: Ist der Wert dieses Systemparameters 1 und ist im Parameter "AZURECLIENTID" ein Wert vorhanden, wird auf der Anmeldemaske die Azure-Schaltfläche angezeigt.

    4. Öffne nun den Systemparameter "SMTPUSEOAUTH". Trage im Merkmal Konfigurationswert eine 1 ein. Dies sorgt dafür, dass nun Modern Authentication genutzt wird. Klicke in der Arbeitsleiste auf Speichern.

  1. Klicke im Microsoft Entra ID Center auf Unternehmensanwendungen.

  2. Klicke auf Neue Anwendung.

    Screenshot Azure Active Directory Admin Center mit Markierung auf Neue Anwendung

  3. Klicke auf Eigene Anwendung erstellen.

    Screenshot Azure AD-Katalog durchsuchen mit Markierung auf Eigene Anwendung erstellen

  4. Klicke in der Kachel Benutzer und Gruppen zuweisen auf Berechtigte Benutzer hinzufügen.

    Klicke auf Benutzer/Gruppe hinzufügen und füge die Benutzer wie gewünscht hinzu.

    Screenshot Office365ExchangeOnline Übersicht mit Markierung auf Benutzer und Gruppen zuweisen

  5. Stelle unter Eigenschaften der Anwendung den Regler bei Aktiviert für die Benutzeranmeldung? auf Ja.

    Screenshot Eigenschaften mit Markierung auf Aktiviert für die Benutzeranmeldung, Ja aktiviert

  6. Füge bei Berechtigungen durch Klick auf Anwendungsregistrierung die gewünschten Berechtigungen hinzu.

    Screenshot mit Markierung auf Berechtigungen und Anwendungsregistrierung

  7. Trage unter API-Berechtigungen folgende Berechtigungen ein:

    • EWS AccessAsUser.All

    • Mail.ReadWrite

    • User.Read

    ""

  8. Klicke auf Authentifizierung. Stelle unten unter Erweiterte Einstellungen den Regler bei Öffentliche Clientflows zulassen auf Ja.

    Screenshot Erweiterte Einstellung mit Markierung auf Öffentliche Clientflows zulassen, Ja ist aktiviert

  9. Klicke auf Speichern.

Du hast den Mailabruf mit den Daten aus Microsoft Entra ID für dein eTASK.FM-Portal eingerichtet.