Skip to main content

SharePoint & OneDrive — Add from SharePoint

Mit dieser Integration hängen Ihre Benutzer Dateien aus SharePoint-Websites (einschließlich Teams-Websites), aus OneDrive und aus Mit mir geteilt direkt im Chat an, über die Option Add from SharePoint der Schaltfläche zum Anhängen. Die Einrichtung erfolgt per Self-Service: Ein Administrator Ihrer Organisation registriert SecureAI als Anwendung in Ihrem eigenen Microsoft-Entra-ID-Verzeichnis und trägt die Bezeichner unter Admin → Integrations → Files ein. Es ist weder ein Ticket noch eine Wartezeit auf Hiper AI nötig: Die Option erscheint im Chat, sobald Sie die Konfiguration speichern. Geschätzte Dauer: 10 Minuten.

So funktioniert es

  1. Der Benutzer klickt auf Attach → Add from SharePoint. Beim ersten Mal fordert Microsoft ihn auf, sich mit seinem eigenen Microsoft-365-Konto anzumelden.
  2. Der SecureAI-Explorer wird über Microsoft Graph geöffnet: Websites, Bibliotheken, Ordner, Suche und für den Benutzer freigegebene Dateien. Der Benutzer wählt eine oder mehrere Dateien aus.
  3. Der Browser des Benutzers lädt nur die ausgewählten Dateien mit dem Token des Benutzers herunter und hängt sie an die Nachricht an.
  4. Die Datei durchläuft denselben Weg wie jeder Anhang: Sie durchläuft die DLP und die Richtlinien Ihrer Organisation, bevor sie ein Modell erreicht.
Delegierte Berechtigungen, niemals Anwendungsberechtigungen. SecureAI handelt immer im Namen des angemeldeten Benutzers: Ein Benutzer sieht und hängt nur an, was er in SharePoint bereits öffnen kann. Die Anwendung ist eine „Single-Page-Anwendung” (SPA) ohne Client-Secret, und SecureAI liest nichts im Hintergrund.

Voraussetzungen

  • Eine Entra-ID-Rolle, die das Registrieren von Anwendungen und das Erteilen der Administratorzustimmung für Microsoft-Graph-Berechtigungen erlaubt (zum Beispiel Cloudanwendungsadministrator oder Globaler Administrator).
  • Administratorzugriff auf SecureAI mit der Berechtigung Administrator für den Bereich Integrations.
  • Ein SecureAI-Tarif, der Attach from Drive / SharePoint enthält. Ohne ihn können Sie die Konfiguration vorbereiten, aber die Benutzer sehen die Option nicht.

Schritt 1: Umleitungs-URI aus SecureAI kopieren

  1. Melden Sie sich als Administrator bei SecureAI an.
  2. Wechseln Sie zu Admin → Integrations und filtern Sie nach der Kategorie Files.
  3. Klicken Sie auf der Karte SharePoint & OneDrive auf Connect integration.
  4. Klicken Sie im Abschnitt 1. Register SecureAI in Microsoft Entra ID neben dem Redirect URI auf Copy.
Redirect URI im SecureAI-Seitenbereich
Der URI ist die Adresse Ihrer Instanz, zum Beispiel https://<ihr-unternehmen>.hiperai.ai. Verwenden Sie immer den URI, den Ihre Instanz anzeigt: Er muss exakt übereinstimmen.

Schritt 2: Anwendung in Entra ID registrieren

  1. Öffnen Sie das Microsoft Entra Admin Center und wechseln Sie zu Identität → Anwendungen → App-Registrierungen (Identity → Applications → App registrations).
  2. Klicken Sie auf Neue Registrierung (New registration).
App-Registrierungen → Neue Registrierung
  1. Füllen Sie aus:
    • Name: zum Beispiel SecureAI — Add from SharePoint.
    • Unterstützte Kontotypen (Supported account types): Nur Konten in diesem Organisationsverzeichnis (Accounts in this organizational directory only; einzelner Mandant).
    • Umleitungs-URI (Redirect URI): Wählen Sie in der Dropdownliste Single-Page-Anwendung (SPA) (Single-page application) und fügen Sie den URI ein, den Sie in Schritt 1 kopiert haben.
  2. Klicken Sie auf Registrieren (Register).
Die Plattform muss Single-Page-Anwendung (SPA) sein, nicht Web. Bei Web schlägt die Anmeldung mit dem Fehler AADSTS9002326 fehl. Wenn Sie sie bereits als Web registriert haben, wechseln Sie zu Authentifizierung (Authentication), fügen Sie eine Plattform Single-Page-Anwendung mit demselben URI hinzu und entfernen Sie die Web-Plattform.
  1. Kopieren Sie auf der Übersicht (Overview) der Anwendung die Anwendungs-ID (Client) (Application (client) ID) und die Verzeichnis-ID (Mandant) (Directory (tenant) ID). Es muss kein Client-Secret erstellt werden.
Anwendungs-ID und Verzeichnis-ID

