--- title: "OAuth-Login via ChurchTools bei Nextcloud" description: "Dieses Tutorial erklärt dir, wie du deine eigene Nextcloud so konfigurierst, dass du dich mit dem ChurchTools-Login als OAuth-Server in der Nextcloud einloggen kannst. Dabei werden Gruppen- und, wenn gewünscht, Gruppenrollen-Informationen übernommen. Du kannst in ChurchTools über die Rechteverwaltung definieren,…" url: "https://staging.churchtools.academy/de/help/system-einstellungen/oauth-login-systemeinstellungen/oauth-login-via-churchtools-bei-nextcloud/" updated: "2026-07-03" category: Login / OAuth --- # OAuth-Login via ChurchTools bei Nextcloud Dieses Tutorial erklärt dir, wie du deine eigene Nextcloud so konfigurierst, dass du dich mit dem ChurchTools-Login als OAuth-Server in der Nextcloud einloggen kannst. Dabei werden Gruppen- und, wenn gewünscht, Gruppenrollen-Informationen übernommen. Du kannst in ChurchTools über die Rechteverwaltung definieren, wer sich in der Nextcloud einloggen darf. Mehr Details zur Konfiguration von OAuth findest du auf unserer Hilfeseite [OAuth zwischen zwei ChurchTools-Systemen](https://staging.churchtools.academy/de/help/system-einstellungen/oauth-login-systemeinstellungen/oauth-zwischen-zwei-churchtools-systemen/) und den dort verlinkten Seiten. **Achtung** Wir stellen dir diese Hilfeseite sehr gern als Unterstützung zur Verfügung und pflegen sie nach bestem Wissen. Bitte hab aber Verständnis: Sobald es um Funktionen, Einstellungen oder Änderungen in **Drittsystemen** wie NextCloud geht, können wir **nicht garantieren**, dass alle Angaben jederzeit **aktuell, vollständig oder korrekt** sind – darauf haben wir schlicht keinen direkten Einfluss. Maßgeblich sind daher immer die offiziellen Informationen und Dokumentationen des jeweiligen Anbieters. Wenn du bei der Umsetzung irgendwo hängenbleibst oder dir etwas widersprüchlich vorkommt: Melde dich gern bei uns – wir helfen dir, die passenden nächsten Schritte zu finden, können aber keine Zusagen für Verfügbarkeit, Verhalten oder Support von Drittanbietern machen. ## 1. Nextcloud als OAuth-Client eintragen Der erste Schritt ist, die Nextcloud als OAuth-Client in den System-Einstellungen zu hinterlegen. Öffne dazu über das *Verwaltungsmenü* (1) die *System-Einstellungen* (2). In der Seitenleiste findest du im Abschnitt *Allgemein* den Eintrag *Login* (3). Hier kannst du einen neuen *OAuth-Client* (4) hinzufügen. [![Systemeinstellungen Login](https://staging.churchtools.academy/wp-content/uploads/2024/12/Edit-Docs-„OAuth-Login-via-ChurchTools-bei-Nextcloud-‹-ChurchTools-Academy-–-WordPress-2025-12-29-at-15.10.36-scaled.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/Edit-Docs-„OAuth-Login-via-ChurchTools-bei-Nextcloud-‹-ChurchTools-Academy-–-WordPress-2025-12-29-at-15.10.36-scaled.png) Als Name wählst du am besten den Namen des Drittsystems, in diesem Fall also „Nextcloud“. Dieser Name wird auch später den Nutzern angezeigt, um klarzumachen, in welchem System sie sich gerade anzumelden versuchen. [![Maske OAuth-Client hinzufügen](https://staging.churchtools.academy/wp-content/uploads/2024/12/CTC-2025-12-29-at-15.25.57.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/CTC-2025-12-29-at-15.25.57.png) ChurchTools erstellt nun die notwendigen Verbindungsdaten für die Anbindung des NextCloud-Clients. In unserem Screenshot siehst du die URL unseres ChurchTools-Systems https://beispiel.church.tools. In deinem System wird entsprechend die URL deines ChurchTools angezeigt. [![OAuth-Client Konfiguration](https://staging.churchtools.academy/wp-content/uploads/2024/12/CTC-2025-12-29-at-15.30.49.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/CTC-2025-12-29-at-15.30.49.png) Die Redirect-URI musst du über die Schaltfläche *Redirect-URI hinzufügen*. Sie sieht wie folgt aus: `https://nextcloud.example.com/apps/sociallogin/custom_oauth2/ChurchTools` Tausche `nextcloud.example.com` mit deiner eigenen URL aus, unter der die Nextcloud läuft. Der letzte Teil `ChurchTools` ist der Provider-Name, den du gleich selbst in der Nextcloud wählen kannst. Wenn du dieser Anleitung folgst, musst du nur die Domain ändern und kannst den Namen „ChurchTools“ stehen lassen. **Redirect-URI** Die Redirect-URI wird dir normalerweise vom Drittsystem mitgeteilt. Leider tut das aber Nextcloud bzw. die App nicht, die du gleich aktivieren wirst. Diese URI benötigt der OAuth-Server (dein ChurchTools), um die Nutzer nach dem Login zum Drittsystem (Nextcloud) weiterzuleiten. **Wichtig** Abhängig davon, wie die Nextcloud konfiguriert ist, ist ggf. der Pfad `index.php` an die URL anzuhängen. Somit sieht die Redirect aus dem Screenshot oben wie folgt aus: [`https://nextcloud.example.com/index.php/apps/sociallogin/custom_oauth2/ChurchTools`](https://nextcloud.example.com/apps/sociallogin/custom_oauth2/ChurchTools) Probiere dies ggf. aus, falls der Login später nicht erfolgreich ist. ## 2. "Social Login"-App aktivieren Für den OAuth-Login benötigst du die Nextcloud-App „[Social Login](https://apps.nextcloud.com/apps/sociallogin)“. Als Admin der Nextcloud kannst du neue Apps über das App-Menü finden und hinzufügen. [![Social Login App](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-11.09.28.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-11.09.28.png) ## 3. "Custom OAuth2"-Profil eintragen Nun kannst du als Admin unter „Verwaltung“ (Administration) den Social-Login konfigurieren und einrichten. Dazu legst du ein "*Custom OAuth2"-Profil* an (1) und füllst die Werte mit den Links aus, die ChurchTools in Schritt 1 bereitgestellt hat. [![Custom OAuth2 Profil anlegen in Social Login App](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-11.22.11.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-11.22.11.png) Fülle nun die Felder aus: - Internal name: Name, der auch in der Redirect-URI verwendet wird. - Title: Name des Profils, der auch beim Nextcloud-Login angezeigt wird. - API Base URL, Authorization URL, Token URL, Profile URL und Client ID: Diese Felder werden von ChurchTools erstellt und in den System-Einstellungen beim OAuth-Client angezeigt (siehe Screenshot oben). - Client Secret: Wähle hier eine zufällige Zeichenkette aus. [![Custom OAuth2 Profil konfigurieren in Social Login App](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-11.24.00.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-11.24.00.png) Nun ist alles eingestellt und die Nutzer eures ChurchTools können sich in der Nextcloud einloggen. **Profildaten** Beim erfolgreichen Login überträgt ChurchTools folgende Profil-Daten an Nextcloud: Profilbild, Vorname, Nachname, E-Mail, Gruppenzugehörigkeiten. Ganz oben auf der Seite findest du einige Checkboxen. Es steht dir frei, das auszuwählen, was für euch sinnvoll ist. Wir empfehlen allerdings, folgende Haken zu setzen: - Das Benutzerprofil bei jeder Anmeldung aktualisieren - Gruppen automatisch erstellen, wenn sie nicht vorhanden sind (siehe letzter Punkt dieser Anleitung) [![NextCloud Konfiguration](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-11.56.00.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-11.56.00.png) ## 4. ChurchTools-Berechtigungen vergeben Als Super-Admin wirst du dich bereits einloggen können. Aber nicht immer ist es gewollt, dass jeder ChurchTools-Nutzer auch einen Login bei der Nextcloud haben soll. Daher benötigen ChurchTools-Nutzer die globale Berechtigung, sich beim Drittsystem einzuloggen: `Bei Drittsystem via ChurchTools-Benutzerkonto einloggen (login to external system)` [![Rechteverwaltung Global Administration ](https://staging.churchtools.academy/wp-content/uploads/2024/12/image-1024x650.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/image.png) **Berechtigungsgruppe** Damit du nicht den Überblick verlierst, richtest du eine neue ChurchTools Gruppe ein und erlaubst nur diesen Gruppenteilnehmern den Zugang zur Nextcloud. Damit behältst du den Überblick, wer sich einloggen kann. Mittels [automatischen Mitgliedschaften](https://staging.churchtools.academy/help/churchtools/automatische-mitgliedschaft/) kannst du so ganz einfach beispielsweise allen Leitern Zugriff gewähren. Ebenso kannst du einer in [Routinen](https://staging.churchtools.academy/de/help/churchtools-module/routinen/routinen-verstehen/) vordefinierten E-Mail neue Personen umgehend informieren lassen, dass sie den Nextcloud-Zugriff bekommen haben. ## 5. Gruppen oder Gruppenrollen synchronisieren Es ist möglich, Gruppenzugehörigkeiten aus ChurchTools zur Nextcloud zu übertragen und zu speichern. Es gibt zwei Möglichkeiten, dies zu nutzen. Egal welchen Weg du wählst, die Gruppen oder Gruppenrollen werden von ChurchTools an das Drittsystem übertragen. Die Nextcloud nimmt diese Daten und ordnet das Profil den entsprechenden Gruppen zu. Falls „Gruppen automatisch erstellen, wenn sie nicht vorhanden sind“ aktiviert ist, dann wird eine Gruppe neu erstellt und das Profil zugeordnet. Wenn diese Option nicht aktiv ist, kannst du die Gruppen in der Nextcloud manuell anlegen, falls nicht alle ChurchTools-Gruppen benötigt werden. Nur der Name muss gleich sein. ### Welche Gruppen werden übertragen? ChurchTools überträgt nur aktive Gruppenzugehörigkeiten. Dabei werden Gruppen nur berücksichtigt, wenn ... - ... die **Gruppe nicht verborgen** ist, ... - ... die zugehörige **Gruppenrolle nicht versteckt** ist und ... - ... die **Mitgliedschaft der Person aktiv** ist. Verborgene Gruppen, versteckte Rollen oder nicht aktive Mitgliedschaften werden nicht an Nextcloud übertragen. ### Gruppen übertragen Damit Gruppen übertragen werden (egal welcher Rolle), muss beim OAuth2-Profil unter „groups claim“ noch `groups` eingetragen werden. [![Social Login App groups claim groups](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-12.06.11.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-12.06.11.png) Gruppen in der Nextcloud haben folgendes Schema: `-`. Zum Beispiel "ChurchTools-Gemeindeleitung“. ### Gruppen und Rollen übertragen Damit Rollen übertragen werden, muss beim OAuth2-Profil unter „groups claim“ noch `roles` eingetragen werden. [![Social Login App groups claim roles](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-12.08.19.png)](https://staging.churchtools.academy/wp-content/uploads/2024/12/CleanShot-2024-12-10-at-12.08.19.png) Gruppen in der Nextcloud haben folgendes Schema:`-_`. Zum Beispiel „ChurchTools-Gemeindeleitung_Leiter“. **Pro Rolle eine Gruppe** Nextcloud kennt keine Rollen bei Gruppen. Um verschiedene ChurchTools-Rollen in der Nextcloud zu unterstützen, wird für jede Gruppenrolle eine eigene Nextcloud-Gruppe erstellt. Falls Gruppen automatisch erstellt werden, kann das die Gruppenliste in der Nextcloud schnell anwachsen lassen. #### Artikel zum Weiterlesen - [Was ist OAuth? (SSO in Drittsysteme)](https://staging.churchtools.academy/de/help/system-einstellungen/oauth-login-systemeinstellungen/was-ist-oauth-login-in-drittsysteme/) - [Was ist der Unterschied zwischen LDAP und OAuth?](https://staging.churchtools.academy/de/help/system-einstellungen/login-systemeinstellungen/was-ist-der-unterschied-zwischen-ldap-und-oauth/) - [Anbindung von Nextcloud an den ChurchTools-Login](https://staging.churchtools.academy/de/help/verwaltung/ldap/0-anbindung-von-nextcloud-an-den-churchtools-login/)