# SharePoint Einrichtung

## MAIA und SharePoint – Integrationsanleitung

Diese Anleitung erklärt, wie dir wie SharePoint mit deinem MAIA-Workspace verbunden wird.

***

## Voraussetzungen

* Administrator- / Owner- zugriff auf deine MAIA-Workspace

* Ein Microsoft-Konto mit entsprechenden Berechtigungen für die gewünschten SharePoint-Seiten

* Jeder Benutzer der Arbeitsumgebung muss **sein eigenes Microsoft-Konto** individuell verbinden

***

## Grundprinzipien

* **Tenant-Beschränkung:** Jede MAIA-Workspace kann nur mit **einem einzigen Microsoft-Tenant** verbunden werden. Das **erste verbundene Microsoft-Konto** legt den Tenant für die gesamte Arbeitsumgebung fest.

* **Zugriffsbeschränkung:** Benutzer sehen nur SharePoint-Dateien, auf die ihr verbundenes Microsoft-Konto Zugriff hat.

* **Synchronisierungsmethoden:** Zwei Modi sind verfügbar – **Benutzerbasierte Synchronisierung** und **App-basierte Synchronisierung**.

***

## Schritt 1: Microsoft-Konto verbinden

![](/images/docs/92a932844f6232f8a90a.png)

1. Navigiere zu den `Einstellungen → Integrationen → SharePoint`

2. **(OPTIONAL)** Gib eine eigene Domain ein, mit der du dich verbinden möchtest.

   1. In Microsoft kannst du Gast in einer anderen Organisation (Tenant) sein. Standardmäßig wird deine Heimatorganisation verbunden. Wenn du die richtigen Seiten nicht siehst, kann es daran liegen, dass sie zu einer anderen Organisation gehören, in der du als Gast eingeladen bist.

3. Klicke auf **Account verbinden**

4. Authentifizieren dich mit deinem Microsoft-Zugangsdaten

Durch diese Verbindung wird das Microsoft-Konto mit MAIA verknüpft und der Tenant festgelegt.

***

## Schritt 2: Synchronisierungsmethode wählen

### Option A: Benutzerbasierte Synchronisierung

![](/images/docs/cdc65b6efd3d3435b473.png)![](/images/docs/948bc2c5303bb21936a8.png)

1. Wähle ein Konto aus dem Dropdown-Menü als **Sync-Benutzer**

2. Klicke auf **Sync-Benutzer festlegen**

3. Bestätige die Auswahl im erscheinenden Dialogfenster

**Wichtig:**

* Nur Dateien, die für den Sync-Benutzer sichtbar sind, können synchronisiert werden

* Dateien, auf die der Sync-Benutzer keinen Zugriff hat, sehen auch andere Benutzer in MAIA **nicht**, selbst wenn sie über ihr Microsoft-Konto Zugriff hätten

* Microsoft wendet **rate-limits** für einzelne Benutzerkonten an, was die Synchronisierung verlangsamen kann.

***

### Option B: App-basierte Synchronisierung (empfohlen)

![](/images/docs/dc41aecdde0c5a9d4346.png)

1. Klicke im Abschnitt **„Mit App synchronisieren“** auf **Verbinden**

2. Folge der Anleitung, um MAIA als Enterprise-Anwendung in deinem Microsoft-Tenant zu autorisieren. Bei unklarheiten folge diesem [Guide](/de/docs/maias-features/sharepoint/granting-permissions-in-microsoft-azure/).

**Vorteile:**

* Deutlich höhere API-Ratenlimits bei Microsoft

* Kein regelmäßiges erneutes Einloggen erforderlich

* Ideal für große SharePoint-Umgebungen oder Arbeitsumgebungen mit vielen Benutzern

***

## Schritt 3: SharePoint-Seiten verbinden

![](/images/docs/53067caa150a1deddb48.png)

1. Klicke auf **Seiten verbinden**

2. Wähle eine oder mehrere SharePoint-Seiten aus

3. Klicke auf **Verbinden**

![](/images/docs/9537f79c97e6f789f254.png)

Die verbundenen Seiten erscheinen nun unter **„Verbundene Seiten“**, inkl. Synchronisierungsstatus, Dateianzahl und Speicherverbrauch

***

## Wechsel des Tenants oder der Synchronisierungsmethode

![](/images/docs/30ac5db407d49e20807d.png)

* Ein Wechsel zur **App-basierten Synchronisierung** ist jederzeit möglich, ohne dass die Integration deaktiviert werden muss.

* Wenn du jedoch **von der App-basierten zurück zur benutzerbasierten Synchronisierung** wechseln möchten **oder** den **Microsoft-Tenant ändern** möchten, musst du die SharePoint-Integration vorher deaktivieren.

### Schritte

1. Klicke im Bereich **SharePoint-Integration** auf **Deaktivieren**

2. Dadurch werden **alle verbundenen Microsoft-Konten** von der MAIA-Arbeitsumgebung getrennt

3. Starte die Einrichtung erneut ab **Schritt 1**

4. Das **erste Microsoft-Konto**, das nach der Deaktivierung verbunden wird, bestimmt den neuen Tenant

**Hinweis:** Änderungen am Tenant oder an der Synchronisierungsmethode betreffen alle Benutzer der Arbeitsumgebung.

***

## Abschließende Hinweise

* MAIA-Admins können nur SharePoint-Seiten verbinden, auf die sie über ihr Microsoft-Konto Zugriff haben

* Nur **explizit verbundene Seiten** werden synchronisiert – es erfolgt kein automatischer Datenzugriff

* Inhalte, die die verwendete Synchronisierungsmethode (Benutzer oder App) nicht sehen kann, werden **nicht synchronisiert** und sind in MAIA nicht sichtbar

Die **App-basierte Synchronisierung** wird insbesondere empfohlen für:

* Arbeitsumgebungen mit vielen Benutzer\*innen

* Große SharePoint-Bibliotheken (über 10.000 Dateien)