SharePoint-Login für Excel-Links in empower® Chart Creation

Betriebssystem: Windows

Benötigte Berechtigungen: Benutzer, IT-Admin

Anmerkung

Dieser Artikel ist für Sie relevant, wenn Sie die Excel-Link-Funktion mit SharePoint oder OneDrive für empower® Charts oder Chart Creation einer Version < 9.6 verwenden.

Zudem sind die nachfolgenden Informationen nur relevant, wenn Sie in ihrem Unternehmen eine SharePoint-Online-Instanz verwenden.

Wenn Ihr Unternehmen eine On-Premises-Instanz von SharePoint verwendet, sind die Informationen in diesem Dokument nicht relevant für Sie.

Es gibt Szenarien, bei denen die unten beschriebene Konfiguration nicht notwendig ist, auch wenn Benutzer mit Excel-Online-Dateien arbeiten.

Diese Szenarien können wie folgt zusammengefasst werden:

  • Arbeiten mit einer geöffneten Excel-Online-Datei

    Die Excel-Online-Datei wird sowohl bei der Erstellung des Excel-Links als auch bei jeder Aktualisierung des Excel-Links auf dem Gerät des Benutzers geöffnet.

  • Arbeiten mit einer lokal synchronisierten OneDrive-Excel-Datei

    Die Excel-Datei befindet sich im OneDrive des Benutzers und wird lokal auf seinem Computer synchronisiert.

Wenn Benutzer in Ihrem Unternehmen nur gemäß den oben beschriebenen Szenarien arbeiten, sind die Informationen in diesem Artikel für Sie nicht relevant.

Kontext

Im Folgenden behandelt dieser Artikel die Excel-Link-Szenarien, für die eine SharePoint-Anmeldung erforderlich ist.

Beispiel: Ein Benutzer möchte ein Chart aktualisieren, das mit einer Excel-Online-Datei verknüpft ist und derzeit nicht auf dem Gerät des Benutzers geöffnet ist.

Zum Arbeiten mit Excel-Online-Dateien wird für empower® ein SharePoint-Login benötigt. Der Grund hierfür ist, dass die Excel-Online-Dateien in diesen Fällen ausschließlich über eine Online-Quelle verfügbar sind und daher von empower® heruntergeladen werden müssen.

Für den Zugriff auf eine solche Online-Quelle muss sich der Benutzer authentifizieren.

Technische Notwendigkeit

Um die Authentifizierung auszuführen, verwendet empower® die Microsoft Authentication Library (MSAL).

Anmerkung

Für weitere Informationen zu MSAL siehe Übersicht über die Microsoft-Authentifizierungsbibliothek (MSAL).

Bei der Verwendung von MSAL werden Benutzer anhand des Microsoft Entra ID-Tenants authentifiziert, in dem die jeweiligen Konten erstellt wurden. Dies ist normalerweise die Microsoft Entra ID Ihres Unternehmens.

Damit empower® die Erlaubnis hat, eine solche Authentifizierung anzufragen, benötigen Sie eine sogenannte App-Registrierung.

Die Art und Weise, wie MSAL arbeitet, erfordert die Verwendung der zuvor genannten App-Registrierung durch empower®, um sich selbst bei der Microsoft Identity Platform als App zu authentifizieren, die autorisiert ist, Authentifizierungs-Token für Benutzer aus der Microsoft Entra ID Ihres Unternehmens zu akzeptieren.

Um eine Verbindung zwischen der App-Registrierung und der Microsoft Entra ID Ihres Unternehmens aufzubauen, ist es notwendig, empower® als sogenannten Service Principal zu registrieren.

Dies ist das von Microsoft vorgeschriebene Standardverfahren.

Weitere Informationen über Service Principals finden Sie unter den folgenden Links:

Anwendungs- und Dienstprinzipalobjekte in Microsoft Entra ID

Wie und warum Anwendungen zu Microsoft Entra ID hinzugefügt werden

Als nächstes müssen dem Service Principal die von der empower® App-Registrierung angefragten Leseberechtigungen erteilt werden. Das kann entweder von allen Benutzern einzeln übernommen werden bei deren ersten Anmeldung oder von einem Azure-Admin für das gesamte Unternehmen.

Registrierung des Service Principals

Je nachdem, wie die Microsoft Entra ID ihres Unternehmens konfiguriert ist, kann das Eintragen des Service Principal entweder automatisch bei der ersten Anmeldung eines Benutzers passieren, oder sie muss manuell durch einen Azure-Admin durchgeführt werden.

Der Service Principal wird immer in der Microsoft Entra ID Ihrer Organisation registriert, wenn ein Benutzer der empower® App-Registrierung Berechtigungen erteilt.

Aus Sicht der Benutzer werden nur die angeforderten Berechtigungen angezeigt, während die Service Principal automatisch von Microsoft in der Microsoft Entra ID Ihres Unternehmens registriert wird.

Anmerkung