Schritt 3: Microsoft-Graph-Berechtigungen hinzufügen

  1. Wechseln Sie in der Anwendung zu API-Berechtigungen → Berechtigung hinzufügen → Microsoft Graph → Delegierte Berechtigungen (API permissions → Add a permission → Microsoft Graph → Delegated permissions).
  2. Suchen und markieren Sie:
    • Files.Read.All — die Dateien lesen, auf die der Benutzer Zugriff hat.
    • Sites.Read.All — die SharePoint-Websites auflisten und durchsuchen, auf die der Benutzer Zugriff hat.
  3. Klicken Sie auf Berechtigungen hinzufügen (Add permissions). User.Read ist standardmäßig bereits hinzugefügt; belassen Sie sie.
Delegierte Berechtigungen von Microsoft Graph

Schritt 4: Administratorzustimmung erteilen

  1. Klicken Sie unter API-Berechtigungen auf Administratorzustimmung für <Ihre Organisation> erteilen (Grant admin consent for <org>) und bestätigen Sie mit Ja.
  2. Alle drei Berechtigungen müssen den Status Gewährt für <Ihre Organisation> haben.
Administratorzustimmung erteilt
Ohne diesen Schritt würde jeder Benutzer eine Zustimmungsanfrage sehen (oder einen Fehler AADSTS65001, wenn Ihre Organisation die Zustimmung durch Benutzer nicht erlaubt).

Schritt 5: In SecureAI eintragen, testen und aktivieren

  1. Kehren Sie zum Seitenbereich SharePoint & OneDrive in SecureAI zurück.
  2. Fügen Sie unter 2. Paste the identifiers die Directory (tenant) ID und die Application (client) ID ein.
  3. Unter 3. Test it:
    • Test connection prüft von den SecureAI-Servern aus, dass das Verzeichnis existiert.
    • Try signing in öffnet dasselbe Microsoft-Fenster, das Ihre Benutzer sehen werden: Melden Sie sich mit Ihrem Konto an. SecureAI bestätigt, dass der Umleitungs-URI vom Typ SPA ist, dass für Files.Read.All und Sites.Read.All eine Zustimmung vorliegt und dass Microsoft Graph antwortet.
Grüne Tests im SecureAI-Seitenbereich
  1. Lassen Sie unter 4. die Option Show “Add from SharePoint” to users aktiviert und klicken Sie auf Save.
Die Karte wechselt zu Available in the chat.

Schritt 6: So verwenden Ihre Benutzer es

  1. Im Chat klickt der Benutzer auf die Schaltfläche zum Anhängen und wählt Add from SharePoint.
Add from SharePoint im Anhängen-Menü
  1. Beim ersten Mal klickt er auf Sign in with Microsoft und wählt sein Konto der Organisation.
  2. Er navigiert durch Sites, Shared oder die Suche, wählt eine oder mehrere Dateien aus und klickt auf Add.
  3. Die Dateien erscheinen an die Nachricht angehängt, mit dem SharePoint-Symbol.

Einschränken, wer es verwenden darf (optional)

Damit nur bestimmte Benutzer oder Gruppen Add from SharePoint verwenden können:
  1. Wechseln Sie in Entra zu Unternehmensanwendungen (Enterprise applications) und öffnen Sie die von Ihnen registrierte Anwendung.
  2. Aktivieren Sie unter Eigenschaften (Properties) die Option Zuweisung erforderlich? (Assignment required?) und speichern Sie.
  3. Weisen Sie unter Benutzer und Gruppen (Users and groups) die berechtigten Benutzer oder Gruppen zu.
Ein nicht zugewiesener Benutzer erhält bei der Anmeldung den Fehler AADSTS50105 und kann keine Dateien anhängen.

Fehlerbehebung

Häufig gestellte Fragen

Was kann SecureAI lesen? Nur das, was der angemeldete Benutzer bereits lesen kann, und nur, wenn er im Explorer eine Datei auswählt. Die Berechtigungen sind delegiert: SecureAI hat keinen Zugriff „als Anwendung” auf Ihr SharePoint. Funktionieren Richtlinien für bedingten Zugriff? Ja. Die Anmeldung ist eine normale Microsoft-365-Anmeldung und berücksichtigt MFA, verwaltete Geräte und Ihre übrigen Richtlinien. Wie deaktiviere ich es? Deaktivieren Sie Show “Add from SharePoint” to users und speichern Sie, oder klicken Sie auf Remove configuration. Um auch bereits ausgestellte Token zu widerrufen, löschen Sie die App-Registrierung in Entra ID oder deaktivieren Sie die Anmeldung für Ihre Unternehmensanwendung. Hiper AI hatte SharePoint bereits für mich konfiguriert. Muss ich etwas tun? Nein. Solange Sie keine eigene Konfiguration speichern, zeigt die Karte Configured by Hiper AI an und alles funktioniert unverändert weiter. Wenn Sie Ihre eigene speichern, ersetzt sie diese.