Wechseln zu:Navigation, Suche
Wiki































Konfiguration im Azure AD, um mit dem UMA auf dessen Benutzer zugreifen zu können

Neu:

  • Client-Secret ID aus dem Azure-AD erforderlich



Letzte Anpassung zur Version: 3.2 (11.2021)




Voraussetzungen

  • Benutzer im Azure AD mit zu Archivierenden Mail-Adressen

Konfiguration Azure AD

Folgende Schritte sind notwendig:

  • Im Azure AD muss das Securepoint UMA NG als neue App registriert werden
  • Folgende Berechtigungen sind erforderlich:

    • MS-Graph / Delegierte Berechtigung:
      • User.Read (sollte als Default-Berechtigung bereits existieren)
    • MS-Graph / Anwendungsberechtigungen:
      • Group.Read.All
      • MailboxSettings.Read
      • User.Read.All
      • Application.Read.All
  • Der App muss ein Geheimer Clientschlüssel hinzugefügt werden
  • Um neben der originären Microsoft Azure E-Mail Adresse weitere Mailadressen zu archivieren, müssen diese im Benutzer-Profil im Azure Active Directory im Abschnitt Kontaktinformationenen als Alternative E-Mail-Adresse hinterlegt werden.

    Die Anmeldung des Benutzers bzw. der Benutzerin im Securepoint UMA NG erfolgt dann mit dem Benutzerprinzipalnamen (user pricipal name) und dem dazugehörigen Kennwort aus dem Azure AD.
UMA v3.3.1 Azure Dashboard.png
UMA v3.3.1 Azure Dashboard.png
UMA v3.3.1 Azure AD App-Registrierungen.png
Menü App-Registrierungen
UMA v3.3.1 Azure AD Neue Registrierung.png
Schaltfläche + Neue Registrierung
UMA v3.3.1 Azure AD Anwendung registrieren.png
  • Aussagekräftigen Namen vergeben
  • Option Nur Konten in diesem Organisationsverzeichnis (einzelner Mandant)
  • Eine Umleitungs-URI ist nicht erforderlich
  • Schaltfläche Registrieren
UMA v3.3.1 Azure AD API Berechtigungen.png
  • Folgende Werte werden im Securepoint UMA später benötigt:
    • Anwendungs-ID (Client-ID)
    • Verzeichnis-ID (Mandant)
    • Client-Secret-ID
  • Auswahl Menü API-Berechtigungen
UMA v3.3.1 Azure AD API Berechtigungen hinzufügen.png
  • Schaltfläche + Berechtigung hinzufügen
  • Die Berechtigung User.Read vom Typ Delegierte Berechtigung sollte als Default-Berechtigung bereits eingetragen sein
UMA v3.3.1 Azure AD API Berechtigungen MS Graph.png
  • Schaltfläche Microsoft Graph
UMA v3.3.1 Azure AD API Anwendungsberechtigungen.png
  • Schaltfläche Anwendungsberechtigungen
