# Eine SharePoint-Verbindung erstellen

{% hint style="warning" %}
**Achtung:** Bevor Sie verbinden **SharePoint**, stellen Sie bitte sicher, dass Sie bereits die [**Entra ID-Integration**](/de/fur-administratoren/klassische-microsoft-integrationen/entra-id-integration.md)**!**
{% endhint %}

## 1. **Neue Sites-Admin-App erstellen**

Gehen Sie zur Übersichtsseite und beschaffen Sie sich die `Anwendungs-(Client-)ID` und `Verzeichnis-(Mandanten-)ID`. \
Speichern Sie diese Informationen in einer Textdatei.

{% hint style="success" %}
Wir benötigen in diesem Schritt die Admin-App nur, um Ihrer Ziel-App Berechtigungen zuzuweisen; die Zugangsdaten werden nicht dauerhaft gespeichert. Optional können Sie die Admin-App auch nach dem vollständigen Einrichtungsprozess löschen.
{% endhint %}

<details>

<summary>Möchten Sie immer noch Admin-App-Berechtigungen vermeiden?</summary>

Wenn Sie es vorziehen, keine Admin-App-Berechtigungen zu erteilen, integrieren Sie bitte mit[Manuelle Einrichtung einer SharePoint-Site](/de/fur-administratoren/klassische-microsoft-integrationen/eine-sharepoint-verbindung-erstellen/manuelle-einrichtung-einer-sharepoint-site.md).&#x20;

*(Dies erfordert, dass Sie **PnP PowerShell** oder **Microsoft Graph API** verwenden, um der App manuell Zugriff auf bestimmte SharePoint-Websites zu gewähren)*

</details>

<figure><img src="https://t36648312.p.clickup-attachments.com/t36648312/92a29ac3-7b40-4d77-b9e7-72fd26615fe8/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://t36648312.p.clickup-attachments.com/t36648312/3c40fcb3-5f24-4931-a469-ff9d5cce622e/image.png" alt=""><figcaption></figcaption></figure>

## **2. Graph-API-Berechtigung erteilen**

1. Navigieren Sie zu `API-Berechtigung` und `+ Eine Berechtigung hinzufügen` dort. Verwenden Sie die `Anwendungsberechtigung` Option dort.                &#x20;

<figure><img src="https://t36648312.p.clickup-attachments.com/t36648312/3fb0629b-574a-49cb-b950-e55db328c37c/image.png" alt=""><figcaption><p>Verwenden Sie immer Anwendungsberechtigungen statt delegierter Berechtigungen</p></figcaption></figure>

2. Gewähren Sie in der Sites-Admin-App-Registrierung Graph-API-Berechtigungen für **`Application.Read.All`, `Sites.FullControl.All`.**&#x20;

<details>

<summary>Wichtig: Warum Sites.FullControl.All?</summary>

Die weitreichenden Rechte (Sites.FullControl.All) werden nur für die einmalige Einrichtung benötigt. Konkret:

1. **Admin-Anwendung:**

* Die Admin-App benötigt Sites.FullControl.All nur, um der Zielanwendung die erforderlichen Berechtigungen zuzuweisen.
* Die Zugangsdaten der Admin-App werden nicht dauerhaft gespeichert.

2. **Nach der Einrichtung:**

* Im laufenden Betrieb greift nur die Zielanwendung auf SharePoint zu – und nur auf die tatsächlich relevanten Websites.
* Die Rechte der Zielanwendung sind entsprechend eingeschränkt.

3. **Optional:**

* Die Admin-App kann sogar nach Abschluss der Einrichtung wieder gelöscht werden.

**Fazit:**\
Die umfangreichen Rechte sind nur vorübergehend und nur für die Erstkonfiguration notwendig. Im anschließenden Betrieb werden nur die minimal erforderlichen Rechte verwendet.

</details>

<figure><img src="/files/a5e28a6b596cb6dd467f748a18ae47a8e002c54b" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/51a03a65c3c93017f9046f374c056356cb2388b1" alt=""><figcaption></figcaption></figure>

