SharePoint einrichten

Um unseren Dienst sicher mit deiner SharePoint-Umgebung zu verbinden, musst du einen Service Principal Name (SPN) in deiner Microsoft Entra ID (früher Azure Active Directory) erstellen und konfigurieren. So wird sichergestellt, dass die Genow-Plattform die notwendigen, eingeschränkten Berechtigungen hat, um auf deine SharePoint-Daten zuzugreifen, ohne dass die persönlichen Anmeldedaten eines Benutzers erforderlich sind.

Wenn du bereits einen SPN für das SSO über Microsoft erstellt hast, kannst du diesen SPN für die Verbindung zu SharePoint wiederverwenden. Das ist besonders dann sinnvoll, wenn du nicht vorhast, mehrere SPNs für verschiedene SharePoint-Sites zu erstellen.

Diese Anleitung führt dich durch den gesamten Prozess, der aus drei Hauptteilen besteht:

Eine App-Registrierung erstellen in Microsoft Entra ID, um die erforderlichen Credentials zu generieren.
API-Berechtigungen konfigurieren, um festzulegen, was die Anwendung tun darf.
Zugriff auf bestimmte SharePoint-Sites gewähren, um den SPN mit den Daten zu verbinden.

Um die Einrichtung abzuschließen, benötigst du die folgenden drei Informationen:

Client ID (Application ID)
Tenant ID (Directory ID)
Client Secret (Application Password)

Wenn du einen neuen SPN erstellst, teile bitte die Client ID, Tenant ID und das Client Secret mit uns, da wir das Mapping über den SPN ebenfalls speichern müssen. Die Informationen werden sicher gespeichert.

Voraussetzungen: Du musst sowohl in Microsoft Entra ID als auch in den Ziel-SharePoint-Sites über Administratorrechte verfügen, um diese Aktionen durchzuführen.

Teil 1: App-Registrierung und Credentials erstellen

Wie erwähnt kannst du denselben SPN für SSO und die SharePoint-Verbindung nutzen. In diesem Fall kannst du diesen Schritt überspringen, benötigst aber die Client ID, Tenant ID und das Client Secret später im Prozess.

Zuerst musst du eine neue Anwendung in deinem Microsoft Entra ID-Portal registrieren. Diese Registrierung repräsentiert die Identität unseres Dienstes innerhalb deiner Microsoft-Umgebung.

Zu App-Registrierungen navigieren:
- Melde dich im Microsoft Entra Admin Center an.
- Gehe im linken Navigationsbereich zu Identität > Anwendungen > App-Registrierungen.
Eine neue Registrierung erstellen:
- Klicke auf + New registration.
- Gib der Anwendung einen aussagekräftigen Namen, zum Beispiel “SharePoint Integration Service”.
- Belasse die übrigen Einstellungen bei ihren Standardwerten und klicke auf Registrieren.
Client ID und Tenant ID speichern:
- Sobald die App erstellt ist, wirst du zu ihrer Seite Übersicht weitergeleitet.
- Kopiere die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant). Speichere sie an einem sicheren Ort, da du sie benötigst, um die Integration in unserer Plattform zu konfigurieren.
Ein Client Secret erstellen:
- Gehe in der Navigation deiner App-Registrierung zu Zertifikate & Geheimnisse.
- Klicke auf den Tab Geheime Clientschlüssel und wähle + New client secret.
- Gib eine Beschreibung ein (z. B. “SharePoint API Key”) und wähle einen Gültigkeitszeitraum.
- Klicke auf Hinzufügen.
WICHTIG: Ein geheimer Wert wird sofort angezeigt. Kopiere diesen Wert jetzt. Nachdem du diese Seite verlassen hast, wird er dauerhaft ausgeblendet. Das ist dein Client Secret.

Teil 2: API-Berechtigungen konfigurieren

Als Nächstes musst du die genauen Berechtigungen festlegen, die die Anwendung benötigt. Wir verwenden die Berechtigung Sites.Selected, die dem Prinzip der geringsten Rechte folgt, indem sie dir erlaubt, den Zugriff nur auf bestimmte SharePoint-Sites statt auf alle zu gewähren.

Zu API-Berechtigungen gehen:
- Wähle im Navigationsmenü deiner App-Registrierung API-Berechtigungen aus.
Eine Berechtigung hinzufügen:
- Klicke auf + Berechtigung hinzufügen und wähle Microsoft Graph aus.
Anwendungsberechtigungen auswählen:
- Wähle Anwendungsberechtigungen. Dieser Typ ist für Dienste erforderlich, die im Hintergrund ohne angemeldeten Benutzer laufen.
Berechtigung Sites.Selected hinzufügen:
- Gib im Suchfeld “Berechtigungen auswählen” Sites.Selected ein.
- Aktiviere das Kontrollkästchen neben Sites.Selected unter der Kategorie “Sites” und klicke auf Berechtigungen hinzufügen.
Administratorzustimmung erteilen:
- Die neu hinzugefügte Berechtigung hat einen Status, der anzeigt, dass eine Administratorzustimmung erforderlich ist.
- Klicke oben in der Berechtigungsliste auf die Schaltfläche Administratorzustimmung für [Name deines Mandanten] erteilen.
- Klicke zur Bestätigung auf Ja. Der Status sollte sich nun auf ein grünes Häkchen aktualisieren, was bedeutet, dass die Berechtigungen auf Mandantenebene aktiv sind.

