Konfigurieren der Diagramm-API (Excel, OneDrive)

Anforderungen

• Ein Office 365-Administratorkonto
• Rechte zur Erteilung von API-Berechtigungen
• Ein Dienstkonto mit OneDrive-Zugang

Innerhalb von Azure

Registrierung einer Bewerbung

1. Gehen Sie zu portal.azure.com und melden Sie sich mit einem Administratorkonto an.
2. Gehen Sie zu Azure Active Directory
3. Zu den App-Registrierungen gehen
4. Klicken Sie auf + Neue Registrierung
   1. Geben Sie dieser Anwendung einen Namen, zum Beispiel: GoBright Ansicht
   2. Unterstützte Kontotypen: Nur Konten in diesem Organisationsverzeichnis (Single Tenant)
   3. Klicken Sie auf Registrieren
      

Ein Kundengeheimnis erstellen

1. Öffnen Sie die App, die Sie gerade registriert haben
2. Gehe zu Bescheinigungen & Geheimnisse
3. Gehe zu Kundengeheimnisse
4. Klicken Sie auf + Neues Kundengeheimnis
   1. Beschreibung - Geben Sie ihm eine Beschreibung
   2. Läuft ab - legen Sie ein Ablaufdatum fest
   3. Markieren Sie dieses Datum in Ihrem Kalender und denken Sie daran, das Geheimnis zu erneuern, bevor es abläuft
   4. Notieren Sie sich den Geheimwert, da dieser nur einmal angezeigt wird. Dieser Wert wird später in GoBright View benötigt. Die Secret ID brauchen wir nicht.
      Wenn Sie den Secret Value vergessen haben, löschen Sie diesen Client Secret und erstellen Sie einen neuen.

API-Berechtigungen festlegen

1. Öffnen Sie die Anwendung, die Sie gerade erstellt haben
2. Gehen Sie zu API-Berechtigungen
3. Client + Berechtigung hinzufügen
4. Wählen Sie Microsoft Graph
5. Wählen Sie Delegierte Berechtigungen
6. Fügen Sie diese Berechtigungen hinzu:
   1. Directory.AccessAsUser.All (Delegiert)
   2. Files.Read.All (delegiert)
   3. Benutzer.Lesen (delegiert)
7. Klicken Sie auf Admin-Zustimmung für [Azure-Domäne] erteilen
8. Zur Übersicht
   1. Notieren Sie die Anwendungs-(Client-)ID
   2. Notieren Sie die Verzeichnis-ID (Mieter)

Ein Dienstkonto erstellen

1. Gehen Sie zu Azure Active Directory
2. Zu den Benutzern gehen
3. Klicken Sie auf + Neuer Benutzer und dann auf + Neuen Benutzer anlegen
   1. Vorlage auswählen - Benutzer anlegen
   2. Identität
      1. Benutzername - zum Beispiel: gobright-view@[Azure-Domain]
      2. Name - zum Beispiel: GoBright Dienstkonto anzeigen
   3. Passwort
      1. Wählen Sie Automatisch generiertes Passwort oder Lassen Sie mich das Passwort erstellen
      2. Notieren Sie das Passwort
   4. Klicken Sie auf Erstellen
   5. Öffnen Sie den Benutzer
   6. Zu Lizenzen gehen
   7. Klick + Zuweisungen
      1. Wählen Sie Microsoft 365 Business Basic
         . Diese Lizenz beinhaltet den OneDrive-Zugang, den wir benötigen.
      2. Speichern anklicken

Sie sollten nun über diese Informationen verfügen:

1. Anwendung (Client) ID
2. Verzeichnis (Mieter) ID
3. Geheimer Wert des Kunden
4. Benutzername des Dienstkontos
5. Passwort des Dienstkontos

Dies waren alles Schritte, die von einem Azure-Administrator durchgeführt werden müssen. Bitte stellen Sie diese Anmeldeinformationen denjenigen zur Verfügung, die mit der Einrichtung fortfahren. Lesen Sie die folgenden Anleitungen, um fortzufahren:

Excel 365

OneDrive-Diashow

Anforderungen

• Ein Office 365-Administratorkonto
• Rechte zur Erteilung von API-Berechtigungen

Innerhalb von Azure

Zur Konfiguration der Graph-API sind die folgenden Schritte erforderlich:

Registrierung einer Bewerbung

• https://portal.azure.com/#home
• Navigieren Sie zu Azure Active Directory
• Presse App-Registrierungen
  
• Eine neue Registrierung erstellen
• Geben Sie einen Namen ein (z. B. GoBright Ansicht)
• Belassen Sie die anderen Einstellungen auf den Standardwerten und klicken Sie auf die Schaltfläche " Registrieren" am unteren Rand.

Berechtigungen festlegen

• Öffnen Sie die Anwendung und drücken Sie die API-Berechtigungen anzeigen Taste
  
• Klicken Sie auf die Schaltfläche " Erlaubnis hinzufügen " und ein neues Fenster wird geöffnet
• Wählen Sie Microsoft Graph, wenn Sie zur Eingabe einer API aufgefordert werden.
• Setzen Sie den Typ der Berechtigung auf Anwendungsberechtigungen
• Es wird eine lange Liste von Berechtigungen angezeigt. Je nachdem, welche Anwendungen Sie verwenden, müssen die folgenden Berechtigungen erteilt werden:
  • APIConnectors.Read.All - Typ: Anwendung - Zur Authentifizierung
  • Anwendung.Lesen.Alle - Typ: Anwendung - Für die Navigation
  • Directory.Read.All - Typ: Anwendung - Für die Navigation zwischen verschiedenen Ordnern
  • Files.Read.All - Typ: Anwendung - Verwendet von OneDrive
  • Reports.Read.All - Typ: Anwendung - Verwendet von Excel
  • Sites.Read.All - Typ: Anwendung - Verwendet von SharePoint

    Vergewissern Sie sich, dass die Berechtigungen als "Anwendungsberechtigungen" erteilt werden.

• Wenn die richtigen Berechtigungen hinzugefügt wurden, drücken Sie die Erteilung der Verwaltungsgenehmigung Taste
  

Sammeln Sie alle Informationen und erstellen Sie ein Kundengeheimnis

Um eine Verbindung mit der Anwendung herstellen zu können, benötigt GoBright View drei Informationen:

• Kunden-ID: Diese finden Sie auf der Übersichtsseite
• Client Secret: Muss unter Zertifikate & Geheimnisse erstellt werden
• Mieter-ID: Diese finden Sie auf der Übersichtsseite

Kopieren wir zunächst die Kunden-ID und die Mieter-ID aus der Übersicht in der Anwendung. Diese sind oben auf der Seite zu finden:

Als Nächstes folgt der Client Secret Value, für den wir zu Zertifikate & Geheimnisse gehen müssen .

Das Client Secret besteht aus einer ID und einem Wert, wobei wir den Wert benötigen.

• Erstellen Sie ein neues Kundengeheimnis am Ende dieser Seite
• Sie können eine Beschreibung hinzufügen(z. B. Verwendung innerhalb von GoBright View)
• Wählen Sie, wann der Schlüssel abläuft(Hinweis: Wir empfehlen, das Ablaufdatum so weit in der Zukunft wie möglich festzulegen. Bitte setzen Sie auch eine Erinnerung zur Erneuerung des Schlüssels.
• Wenn das Kundengeheimnis erstellt wurde, kopieren Sie sofort den Geheimwert und notieren Sie ihn, da er nur einmal angezeigt wird. Wenn Sie den Wert nicht erhalten haben, können Sie diese Schritte löschen, um einen neuen Wert zu erstellen. Wir brauchen die Secret ID nicht.

Das sind alle Informationen, die wir brauchen. Als nächstes können wir diese Informationen im GoBright Widget verwenden.