UMA v3.3.1 Azure AD API Anwendungsberechtigung GroupReadAll.png
  • API-Berechtigung Group.Read.All markieren
  • In der Suchleiste kann die Anzeige der Berechtigungungen eingegrenzt werden.
    So lässt sich schneller die benötigte Berechtigung finden.
  • UMA v3.3.1 Azure AD API Anwendungsberechtigung MailboxSettingsRead.png
    • API-Berechtigung MailboxSettings.Read markieren
  • Die zuvor markierte Berechtigung bleibt auch dann markiert, wenn sie durch einen anderen Begriff in der Suchleiste nicht mehr angezeigt wird
  • UMA v3.3.1 Azure AD API Anwendungsberechtigung UserReadAll.png
    • API-Berechtigung User.Read.All markieren
    • Schaltfläche Berechtigungen hinzufügen
    UMA v3.3.1 Azure AD Anwendungsberechtigung Application.read.all.png
    • API-Berechtigung Application.Read.All markieren Neu ab 3.1.3
    • Schaltfläche Berechtigungen hinzufügen
    UMA v3.3.1 Azure AD API Anwendungsberechtigung Administratorzustimmung.png
  • Wurde bisher ohne Globale Adminstratorberechtigung gearbeitet, ist nun die Zustimmung eines Solchen erforderlich
  • UMA v3.3.1 Azure AD API Anwendungsberechtigung Administratorzustimmung Ja.png
    • Administratorberechtigung erteilen
    UMA v3.3.1 Azure AD API Anwendungsberechtigungen konfiguriert.png
    • Konfigurierte API-Berechtigungen
    UMA v3.3.1 Azure AD Zertifikate.png
    • Menü Zertifikate & Geheimnisse
    UMA v3.3.1 Azure AD Neuer Geheimer Clientschlüssel.png
    • Schaltfläche + Neuer geheimer Clientschlüssel
    UMA v3.3.1 Azure AD Geheimen Clientschlüssel hinzufügen.png
    • Aussagekräftigen Namen vergeben
    • Gewünschte Gültigkeitsdauer auswählen
      Der Geheime Clientschlüssel muss rechtzeitig erneuert werden. Nach Ablauf des Gültigkeitszeitraumes werden keine E-Mails mehr an das UMA zugestellt und Benutzer des UMA DMS können nicht mehr durch das Azure AD authentisiert werden.
    • Schaltfläche Hinzufügen
    UMA v3.3.1 Azure AD Geheimer Clientschlüssel.png
    • Es wird in der Spalte Wert der Client Secret angezeigt
    • Es wird in der Spalte Geheime ID die Client ID angezeigt
  • Der Wert Client Secret wird später nicht wieder angezeigt und muss daher an anderer Stelle gesichert werden.
    Neu ab 3.1.3 Beide Werte werden für die Konfiguration im Securepoint UMA benötigt.
  • UMA v3.3.1 Azure Benutzer Prinzipal AltMail.png
    • Um neben der originären Microsoft Azure E-Mail Adresse weitere Mailadressen zu archivieren, müssen diese im Benutzer-Profil im Azure Active Directory im Abschnitt Kontaktinformationenen als Alternative E-Mail-Adresse hinterlegt werden.

      Die Anmeldung des Benutzers bzw. der Benutzerin im Securepoint UMA NG erfolgt dann mit dem Benutzerprinzipalnamen (user pricipal name) und dem dazugehörigen Kennwort aus dem Azure AD.




    Die vorbereitende Konfiguration des Azure AD ist damit abgeschlossen



    Konfiguration im UMA

    Im Einrichtungsassistenten

    Beschriftung Wert Beschreibung UMA v3.3.1 Einrichtungsassistent Schritt3 Azure AD.png
    Azure AD Zugangsdaten im Schritt 3 des Einrichtungsassistenten
    Repository Type Azure AD Azure Active Directory als Authentifizierungs-Quelle auswählen
    ••••••• Verzeichnis-ID (Mandant) aus der App-Registrierung im Azure ADUMA v3.1 Azure AD App-IDs.png
    Anwendungs-ID (Client-ID): ••••••• Anwendungs-ID (Client-ID) aus der App-Registrierung im Azure AD
    Geheimer Wert: ••••• Wert des geheimen Clientschlüssels aus dem Abschnitt Zertifikate & Geheimnisse des Azure ADs
    Geheime-ID: ••••• Neu ab 3.1.3 Geheime ID des geheimen Clientschlüssels aus dem Abschnitt Zertifikate & Geheimnisse des Azure ADs
    Azure Cloud: Azure Cloud Global

    Azure Cloud USA

    Azure Cloud Deutschland

    Azure Cloud China
    Auswahl der Azure Cloud, die das AD hostet
    Weiter Überprüft die Zugangsdaten und ruft den nächsten Schritt auf


    Im Menu E-Mail Konten

    Menu System-Einstellungen / E-Mail Konten
    Beschriftung Wert Beschreibung UMA v3.3.1 System-Einstellungen E-Mail-Konten.png
    Konfiguration im Admin Interface
    Benutzer Repository Azure AD Azure Active Directory als Authentifizierungs-Quelle auswählen
    ••••••• Verzeichnis-ID (Mandant) aus der App-Registrierung im Azure ADUMA v3.1 Azure AD App-IDs.png
    Anwendungs-ID (Client-ID): ••••••• Anwendungs-ID (Client-ID) aus der App-Registrierung im Azure AD
    Geheimer Wert: ••••• Wert des geheimen Clientschlüssels aus dem Abschnitt Zertifikate & Geheimnisse des Azure ADs
    Geheime-ID: ••••• Neu ab 3.1.3 Geheime ID des geheimen Clientschlüssels aus dem Abschnitt Zertifikate & Geheimnisse des Azure ADs
    Azure Cloud: Azure Cloud Global

    Azure Cloud USA

    Azure Cloud Deutschland

    Azure Cloud China
    Auswahl der Azure Cloud, die das AD hostet
    Azure AD Einstellungen Testen Überprüft die Zugangsdaten und öffnet ein Fenster, in dem alle verfügbaren Benutzerkonten auf dem Server angezeigt werden. Die Listen (Public und Private) lassen sich durchsuchen. UMA v3.1 System-Einstellungen E-Mail Konten AzureAD Testen.png
    Benutzerkonten auf dem Server
































    Auswahl einzelner Konten (nur einzelne Konten archivieren)
    Auswahl einzelner Konten (nur einzelne Konten archivieren)
    Manuelle Auswahl aktivieren Mit Auswahl dieser Option lässt sich die Archivierung auf einzelne Konten beschränken
  • Beim Entfernen von Mail-Konten aus der Archivierung ist zu beachten, ob rechtliche Vorschriften zur Aufbewahrung davon berührt sind !
  • UMA 3.2 Konten AD Auswahl einzelner Konten.png
    Archivierte Benutzerkonten
    Archivierte Benutzerkonten
    Abonnements verwalten
    Ermöglicht Lese-Berechtigung auf public-Folder

    UMA 3.2 Konten AD Abonnements verwalten.png
    UMA 3.2 Konten AD Archivierte Benutzerkonten.png
    Erweiterte Einstellungen anzeigen
    Weitere Funktionen nach Aktivieren:
    Benutzer bearbeiten
    Aktion:
    Verschieben
    Bei einer Verschiebung wird das Archiv-Postfach umbenannt und/ oder der Typ geändert.
    Dient z.B. dazu,Zugriff auf Archiv-Ordner zu ermöglichen, deren Besitzer im AD inaktiv gesetzt oder gelöscht wurden: Ein privat-Archiv wird zu public geändert. Anschließend kann das Archiv unter Abonnements verwalten einem aktiven Benutzer zugänglich gemacht werden
    UMAv3.3 Konten LDAP Benutzer verschieben.png
    Dialog Benutzer bearbeiten
    Neuer Name: Neuer Archivname. Wird der Benutzername nicht im Azure-AD geändert, ist kein direkter Zugriff auf das Archiv mehr möglich
    Neuer Typ: Typ des Benutzerpostfaches: private oder public
    Begründung: Die Begründung wird im Log festgehalten und bleibt zeitlich unbefristet einsehbar
    Aktion:
    Zusammenführen
    Überträgt die archivierten Mails eines Archiv-Kontos auf ein anderes Archiv-Konto
  • Existiert das Benutzerkonto weiterhin unverändert im Azure-AD, werden neu eintreffende Mails wieder im ursprünglichen Archiv empfangen
  • UMAv3.3 Benutzer Zusammenführen.png
    Zusammenführen von Benutzerkonten
    Daten übertragen zu: typ/zielkonto Benutzerkonto, auf das die Mails übertragen werden sollen
    Begründung: Die Begründung wird im Log festgehalten und bleibt zeitlich unbefristet einsehbar
    Löschen Beim Löschen von Mail-Konten aus der Archivierung ist zu beachten, ob rechtliche Vorschriften zur Aufbewahrung davon berührt sind!
    Um unbeabsichtigte bzw. falsche Löschungen zu verhindern, muss zusätzlich das Administratorpasswort angegeben werden.
    UMA 3.2 Konten AD Benutzer löschen.png
    Dialog Benutzer löschen
    UMA 3.2 Konten AD Admin-Passwort.png
    Admin-Passwort überprüfen
    LDAP Sucheinstellungen
    LDAP Sucheinstellungen
    Referrals
    LDAP-Referrals stellt einen Verweis auf einen alternativen Standort bereit, an dem eine LDAP-Anfrage verarbeitet werden kann.
    Eine Aktivierung ist nur in extrem seltenen Fällen sinnvoll und sollte in der Regel vermieden werden.
    UMA v3.2 Konten LDAP Sucheinstellungen.png
    LDAP Sucheinstellungen



    Troubleshooting

    Fehlermeldungen bei Testen der Azure AD Einstellungen:


    Fehlermeldung Beschreibung
    Unzureichende Berechtigungen, um den Vorgang abzuschließen. In dem Fall unbedingt prüfen, ob alle Berechtigungen korrekt gesetzt wurden
    Der angeforderte Benutzer ist ungültig. Selbsterklärend. Benutzernamen müssen vorhanden und zulässig sein.
    Nicht zulässig ist z.B.: '@ttt-point.onmicrosoft.com
    Es wurden zu viele Anfragen gestellt. Bitte versuchen Sie es später noch einmal. Throttling. Passiert nur selten bis niemals. Die Microsoft Graph-API verkraftet sehr viele Requests in kurzer Zeit. Wenn nicht, hilft es, etwas zu warten.
    Nicht lizenzierter Benutzer. E-Mails werden erst zugestellt, wenn Sie eine gültige Lizenz zugewiesen haben. Tritt auf, wenn der abgefragte Account keine gültige Lizenz hat. Das führt dazu, dass das Attribut mailboxSettings nicht abgefragt werden kann. Dies ist erforderlich, um zu prüfen, ob es sich bei dem Account um eine Shared-Mailbox handelt. Kann das Attribut nicht abgefragt werden, ist ungewiss ob der Account nach public oder private archiviert werden muss.
    Ein unbekannter Fehler ist aufgetreten. Dies ist das Fallback, wenn der Fehler nicht identifiziert werden konnte. Das kann in ganz seltenen Fällen passieren. Die Microsoft Graph-API schickt in unglaublich seltenen Situationen kein valides json. Bitte erneut probieren.