SharePoint einrichten

Die SharePoint-Integration von Intric nutzt Microsoft Graph mit dem Berechtigungsbereich Sites.Selected für den Zugriff auf SharePoint-Daten. Das bedeutet:

• Standardmäßig kein Zugriff: ohne explizite Konfiguration hat die App keine Berechtigungen für SharePoint-Sites oder deren Inhalte
• Kontrolle auf Site-Ebene: ein Entra-Mandantenadministrator legt genau fest, auf welche Sites die App zugreifen darf. Die App kann keine anderen Sites sehen oder mit ihnen interagieren
• Delegierte Berechtigungen: die App handelt im Namen des angemeldeten Benutzers. Auch innerhalb einer freigegebenen Site kann der Benutzer nur auf Dateien und Ordner zugreifen, für die er bereits Berechtigungen in SharePoint hat
• Suche aktiviert: sobald der Zugriff auf eine Site erteilt wurde, können Benutzer Dateien innerhalb dieser Site durchsuchen

Wenn sich jemand verbindet, fordert Intric die delegierten Berechtigungen Sites.Selected, User.Read und offline_access an. Für Sites.Selected verlangt Microsoft eine Administratorzustimmung. Erteile sie deshalb für die Intric-App in Entra (Unternehmensanwendungen → Intric → Berechtigungen → Administratorzustimmung erteilen), bevor sich die Nutzenden verbinden.

Den Zugriff auf einzelne Sites erteilst du über Microsoft Graph Explorer (https://developer.microsoft.com/graph/graph-explorer) oder entsprechende Tools. Du musst Administrator:in in deinem Entra-Mandanten sein, um diese Schritte durchzuführen.

Schritt 1: Deine Site(s) finden

Voraussetzung: Du benötigst Sites.Read.All mit Zustimmung im Graph Explorer für diesen Schritt.

Suche nach Sites mit einem Stichwort:

GET https://graph.microsoft.com/v1.0/sites?search=marketing

Beispielantwort:

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites",
  "value": [
    {
      "id": "example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740",
      "displayName": "Marketing Site",
      "name": "marketing",
      "webUrl": "https://example.sharepoint.com/sites/marketing",
      "createdDateTime": "2023-01-15T10:30:00Z"
    }
  ]
}

Notiere das Feld id der Site, für die du den Zugriff erteilen möchtest. In diesem Beispiel lautet die Site-ID:

example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Verwende ?search=*, um alle Sites aufzulisten.

Schritt 2: Der Intric-App Zugriff auf die Site erteilen

Voraussetzung: Du benötigst Sites.FullControl.All mit Zustimmung im Graph Explorer für diesen Schritt.

Die SharePoint-App von Intric hat folgende Konfiguration:

Feld	Wert
Anwendungs-ID	a1162fb9-a25e-4bd3-9c55-e7a46a085536
Anzeigename	Intric

Verwende die Site-ID aus Schritt 1:

POST https://graph.microsoft.com/v1.0/sites/example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740/permissions
Content-Type: application/json

{
  "roles": ["read"],
  "grantedToIdentities": [{
    "application": {
      "id": "a1162fb9-a25e-4bd3-9c55-e7a46a085536",
      "displayName": "Intric"
    }
  }]
}

Verwende "roles": ["read"]. Jede SharePoint-Aktion in Intric ist schreibgeschützt, daher würde "write" der App mehr Rechte geben, als sie nutzt.

Wiederhole diesen Vorgang für jede Site, für die du den Zugriff erteilen möchtest.

Schritt 3: Die Sites in Intric hinzufügen

Nachdem du der Intric-App in Microsoft Graph Zugriff auf deine SharePoint-Site(s) erteilt hast, füge diese Sites in Intric hinzu:

1. Öffne Admin und wähle unter Platform den Eintrag KI-Tools
2. Öffne SharePoint und schalte Für deine Organisation verfügbar ein
3. Öffne Erlaubte Sites und klicke auf Site hinzufügen
4. Fülle die drei Felder aus:
   • Name – der Name, unter dem Nutzende und der Assistent die Site sehen
   • Website-ID – die id der Site, für die du in Schritt 2 den Zugriff erteilt hast
   • Beschreibung – optional, aber lohnend: Der Assistent liest sie, um zu entscheiden, in welcher Site er sucht. Schreib also, was die Site enthält

Format der Site-ID:

• Verwende die vollständige Site-Kennung aus Microsoft Graph – das Feld id –, nicht die Site-URL aus dem Browser
• Sie besteht aus drei Teilen, durch Kommas getrennt: dem Hostnamen der Site-Sammlung, der ID der Site-Sammlung und der ID der Site
• Beispiel: example.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Wiederhole das für jede Site, die du in Intric verfügbar machen möchtest.

Danach findet der Assistent die Dokumentbibliotheken, Ordner und Dateien in den freigegebenen Sites selbst. Nutzende, die ihr Microsoft-Konto verbinden, können diese Sites dann in Gesprächen mit Assistenten nutzen, für die die SharePoint-Integration aktiviert ist.

Jede Site, die du hinzufügst, steht jedem Assistenten mit SharePoint zur Verfügung, sofern die Person, die den Assistenten erstellt, ihn nicht unter Konfigurieren → Auf bestimmte Sites beschränken eingrenzt.

Schritt 4: Funktionen und Klassifizierung prüfen

Im selben Bereich listet Funktionen die vier Aktionen auf: Laufwerke auflisten, Dateien auflisten, Dateiinhalt abrufen und Suchen. Alle vier sind schreibgeschützt und stehen standardmäßig auf Auto, laufen also ohne Rückfrage bei den Nutzenden. Du kannst jede davon auf Fragen oder Aus stellen; siehe Funktionen und Genehmigung.

Du kannst der Integration auch eine Sicherheitsklassifizierung geben. Dann können sie nur Assistenten in Spaces mit passender Klassifizierung nutzen.

Zugriff widerrufen

Um den Zugriff der App auf eine Site zu entfernen, liste zunächst die Berechtigungen auf:

GET https://graph.microsoft.com/v1.0/sites/{siteId}/permissions

Suche den Berechtigungseintrag für die Intric-App und lösche ihn dann:

DELETE https://graph.microsoft.com/v1.0/sites/{siteId}/permissions/{permissionId}

Die App verliert sofort den Zugriff auf diese Site und alle ihre Inhalte.