3. Klicken Sie mit Administratorrechten auf den **`Administratorzustimmung erteilen`** Link, um die Berechtigungen zu genehmigen.

<figure><img src="/files/3ed44345906946e8ffa3fe1695fac6b6b25269f1" alt=""><figcaption></figcaption></figure>

## 3. Einen Client-Secret-Schlüssel erstellen

1. Navigieren Sie zur **`Zertifikate & Geheimnisse`** Seite, um Client-Geheimnisse zu erstellen.

<figure><img src="https://t36648312.p.clickup-attachments.com/t36648312/9bb5a567-3bfb-4310-acb0-0b7f0e180957/image.png" alt=""><figcaption></figcaption></figure>

2. Kopieren Sie den **Geheimer Schlüsselwert** (NICHT die Secret-ID) in die Textdatei mit der Client-ID und der Mandanten-ID.

<figure><img src="https://t36648312.p.clickup-attachments.com/t36648312/5ce7a77c-fff2-4e54-ba79-b60da6227d12/image.png" alt=""><figcaption></figcaption></figure>

3. Ihre Textdatei sollte jetzt enthalten

<pre><code><strong>Client-ID: 4dbceba4-*******-960918801231
</strong>Client-Geheimnis: JPz******************
Verzeichnis-(Mandanten-)ID: cef6ac5c-7bc6-*****-fdf0
</code></pre>

## **4. Eine zusätzliche Zielanwendung erstellen**

1. Führen Sie die gleichen Schritte wie oben aus, um eine weitere Anwendung zu registrieren, die als Zielanwendung für die SharePoint-Integration dient.
2. Stellen Sie sicher, dass diese Anwendung ebenfalls **`Sites.Selected`** Berechtigungen hat.

<figure><img src="/files/8f54f255589d418f1060d226c735812bd409733c" alt=""><figcaption></figcaption></figure>

3. Erstellen Sie nach der Registrierung einen neuen **Geheimer Schlüsselwert** (NICHT die Secret-ID) und speichern Sie ihn. Ihre Textdatei der Ziel-App sollte jetzt Folgendes enthalten:

<pre><code><strong>Client-ID: 1ad09322-6c74-*****-8d736a2d9e92
</strong>Client-Geheimnis: Npn******************
Verzeichnis-(Mandanten-)ID: cef6ac5c-7bc6-*****-fdf05232c2f4
</code></pre>

## **5. SharePoint-Integration in Blockbrain konfigurieren**