Teil 3: Zugriff auf SharePoint-Sites gewähren

Der letzte Schritt besteht darin, dem neu erstellten SPN Zugriff auf jede SharePoint-Site zu gewähren, die er lesen muss. Dieser Vorgang muss für jede SharePoint-Site auf oberster Ebene wiederholt werden, die du mit unserem Dienst verwenden möchtest.

Zugriff für eine ausgewählte Site an die SharePoint-App gewähren

Navigiere zu deiner SharePoint-Site und füge ‘_api/site/id’ hinter deinem Site-Namen hinzu. Anschließend sollte die URL so aussehen: genow.sharepoint.com/sites/sitename/_api/site/id in deinem Browser
Notiere dir die Site-ID in der JSON-Antwort wie unten dargestellt. Du benötigst diese Site-ID in weiteren Schritten.
Melde dich beim Microsoft Graph Explorer mit einem Konto an, das über die Rolle SharePoint Administrator oder höher verfügt.
Klicke im Graph Explorer oben rechts auf deinen Avatar.
Wähle “Consent to permissions” und dann “Consent” für Sites.FullControl.All, um dem Graph Explorer-Tool die Möglichkeit zu geben, die Site-Berechtigungen für deinen Mandanten zu ändern.
Sende eine POST-Anfrage an den Endpunkt https://graph.microsoft.com/v1.0/sites/{site_id}/permissions mit dem Request Header Content-Type: application/json und dem Request Body:

body

{
"roles": ["read"],
"grantedToIdentities": [
{
"application": {
"id": "<application_client_id>",
"displayName": "<application_name>"
}
}
]
}

Ersetze site_id, application_client_id und application_name aus den obigen Schritten.

Anzeigen Zugriff über PowerShell

Für Administratoren, die Aufgaben lieber automatisieren oder Berechtigungen für eine große Anzahl von Sites erteilen müssen, ist die SharePoint Online Management Shell eine leistungsstarke und effiziente Alternative zur manuellen Methode über die Benutzeroberfläche.1. Voraussetzungen:

Führe Powershell 7 als Administrator aus
Stelle zunächst sicher, dass du die SharePoint Online Management Shell installiert hast.
Install-Module -Name Microsoft.Online.SharePoint.PowerShell
Installiere das PnP-Modul
Install-Module PnP.PowerShell

2. Die Anwendung registrieren:

  Register-PnPEntraIDAppForInteractiveLogin -ApplicationName "PnP Powershell" -Tenant [yourcompanyname].onmicrosoft.com

3. Über PcPService verbinden:

  Connect-PnPOnline -Url https://[your-tenant]-admin.sharepoint.com/ -ClientId

Du wirst aufgefordert, dich anzumelden.3. Variablen festlegen und Berechtigungen erteilen: Verwende das folgende Skript, um die notwendigen Berechtigungen zu erteilen. Ersetze einfach die Platzhalterwerte durch deine spezifische Client ID und die URL der SharePoint-Site.

$appId = "your-app-id"
$siteUrl = "https://[your-site-url]"
$permission = "Read"

Grant-PnPAzureADAppSitePermission -AppId $appID -Site $siteUrl -Permission $permission -DisplayName “PnP Powershell”

Du hast den SPN jetzt erfolgreich für eine SharePoint-Site konfiguriert. Denk daran, diesen “Teil 3” für alle weiteren benötigten SharePoint-Sites zu wiederholen.

Letzter Schritt

Du hast jetzt erfolgreich einen SPN erstellt und ihm die notwendigen Berechtigungen zugewiesen. Du kannst nun die zuvor gespeicherte Client ID, Tenant ID und das Client Secret verwenden, um die SharePoint-Verbindung in unserer Anwendung zu konfigurieren. Bitte stelle uns diese Variablen zur Verfügung.

Willkommen

Agents erstellen und verwalten

Berechtigungen

Genow-Plattform einrichten und verwalten

Einstellungen & Anpassungen

Teil 1: App-Registrierung und Credentials erstellen

Teil 2: API-Berechtigungen konfigurieren

Teil 3: Zugriff auf SharePoint-Sites gewähren

Letzter Schritt

​Teil 1: App-Registrierung und Credentials erstellen

​Teil 2: API-Berechtigungen konfigurieren

​Teil 3: Zugriff auf SharePoint-Sites gewähren

​Letzter Schritt

Teil 1: App-Registrierung und Credentials erstellen

Teil 2: API-Berechtigungen konfigurieren

Teil 3: Zugriff auf SharePoint-Sites gewähren

Letzter Schritt