Einrichtung

7 Schritte in Microsoft 365, danach liest die App einen Ordner auf einer SharePoint-Site.

Wer macht das?

Diese Schritte macht eine Person mit Admin-Rechten in Microsoft 365. Die App liest danach nur einen Ordner auf genau einer SharePoint-Site.

1. App registrieren
Öffnen Sie entra.microsoft.com → Identität → Anwendungen → App-Registrierungen → «Neue Registrierung».
Name z.B. «SURF LOCAL Sync». Kontotyp: «Nur Konten in diesem Organisationsverzeichnis». Keine Umleitungs-URI nötig.
Notieren Sie auf der Übersichtsseite die Verzeichnis-ID (Mandant) und die Anwendungs-ID (Client).
2. Berechtigung Sites.Selected hinzufügen
In der App: API-Berechtigungen → Berechtigung hinzufügen → Microsoft Graph → Anwendungsberechtigungen → Sites.Selected.
Keine anderen Berechtigungen hinzufügen.
3. Administratorzustimmung erteilen
Auf derselben Seite «Administratorzustimmung für … erteilen» klicken. Der Status muss grün «Gewährt» zeigen.
4. Geheimen Clientschlüssel erstellen
Zertifikate & Geheimnisse → «Neuer geheimer Clientschlüssel». Laufzeit wählen (z.B. 12 Monate).
Kopieren Sie sofort den Wert (nicht die ID). Er wird nur einmal angezeigt. Erinnerung für den Ablauf setzen.
5. Lesezugriff auf die Site geben (Graph Explorer)
Öffnen Sie den Graph Explorer und melden Sie sich als SharePoint- oder Global-Admin an. Unter «Berechtigungen ändern» Sites.FullControl.All zustimmen.
a) Site-ID holen: GET https://graph.microsoft.com/v1.0/sites/joloogmbhch.sharepoint.com:/sites/SURFLOCALMigration → Feld id kopieren.
b) Berechtigung setzen: POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissions mit diesem Inhalt:
```
{
  "roles": ["read"],
  "grantedToIdentities": [{
    "application": { "id": "<Anwendungs-ID>", "displayName": "SURF LOCAL Sync" }
  }]
}
```
Antwort «201 Created» bedeutet: erledigt.
6. Secrets in Lovable eintragen
Projekteinstellungen → Secrets. Folgende fünf Werte eintragen:
- MS_TENANT_ID – Verzeichnis-ID (Mandant)
- MS_CLIENT_ID – Anwendungs-ID (Client)
- MS_CLIENT_SECRET – Wert des geheimen Clientschlüssels
- SP_SITE_PATH – z.B. joloogmbhch.sharepoint.com:/sites/SURFLOCALMigration
- SP_FOLDER_PATH – Ordner in «Dokumente», z.B. Batchdaten
7. Testen
Auf der Übersicht «Jetzt abgleichen» drücken. Die Verbindung sollte «OK» zeigen. Danach läuft der Abgleich alle 15 Minuten automatisch.

Was speichert die App?

Datenschutz: Die App speichert nur Blattnamen, Zeilenzahlen, Spaltenüberschriften und ja/nein-Zählungen, keine Zellinhalte. Dateien werden nicht dauerhaft gespeichert.