{% hint style="warning" %}
**Achtung:** Zu diesem Zeitpunkt werden Sie 2 konfigurierte Azure-Apps haben (Admin und Ziel). \
Falls nicht, gehen Sie zurück zu Schritt [#id-4.-create-an-additional-target-application](#id-4.-create-an-additional-target-application "mention").
{% endhint %}

1. Greifen Sie auf das **`Integrationen`** Panel in Blockbrain zu, indem Sie auf die **`Admin`** Schaltfläche in der oberen rechten Ecke des Bildschirms klicken.&#x20;

<figure><img src="/files/882cd4bbc79f918acbf64667c9aec2d568d4a610" alt=""><figcaption></figcaption></figure>

2. Klicken Sie im Bereich Integrationen auf die SharePoint-Integrationen **`Verbinden`** Schaltfläche, um mit der Einrichtung der Integration zu beginnen.

<figure><img src="/files/a3701f410ec7abae9e7e868e56d98f45485d4813" alt=""><figcaption></figcaption></figure>

3. Wählen Sie die **`SharePoint-Site-Erkennung (Admin-Schlüssel erforderlich)`** Option.

{% hint style="warning" %}
**Achtung:** Wenn Sie es vorziehen, keine Administratorzugriffsrechte mit der **`SharePoint-Site-Einrichtung (Kein Admin-Schlüssel)`** Option zu gewähren, lesen Sie bitte[Manuelle Einrichtung einer SharePoint-Site](/de/fur-administratoren/klassische-microsoft-integrationen/eine-sharepoint-verbindung-erstellen/manuelle-einrichtung-einer-sharepoint-site.md).&#x20;
{% endhint %}

<figure><img src="/files/d2f6108ad5544f1e1dcb730584783fb206b60a8f" alt=""><figcaption></figcaption></figure>

4. Geben Sie den **Details der Azure-Admin-App** im Popup-Fenster nach, das zur Konfiguration der Integration erscheint.

* **`Anwendungs-(Client-)ID`** (Admin-App)
* **`Geheimer Schlüsselwert`** (NICHT die Secret-ID - der Admin-App)
* **`Verzeichnis-(Mandanten-)ID`** (Admin-App)

<figure><img src="/files/ec33f561428c1f1068262c7296f6c60ec08f1e83" alt=""><figcaption></figcaption></figure>

5. Rufen Sie alle verfügbaren Sites ab, indem Sie auf **`Sites abrufen`**&#x6B;licken. Das System zeigt eine Liste von SharePoint-Sites an, mit denen Sie sich verbinden können.

<figure><img src="/files/e561626c8088e415d8ebca615c64396c03d07465" alt=""><figcaption></figcaption></figure>

6. Wählen Sie aus der Liste der verfügbaren Sites **diejenigen aus, die Sie integrieren möchten** mit Blockbrain. Mehrere Sites können ausgewählt werden, indem Sie auf jede Option klicken. Klicken Sie auf die **`Weiter`** Schaltfläche, um abzuschließen.

{% hint style="success" %}
Sie können die verbundenen Sites später jederzeit ändern, indem Sie in dieser Ansicht neue auswählen oder die Auswahl der Sites aufheben, die Sie trennen möchten.
{% endhint %}

<figure><img src="/files/a7323adf58ffce5273a21ab2bb426222ddc008ec" alt=""><figcaption></figcaption></figure>

7. Geben Sie im letzten Konfigurationsbildschirm die **Details der Ziel-Azure-App aus** [#id-4.-create-an-additional-target-application](#id-4.-create-an-additional-target-application "mention") ein und klicken Sie auf die **`Speichern`** Schaltfläche, um die Verbindung herzustellen.

* **`Anwendungs-(Client-)ID`** (Ziel-App)
* **`Geheimer Schlüsselwert`** (NICHT die Secret-ID - der Ziel-App)

<figure><img src="/files/5307ac5d3c26061909ce2bab8d487d8117049bb3" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Warnung vor Datenverbindungstrennung:**

Beachten Sie, dass **alle Daten im alten SharePoint-Ordner getrennt werden** wenn Sie mit der Integration fortfahren. Stellen Sie sicher, dass Sie bereit sind, den alten Ordner zu trennen, bevor Sie speichern.
{% endhint %}

## 6. Eine SharePoint-Site als Wissensdatenbank verbinden

1. Um eine Site mit einer Wissensdatenbank zu verbinden und mit einem Bot zu verwenden, befolgen Sie die Anweisungen in [Eine SharePoint-Site als Wissensdatenbank verbinden](/de/fur-administratoren/klassische-microsoft-integrationen/eine-sharepoint-verbindung-erstellen/eine-sharepoint-site-als-wissensdatenbank-verbinden.md)

## Best Practices & Fehlerbehebung <a href="#id-5.-best-practices-and-troubleshooting" id="id-5.-best-practices-and-troubleshooting"></a>

* **Genauigkeit der Anmeldedaten**\
  Überprüfen Sie **`Client-ID`**, **`Client-Geheimschlüssel`**, und **`Mandanten-ID`** mit Ihrer Azure-AD-App.
* **API-Berechtigungen**\
  Bestätigen Sie, dass der Azure-AD-App die erforderlichen Graph-Berechtigungen erteilt wurden und diese genehmigt wurden.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.en.theblockbrain.ai/de/fur-administratoren/klassische-microsoft-integrationen/eine-sharepoint-verbindung-erstellen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.