Für weitere Informationen zur Erteilung von Berechtigungen siehe Benutzeroberfläche für die Zustimmung für Anwendungen in Microsoft Entra ID.

Berechtigungen, im Zusammenhang mit Microsoft Entra ID auch Scopes genannt, werden bei ihrer Ausgabe in Authentifizierungs-Token eingebettet.

Da empower® Chart Creation im Nachgang diese Authentifizierungs-Token zum Herunterladen der Excel-Dateien verwendet, müssen die Tokens gewisse Leseberechtigungen enthalten.

Alle benötigten Berechtigungen sind bereits in der empower® App-Registrierung konfiguriert.

Die konfigurierten Scopes sind die folgenden:

  • MyFiles.Read

    • Lesezugriff auf die SharePoint/OneDrive-Dateien des Benutzers.

  • AllSites.Read

    • Lesezugriff auf Dateien, die auf verschiedenen Unterwebsites in SharePoint gespeichert sind und nicht direkt in der persönlichen Domäne des Benutzers gespeichert sind.

Alle von der empower® App-Registrierung verwendeten Berechtigungen sind sogenannte delegierte Berechtigungen.

Das Berechtigungssystem von Microsoft funktioniert, indem es eine Schnittstelle zwischen den Berechtigungen des aktuell aktiven Benutzers und den von der empower® App-Registrierung angefragten Berechtigungen erstellt.

Das bedeutet, dass bei der Verwendung von empower® Chart Creation kein Benutzer jemals Zugriff auf Dateien hat, auf die er nicht zugreifen darf.

Anmerkung

Für weitere Informationen zu delegierten Berechtigungen siehe Grundlegendes zum delegierten Zugriff.

Berechtigungen erteilen – Benutzer

Wenn sich ein Benutzer zum ersten Mal anmeldet, öffnet sich ein Fenster.

Der Name der App-Registrierung sowie die angeforderten Berechtigungen sind beispielhaft:

In diesem Fenster werden der Name der App-Registrierung, ihr Herausgeber und die angeforderten Berechtigungen angezeigt.

Wenn der Benutzer auf den Button Akzeptieren klickt, wird die empower® App-Registrierung automatisch als Service Principal in der Microsoft Entra ID Ihres Unternehmens registriert und die angefragten Berechtigungen werden an den aktuellen Benutzer verteilt.

15643105569692-Bildschirmfoto 2023-10-30 um 12.51.44.png

Anmerkung

Um den Vorgang für die Benutzer zu vereinfachen, kann ein Azure-Admin eine unternehmensweite Genehmigung erteilen.

Infolgedessen müssten einzelne Benutzer die oben genannten Schritte nicht ausführen.

Für weitere Informationen siehe unten.

Berechtigungen erteilen – Azure-Admin

Wenn die Benutzer nicht berechtigt sind, die Berechtigungen selbst zu gewähren, oder wenn die Berechtigungen aus anderen Gründen unternehmensweit erteilt werden sollen, kann ein Azure-Admin die Berechtigungen auf eine der folgenden Arten gewähren.

Über empower® anmelden

Um Berechtigungen unternehmensweit zu setzen, während Sie sich selbst anmelden, gehen Sie wie folgt vor:

  1. Melden Sie sich bei empower® als Azure-Admin an.

    Ein Fenster öffnet sich.

  2. Setzen Sie den Haken in dem Kontrollkästchen für Consent on behalf of your organization.

  3. Klicken Sie auf den Button Accept.

Screenshot 2023-10-17 081948.png

Die empower® App-Registrierung wird in der Microsoft Entra ID Ihres Unternehmens registriert und die Berechtigungen werden an alle Benutzer im Unternehmen verteilt.

Browser-Link verwenden

Um unternehmensweit die Berechtigungen über den Browser-Link zu verteilen, gehen Sie wie folgt vor:

  1. Kopieren Sie die Tenant ID der jeweiligen App-Registrierung.

  2. Navigieren Sie zum folgenden Link:

    https://login.microsoftonline.com/[TENANT ID]/adminconsent?client_id=f05a4e72-4760-458e-a39b-88740cdd932e

    Ersetzen Sie den Platzhalter für die Tenant ID durch die Tenant ID der Microsoft Entra ID Ihres Unternehmens.

    Die Client ID muss unverändert bleiben.

  3. Melden Sie sich mit Ihrem Azure-Adminkonto an.

  4. Navigieren Sie zum Tab Enterprise Applications.

    Die empower® App-Registrierung wird angezeigt.

  5. Wählen Sie die empower® App-Registrierung aus.

  6. Klicken Sie unter Permissions auf den Button Grant Administrator Consent.

  7. Wählen Sie außerdem Grant (Scopes: MyFiles.Read and Grant AllSites.Read) für alle Benutzer aus.

Anmerkung

Die App-Registrierung für empower® wird auch benötigt, wenn Sie On-Premises hosten.

War dieser Beitrag hilfreich?

/

Kommentare

0 Kommentare

Zu diesem Beitrag können keine Kommentare hinterlassen werden.