--- title: "OAuth-Authentifizierung mit ChurchTools" description: "In dieser Anleitung zeigen wir dir, wie du **zwei ChurchTools-Systeme** miteinander verknüpfst. Dabei dient eines der beiden Systeme als Authentifizierungsserver für das andere System, den Client. Das heißt, Nutzer des Server-Systems können sich anschließend beim Client-System einloggen. Sie brauchen dafür…" url: "https://staging.churchtools.academy/de/help/system-einstellungen/oauth-login-systemeinstellungen/oauth-zwischen-zwei-churchtools-systemen/" updated: "2026-07-06" category: Login / OAuth --- # OAuth-Authentifizierung mit ChurchTools In dieser Anleitung zeigen wir dir, wie du **zwei ChurchTools-Systeme** miteinander verknüpfst. Dabei dient eines der beiden Systeme als Authentifizierungsserver für das andere System, den Client. Das heißt, Nutzer des Server-Systems können sich anschließend beim Client-System einloggen. Sie brauchen dafür keine separaten Login-Daten auf dem Client. Du kannst diese Seite auch als Hilfe verwenden, wenn du kein zweites ChurchTools, sondern ein **Drittsystem** nutzen möchtest. So könntest du dein ChurchTools als Authentifizierungsserver für ein System wie NextCloud nutzen oder einen anderen Authentifizierungsserver für dein ChurchTools anbinden. Die jeweilige Konfiguration in ChurchTools bleibt gleich. Für das andere System können wir dir leider keine Anleitung zur Verfügung stellen. Bitte informiere dich entsprechend über die Hilfsangebote der jeweiligen Software. ## 1. OAuth-Server vorbereiten Schauen wir uns zunächst an, wie du deinem OAuth-Server einen Client hinzufügst. Navigiere in dem ChurchTools-System zur *Login*-Seite, das als Server dienen soll. Es ist das System, auf dem die Benutzer bereits vorhanden sind, die sich im zweiten System einloggen können sollen. Wie du die Login-Seite erreichst, beschreiben wir auf [Login bei und mit ChurchTools](https://staging.churchtools.academy/de/help/system-einstellungen/login-systemeinstellungen/login-bei-und-mit-churchtools/). Klicke auf die Schaltfläche **OAuth-Client hinzufügen**. Es öffnet sich ein Fenster, in dem du dem Client einen Namen geben musst. Du kannst den Namen frei wählen, er dient nur zur eindeutigen Kennung auf dem Server. In unserem Beispiel heißt er „ChuToo Client“. [![Login OAuth-Client hinzufügen](https://staging.churchtools.academy/wp-content/uploads/2025/12/CTC-2025-12-15-at-16.51.57-1.png)](https://staging.churchtools.academy/wp-content/uploads/2025/12/CTC-2025-12-15-at-16.51.57-1.png) ChurchTools erstellt nun alle Server-Informationen, die für eine Anbindung relevant sind. Eine vereinfachte Erklärung der verwendeten Begriffe findest du auf unserer Hilfeseite [Was ist OAuth? (SSO in Drittsysteme)](https://staging.churchtools.academy/de/help/system-einstellungen/oauth-login-systemeinstellungen/was-ist-oauth-login-in-drittsysteme/). Die Redirect-URI fehlt natürlich, denn sie wird vom Client bereitgestellt und muss dann hier eingetragen werden. [![Login OAuth-Client bearbeiten ohne Redirect-URI](https://staging.churchtools.academy/wp-content/uploads/2025/12/CTC-2025-12-24-at-10.12.11.png)](https://staging.churchtools.academy/wp-content/uploads/2025/12/CTC-2025-12-24-at-10.12.11.png) **Hinweis** Beachte die blaue Hinweisbox. Wenn die Systeme verbunden sind, musst du noch die notwendigen Berechtigungen vergeben, um den Server zur Authentifizierung nutzen zu können. Weitere Informationen dazu findest du in Abschnitt 3. ## 2. OAuth-Client konfigurieren Wechsle jetzt in dein Client-System und öffne dort ebenfalls die Login-Seite. Öffne über die Schaltfläche **OAuth-Server hinzufügen** die folgende Eingabe-Maske. Hier trägst du die entsprechenden Daten aus dem Server ein. **Hinweis** Manche OAuth-Server wie Google oder Microsoft 365/Entrada ID erwarten Einträge im Feld *Scope*. Bitte schau dazu in die jeweilige Dokumentation der Anbieter. Für einen ChurchTools-Server brauchst du *Scope* nicht. Im unteren Abschnitt der Eingabe-Maske kannst du über die Schaltfläche **Neue Personen erstellen** festlegen, ob Personen, die auf dem Client noch nicht vorhanden sind, erstellt werden, wenn sie sich über den Server per OAuth einloggen. Du musst dann definieren, welchen *Personenstatus*sie bekommen und welchem *Bereich* und *Standort* sie zugewiesen werden. [![Screenshot Login OAuth-Server hinzufügen](https://staging.churchtools.academy/wp-content/uploads/2026/06/CTC-2026-07-06-at-09.32.37.png)](https://staging.churchtools.academy/wp-content/uploads/2026/06/CTC-2026-07-06-at-09.32.37.png) Falls es für deine Verbindung zum Authentifizierungsserver wichtig ist, fülle das Feld **Client-Secret** aus. Du kannst hier frei ein Passwort vergeben. Für die Verbindung zu einem ChurchTools Server ist aktuell kein Client-Secret notwendig. Kopiere dir abschließend den **Client Identifier** und klicke auf *Hinzufügen*. Öffnest du anschließend durch Anklicken den neu eingetragenen OAuth-Server, kannst du zusätzlich noch über die Schaltfäche *Registrierung möglich* aktivieren, dass im Drittsystem eine **Registrierung von neuen Benutzern** möglich ist. [![Screenshot Registrierung möglich](https://staging.churchtools.academy/wp-content/uploads/2026/02/CTC-2026-03-20-at-12.01.43.png)](https://staging.churchtools.academy/wp-content/uploads/2026/02/CTC-2026-03-20-at-12.01.43.png) Damit sind deine Arbeiten am Client abgeschlossen. ## 3. OAuth-Server fertigstellen ### Redirect-URI hinzufügen Um die Verbindung zwischen den beiden ChurchTools-Systemen fertigzustellen, trage nun auf der Login-Seite des Servers die Redirect-URI ein. Über die Schaltfläche **Redirect-URI hinzufügen** öffnest du das entsprechende Fenster und trägst hier den aus dem Client kopierten Link ein. Alle notwendigen Daten für die Verbindung zwischen Server und Client sind damit eingetragen. ### Notwendige Berechtigung vergeben Damit sich Benutzer deines ChurchTools-Servers beim ChurchTools-Clients via OAuth einloggen können, benötigen sie die Berechtigung **Bei Drittsystem via ChurchTools Benutzerkonto einloggen (Login to External System)**. Du findest diese Berechtigung in der *Rechteverwaltung* im Bereich *Administration*. Weitere Informationen dazu findest du auf unserer Hilfeseite [Login bei und mit ChurchTools](https://staging.churchtools.academy/de/help/system-einstellungen/login-systemeinstellungen/login-bei-churchtools/). ## Login beim Client In der Login-Maske des Clients wird jetzt die Option eingeblendet, sich über den Authentifizierungsserver einzuloggen. Eventuell ist der Standard-Login für ChurchTools ausgeblendet und damit nicht mehr zu sehen. [![Anmeldefenster Client](https://staging.churchtools.academy/wp-content/uploads/2025/12/CG-Mertalia-Login-2025-12-18-at-14.01.28.png)](https://staging.churchtools.academy/wp-content/uploads/2025/12/CG-Mertalia-Login-2025-12-18-at-14.01.28.png) Wählst du diese Option, öffnet sich ein Fenster, das dich darüber informiert, welche Login-Informationen vom Server an den Client weitergegeben werden. Stimmst du zu, wirst du im Client-System eingeloggt. Diese Datenschutzabfrage erfolgt nur beim ersten Login über OAuth. [![OAuth Client Anmeldeinformationen](https://staging.churchtools.academy/wp-content/uploads/2025/12/CTC-2025-12-24-at-10.31.09.png)](https://staging.churchtools.academy/wp-content/uploads/2025/12/CTC-2025-12-24-at-10.31.09.png) **Hinweis** Bedenke, dass der Login am Client-System von den Einstellungen im Server abhängig ist. Ist die Option *Neue Person anlegen* nicht aktiviert und du hast auf dem Client System kein Benutzerkonto, kannst du dich nicht einloggen. Ist die Option *Neue Person anlegen* aktiviert, wird auf dem Client ein neues Benutzerkonto für dich erstellt, wenn du noch keins hast. Dabei hängen *Personenstatus*, *Bereich* und *Standort* von den Einstellungen im Server ab. Sie können im Nachhinein auf dem Client-System geändert werden. ## Wichtiger Hinweis zu Passwortänderungen Wenn du dich nur über OAuth in ein ChurchTools-System eingeloggt hast, aber nie den direkten Login dieses Systems genutzt hast, dann hast du kein Passwort in diesem ChurchTools-System. Du kannst aber in diesem ChurchTools-System in dein Profil gehen und dort dein Passwort ändern. Dabei musst du Folgendes bedenken: - Hast du in diesem System noch kein lokales Passwort, dann setzt du dir nun eins. - Hattest du in diesem System bereits ein lokales Passwort, dann wird dieses jetzt geändert. In beiden Fällen bearbeitest du aber nur das Passwort des ChurchTools-Systems, in dem du dich gerade befindest. Damit änderst du nicht das Passwort des Systems, mit dem du dich bei diesem ChurchTools-System angemeldet hast. **Ein kurzes Beispiel** Du nutzt Google, um dich bei deinem ChurchTools anzumelden. Einen anderen Weg gibt es nicht auf deiner Login-Seite. Du kannst dennoch in dein ChurchTools-System gehen und dort dein Passwort setzen bzw. ändern. Damit änderst du aber nur und ausschließlich das Passwort für dein ChurchTools. Dieses Passwort brauchst du eigentlich nicht, weil du dich nur über Google einloggen kannst. Dein Google-Passwort bleibt dadurch unverändert und ändert sich nicht. ## Artikel zum Weiterlesen - [Login bei und mit ChurchTools](https://staging.churchtools.academy/de/help/system-einstellungen/login-systemeinstellungen/login-bei-churchtools/) - [Was ist OAuth? (SSO in Drittsysteme)](https://staging.churchtools.academy/de/help/system-einstellungen/oauth-login-systemeinstellungen/was-ist-oauth-login-in-drittsysteme/) - [OAuth-Login via ChurchTools bei Nextcloud](https://staging.churchtools.academy/de/help/system-einstellungen/oauth-login-systemeinstellungen/login-bei-drittsystem-nextcloud-einrichten-oauth/)