Zum Inhalt

Microsoft SharePoint

Mit der SharePoint-Integration verbinden Sie einen Ordner aus SharePoint als Mount mit der Evoya-Plattform. Die Evoya-Plattform kann die Dokumente in diesem Ordner anschliessend indexieren und per Vektorsuche durchsuchen. Die Dateien bleiben in SharePoint – Sie müssen sie nicht erneut hochladen.

Voraussetzung: Microsoft-Integrationen müssen für Ihr Konto aktiviert sein

Die SharePoint-Integration funktioniert nur, wenn Microsoft-Integrationen für Ihr Konto auf der Evoya-Plattform aktiviert sind. Wenn Sie Microsoft SharePoint auf der Seite Integrations nicht finden, kontaktieren Sie uns über unser Support-Formular, um die Funktion freischalten zu lassen.


So ist SharePoint aufgebaut

Um einen Mount zu erstellen, müssen Sie wissen, wo Ihre Dateien in SharePoint liegen. SharePoint ist so aufgebaut (siehe Microsoft Learn):

Website  (z. B. https://firma.sharepoint.com/sites/Marketing)
└── Dokumentbibliothek  (z. B. "Dokumente" / "Documents")
    └── Ordner → Unterordner → Dateien
  • Website (Site): Die SharePoint-Website eines Teams oder Projekts. Eine Site ist keine einzelne Seite.
  • Dokumentbibliothek: Eine Site kann Seiten, Listen und eine oder mehrere Dokumentbibliotheken enthalten. Die Evoya-Plattform benötigt nur die Dokumentbibliothek, denn dort sind die Dateien gespeichert.
  • Stammordner: Der Ordner in der Bibliothek, den die Evoya-Plattform verfügbar macht. Alles darunter, inklusive aller Unterordner, ist enthalten.

Beim Erstellen eines Mounts folgen Sie genau diesem Pfad: Authentifizierung → Site → Dokumentbibliothek → Stammordner → Mount-Details.


Einrichtung im Überblick

Die Einrichtung besteht aus vier Teilen. Teil A und B erledigt ein Administrator einmalig. Teil C ist nur nötig, wenn sich Nutzer mit ihrem persönlichen Microsoft-Konto anmelden. Teil D wiederholen Sie für jeden Ordner, den Sie verbinden möchten.

Teil Was Wer Wo
A Microsoft-Anmeldung einrichten (einmalig) Administrator und Microsoft Entra-Administrator Authentication
B Integration aktivieren und Authentifizierungsart wählen Administrator Integrations (Admin-Einstellungen)
C (Optional) Persönliches Microsoft-Konto verbinden Jeder Nutzer Integrations (Nutzerbereich)
D Mount erstellen Nutzer mit Zugriff auf die Seite Files Files

Teil A: Microsoft-Anmeldung einrichten

Die Microsoft-Anmeldung (SSO über Microsoft Entra ID) ist die Verbindung zwischen der Evoya-Plattform und dem Microsoft-Tenant Ihrer Organisation. Solange sie nicht eingerichtet ist, kann niemand die SharePoint-Integration nutzen.

Microsoft-Anmeldung bereits im Einsatz?

Wenn sich Ihre Organisation bereits mit Microsoft bei der Evoya-Plattform anmeldet, ist dieser Teil erledigt. Prüfen Sie auf der Seite Authentication, dass Microsoft als aktiv angezeigt wird, und fahren Sie mit Teil B fort.

Voraussetzungen:

  • Sie haben auf der Evoya-Plattform die Rolle Administrator. Andere Rollen können die Seite Authentication nicht öffnen.
  • Sie sind zusätzlich Microsoft Entra-Administrator im Tenant Ihrer Organisation oder haben eine Person mit dieser Rolle zur Hand. Ohne diese Rolle lässt sich die Einrichtung auf Microsoft-Seite nicht abschliessen.

Schritte:

  1. Öffnen Sie die Seite Authentication.
  2. Fügen Sie Microsoft als Anbieter hinzu und melden Sie sich mit dem Konto des Microsoft Entra-Administrators an.
  3. Bestätigen Sie die Microsoft-Zustimmungsabfrage mit Accept.
  4. Prüfen Sie, dass Microsoft als aktiv angezeigt wird.

Die ausführlichen Schritte finden Sie auf der Seite Authentifizierung.


Teil B: Integration aktivieren

  1. Öffnen Sie die Seite Integrations in den Admin-Einstellungen.
  2. Aktivieren Sie Microsoft SharePoint. Wenn Sie zusätzlich einen Server verbinden möchten, aktivieren Sie auch VM (siehe VM (SSH-Server)).
  3. Wählen Sie, wie sich Nutzer bei SharePoint authentifizieren:
    • Organization service account (Dienstkonto der Organisation): Ein gemeinsames Microsoft-Konto wird für alle Nutzer verwendet. Technisch ist es ein normales Microsoft-Benutzerkonto, es dient aber als allgemeines Konto für alle. Es benötigt Lesezugriff auf die SharePoint-Inhalte, die Sie einbinden möchten.
    • Personal account per user (persönliches Konto pro Nutzer): Jeder Nutzer meldet sich mit seinem eigenen Microsoft-Konto an. Die Evoya-Plattform greift dann mit den Berechtigungen dieses Nutzers auf SharePoint zu.

Welche Option passt?

Dienstkonto der Organisation Persönliches Konto pro Nutzer
Aufwand Gering – ein Konto für alle Jeder Nutzer verbindet sein Konto einmalig (Teil C)
Berechtigungen Alle, die den Mount nutzen, erhalten die Berechtigungen des Dienstkontos Der Zugriff richtet sich nach den SharePoint-Berechtigungen jeder Person
Geeignet für Gemeinsame Team-Inhalte, die alle sehen dürfen Inhalte, bei denen der Zugriff von Person zu Person unterschiedlich ist

Die Berechtigungen des Dienstkontos gelten für alle

Mit dem Dienstkonto kann jeder Nutzer, der mit dem Mount arbeitet, auf alles zugreifen, was das Dienstkonto im gewählten Ordner lesen darf. Geben Sie dem Dienstkonto nur Zugriff auf Inhalte, die alle Nutzer des Mounts sehen dürfen.

Nach der Aktivierung erscheint im Seitenmenü der Menüpunkt Files.


Teil C: Persönliches Microsoft-Konto verbinden

Nur bei persönlichen Konten nötig

Überspringen Sie diesen Teil, wenn Ihre Organisation nur das Dienstkonto der Organisation verwendet.

Wenn der Administrator persönliche Konten erlaubt, verbindet jeder Nutzer sein Microsoft-Konto einmalig:

  1. Öffnen Sie die Seite Integrations im Nutzerbereich (im Seitenmenü unter Custom).
  2. Wählen Sie Microsoft SharePoint und melden Sie sich mit Ihrem Microsoft-Geschäfts- oder Schulkonto an.
  3. Bestätigen Sie die angeforderten Berechtigungen.

Ohne diesen Schritt wird Ihr persönliches Konto im Mount-Assistenten nicht angeboten.


Teil D: Mount erstellen

  1. Öffnen Sie im Seitenmenü Files.
  2. Klicken Sie oben rechts auf Connect.
  3. Wählen Sie SharePoint. Sie sehen nur die Optionen, die der Administrator aktiviert hat: SharePoint und/oder VM.
  4. Klicken Sie oben rechts auf Add mount, um den Assistenten zu starten.

Der Assistent hat fünf Schritte. In jedem Schritt können Sie über den Button Change … zurückgehen.

Schritt 1 von 5: Authentifizierung

Wählen Sie, welches Microsoft-Konto die Evoya-Plattform für diesen Mount verwendet:

  • Organization service account: das gemeinsame Dienstkonto für alle Nutzer.
  • Personal account: Ihr eigenes Microsoft-Konto. Diese Option erscheint nur, wenn Sie Teil C abgeschlossen haben.

Klicken Sie auf Select.

Schritt 2 von 5: Site

  1. Fügen Sie die vollständige URL der SharePoint-Site in das Feld Site name or URL ein, zum Beispiel https://firma.sharepoint.com/sites/Marketing. Mit der vollständigen URL wird die Site am zuverlässigsten gefunden.
  2. Klicken Sie auf Find site.
  3. Klicken Sie beim passenden Ergebnis auf Select.

Um ein anderes Konto zu verwenden, klicken Sie auf Change auth.

Site-URL finden

Öffnen Sie die Site in SharePoint im Browser und kopieren Sie die Adresse bis einschliesslich des Site-Namens, z. B. https://firma.sharepoint.com/sites/Marketing. Lassen Sie alles danach weg, etwa /SitePages/Home.aspx oder /Freigegebene Dokumente/....

Schritt 3 von 5: Dokumentbibliothek

Wählen Sie die Dokumentbibliothek, in der Ihre Dateien liegen. Die Bibliotheken werden mit Namen und Adresse aufgelistet. Die Standardbibliothek heisst Dokumente (auf Englisch: Documents). Eine Site kann mehrere Bibliotheken haben.

Klicken Sie auf Select. Um eine andere Site zu wählen, klicken Sie auf Change site.

Schritt 4 von 5: Stammordner

  1. Navigieren Sie durch die Bibliothek. Mit Open öffnen Sie einen Ordner.
  2. Wenn Sie sich im Ordner befinden, den Sie verfügbar machen möchten, klicken Sie auf Use this folder. Um die ganze Bibliothek zu verwenden, bleiben Sie auf der obersten Ebene der Bibliothek und klicken dort auf Use this folder.

Um eine andere Bibliothek zu wählen, klicken Sie auf Change library.

In der Evoya-Plattform ist nur der Inhalt des gewählten Ordners und alles darunter verfügbar, inklusive Unterordner.

Schritt 5 von 5: Mount-Details

Feld Bedeutung
Mount name * Name des Mounts in der Evoya-Plattform
Description Optionale Beschreibung
Access mode * Zum Beispiel Read only: Die Evoya-Plattform liest die Dateien und verändert sie nicht
Selected location Zusammenfassung von Authentifizierung, Site, Bibliothek und Stammordner. Prüfen Sie die Angaben oder korrigieren Sie sie über Change folder.

* Pflichtfeld

Klicken Sie auf Create mount, um den Mount zu erstellen. Mit Cancel verwerfen Sie ihn.


Fehlerbehebung

Problem Lösung
Microsoft SharePoint fehlt auf der Seite Integrations Microsoft-Integrationen sind für Ihr Konto noch nicht aktiviert. Kontaktieren Sie uns über unser Support-Formular.
Einrichtung der Microsoft-Anmeldung schlägt fehl Sie benötigen sowohl die Rolle Administrator auf der Evoya-Plattform als auch die Rolle Microsoft Entra-Administrator in Ihrem Tenant (Teil A).
«Files» oder «Connect» fehlt Der Administrator hat die Integration noch nicht aktiviert (Teil B).
Ihr persönliches Konto wird nicht angeboten Verbinden Sie es zuerst im Nutzerbereich (Teil C) und prüfen Sie, ob der Administrator persönliche Konten erlaubt.
Site wird nicht gefunden Prüfen Sie die URL: Sie muss auf die Site zeigen, nicht auf eine Seite oder einen Ordner darin. Prüfen Sie, ob das gewählte Konto Zugriff auf die Site hat.
Eine Bibliothek oder ein Ordner fehlt Das gewählte Konto hat keinen Zugriff darauf. Prüfen Sie die Berechtigungen in SharePoint oder wählen Sie ein anderes Konto.

Verwandte Themen