Show/Hide Toolbars

Erforderliche Berechtigung

Als erstes muss sichergestellt werden, dass der verwendeter Azure Benutzer als Global Administrator berechtigt ist.

Neue Azure Anwendung Docusnap Office 365 erstellen

Die Docusnap Office 365 Inventarisierung benötigt zwingend eine registrierte Anwendung (Application Registration), die berechtigt ist, lesend auf die Microsoft Office 365 Informationen zuzugreifen. Dieses Kapitel beschreibt wie diese Anwendung erstellt wird. In diesem Beispiel wird die Anwendung mit „Docusnap Office 365“ bezeichnet. Der Name ist frei wählbar.

Die App erstellen / registrieren

  • in der RessourcenĂĽbersicht oder der Suche das Azure Active Directory auswählen
  • Ansicht Azure Active Directory > im Bereich Verwalten den Punkt App-Registrierungen auswählen
  • klicken Sie auf den MenĂĽpunkt Neue Registrierung

Docusnap-Inventarisierung-Azure-Vorbereitung-Anwendung-erstellen-Registrieren-Anwendung

Anwendung registrieren

Für die Registrierung der Anwendung werden die folgenden Angaben benötigt:

  • Name: Den Anwendungsnamen Docusnap Office 365 eingeben
  • UnterstĂĽtzte Kontotypen: Hier wird gewählt wer die Anwendung verwenden kann – Nur Konten in diesem Organisationsverzeichnis auswählen

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-Anwendung-anlegen

Anwendungs- und Verzeichnis-ID ermitteln

Nachdem die Erstellung abgeschlossen ist, wird der Ăśbersichtsdialog der Anwendung angezeigt. Kopieren Sie sich nun die Anwendungs- und Verzeichnis-ID und notieren Sie sie fĂĽr den Docusnap Scandialog.

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-Anwendungs-ID-kopieren

Geheimen ClientschlĂĽssel erzeugen und fĂĽr den Docusnap Scandialog notieren

Erstellen Sie nun einen geheimen Clientschlüssel. Wählen Sie hierfür im Bereich Verwalten den Punkt Zertifikate & Geheimnisse

  • Neuer geheimer ClientschlĂĽssel
  • Hinterlegen Sie eine Beschreibung und
  • die GĂĽltigkeit des ClientschlĂĽssels

Hinweis: Bitte beachten Sie, dass der SchlĂĽssel nur direkt nach dem Erstellen einsehbar ist. Geht der SchlĂĽssel verloren oder wird ungĂĽltig, muss dieser neu erstellt werden.

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-SchlĂĽssel-erzeugen

Anwendung autorisieren

Nun muss die Anwendung fĂĽr die Windows Azure Service Management API berechtigt werden.

  • •Wählen Sie im Bereich Verwalten den Punkt API-Berechtigung
  • •Berechtigung hinzufĂĽgen
  • •Microsoft Graph

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-Anwendung-API-auswählen

Als Art der Berechtigung, die erteilt werden soll, wählen Sie Anwendungsberechtigung.

Suchen Sie im Anschluss die Berechtigung Directory.Read.All und fĂĽgen diese Berechtigung hinzu.

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-Anwendung-autorisieren

Nun müssen Sie noch die Einwilligung für die zuvor gesetzten Berechtigungen erteilen. Wählen Sie hierfür das Steuerelement Administratorzustimmung für “Ihr Abonnement“ erteilen aus.

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-Einwilligung-erteilen

Alternative: PowerShell Script

Alternativ kann auch ein PowerShell Script verwendet werden, um die oben beschriebenen Schritte durchzufĂĽhren.

Das Script befindet sich im Installationsverzeichnis von Docusnap

C:\Program Files\Docusnap 11\Tools\scripts\ o365.key.creation.ps1

Wichtig: Das PowerShell Script muss als Administrator ausgefĂĽhrt werden!

  • PowerShell Script als Administrator starten
  • Eventuelle Bibliotheken nachladen und AusfĂĽhrungsdialoge bestätigen
  • Im erscheinenden Fenster einloggen

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-PowerShell-Login

  • Name fĂĽr die Applikation vergeben: Docusnap Office 365

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-PowerShell-Application-Name

  • Im Anschluss werden alle benötigten Informationen (Application ID, Directory ID und Key) ausgegeben
  • Wichtig – kopieren Sie sich die angezeigten IDs - der Key ist im Nachgang nicht mehr zu finden

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-PowerShell-Inventarisierungsdaten

  • Rufen Sie die angezeigte URL im Browser auf – melden Sie sich an und bestätigen Sie die Berechtigungen

Docusnap-Inventarisierung-Azure-Vorbereitung-Office365-PowerShell-Zugriff-bestätigen