{"id":97957,"date":"2026-10-27T09:00:00","date_gmt":"2026-10-27T07:00:00","guid":{"rendered":"https:\/\/churchtools.academy\/?post_type=docs&#038;p=97957"},"modified":"2026-10-27T09:00:00","modified_gmt":"2026-10-27T07:00:00","password":"","slug":"oidc-authentifizierung-bei-churchtools","status":"publish","type":"docs","link":"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/oauth-oidc-und-saml-login-systemeinstellungen\/oidc-authentifizierung-bei-churchtools\/","title":{"rendered":"OIDC-Authentifizierung bei ChurchTools"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Hier erkl\u00e4ren wir dir, wie du einen externen Login-Provider per OIDC mit deinem ChurchTools verbinden kannst. So k\u00f6nnen deine Benutzer ihren Login aus einem Drittsystem wie beispielsweise Microsoft365 nutzen, um sich damit in eurem ChurchTools einzuloggen.<\/p>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-1ccdadb1 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#3e70ce;border-left-width:0.5rem;background-color:#f3f5f7;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p class=\"wp-block-paragraph\" style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Hinweis<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\" style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">Die Einrichtung beim externen Anbieter unterscheidet sich je nach System. Nutze dessen offizielle Dokumentation oder sprich mit den IT-Verantwortlichen eurer Gemeinde oder eures Verbands. Diese Anleitung beschreibt daher nur die Einstellungen in ChurchTools.<\/p>\n<\/aside>\n\n\n\n<h2 class=\"wp-block-heading\">1. ChurchTools beim Anbieter registrieren<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Lege beim Anbieter eine Anwendung f\u00fcr euer ChurchTools-System an. Manche Anbieter nennen sie auch \u201eClient\u201c. Falls du nach der Anwendungsart gefragt wirst, w\u00e4hle einen <strong>vertraulichen Client (Confidential Client)<\/strong> und den <strong>Authorization-Code-Ablauf<\/strong>. Achte bei einigen Anbietern wie Google darauf, als Zielgruppe\/Audience <strong>Extern \/ External<\/strong> anzugeben.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u00d6ffne danach in deinem ChurchTools \u00fcber das <em>Verwalten-Men\u00fc<\/em> die <em>System-Einstellungen<\/em>. Wechsle unter <em>Allgemein<\/em> zu <em>Login<\/em>. Hier werden dir die <strong>Provider-Endpunkte <\/strong>angezeigt (siehe auch <a href=\"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/login-systemeinstellungen\/login-bei-und-mit-churchtools\/\" data-type=\"docs\" data-id=\"43227\">Login bei und mit ChurchTools<\/a>).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kopiere die angezeigte <strong>OIDC-Redirect-URI <\/strong>und trage sie beim Anbieter als erlaubte R\u00fccksprungadresse ein. \u00dcbernimm sie exakt und ver\u00e4ndere sie nicht.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Beim Anbieter sollten dir bei oder nach der Einrichtung die <em>Issuer-Adresse<\/em>, die <em>Client-ID<\/em> und das <em>Client-Secret<\/em> angezeigt werden. Halte sie f\u00fcr die weitere Konfiguration deines ChurchTools  bereit.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">2. OIDC-Anbieter in ChurchTools hinzuf\u00fcgen<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Klicke im Abschnitt <em>Login bei ChurchTools via Drittsystem<\/em> auf die blaue Schaltfl\u00e4che <strong>+ Login-Provider hinzuf\u00fcgen<\/strong> und w\u00e4hle im Men\u00fc <strong>OIDC<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">F\u00fclle die Felder mit den jeweiligen Daten aus. Der folgende Screenshot zeigt dir ein anonymisiertes Beispiel. Trage beim Einrichten die tats\u00e4chlichen Daten eures Anbieters ein.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-hinzufuegen.png\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1922\" height=\"1354\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-hinzufuegen.png\" alt=\"Screenshot Dialogfenster Server hinzuf\u00fcgen\" class=\"wp-image-97971\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-hinzufuegen.png 1922w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-hinzufuegen-300x211.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-hinzufuegen-768x541.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-hinzufuegen-1024x721.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-hinzufuegen-1536x1082.png 1536w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-hinzufuegen-360x254.png 360w\" sizes=\"(max-width: 1922px) 100vw, 1922px\" \/><\/a><\/figure>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Feld<\/th><th class=\"has-text-align-left\" data-align=\"left\">Was tr\u00e4gst du ein?<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\">Name<\/td><td class=\"has-text-align-left\" data-align=\"left\">Einen verst\u00e4ndlichen Namen, an dem eure Benutzer den Anbieter erkennen; f\u00fcr eine Google-Anbindung z. B. \u201eLogin mit Google\u201c.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Issuer<\/td><td class=\"has-text-align-left\" data-align=\"left\">Die exakte Issuer-Adresse aus der Dokumentation bzw. Konfiguration des Anbieters. Ein eventuell vorhandener abschlie\u00dfender Schr\u00e4gstrich geh\u00f6rt zur Adresse.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Discovery-URL<\/td><td class=\"has-text-align-left\" data-align=\"left\">Wird aus dem Issuer automatisch abgeleitet. Du musst die einzelnen Anmelde- und Token-Adressen nicht manuell eintragen.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Client-ID<\/td><td class=\"has-text-align-left\" data-align=\"left\">Die Kennung der Anwendung, die du beim Anbieter f\u00fcr ChurchTools registriert hast.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Client-Secret<\/td><td class=\"has-text-align-left\" data-align=\"left\">Das zu dieser Anwendung geh\u00f6rende Secret. Beim Anlegen ist es erforderlich. L\u00e4sst du es beim sp\u00e4teren Bearbeiten leer, bleibt das gespeicherte Secret erhalten.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Scope<\/td><td class=\"has-text-align-left\" data-align=\"left\">Normalerweise sind es die drei Scopes &#8222;<code>openid profile email<\/code>&#8222;. Mehrere Scopes werden durch Leerzeichen getrennt. Trage zus\u00e4tzliche Scopes nur ein, wenn sie laut Anbieter f\u00fcr die ben\u00f6tigten Informationen erforderlich sind.<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Neue Personen erstellen<\/td><td class=\"has-text-align-left\" data-align=\"left\">Wenn keine passende Person gefunden wird, kann automatisch eine neue Person erstellt werden.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">F\u00fcge den Login-Provider abschlie\u00dfend hinzu.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">3. OIDC-Anmeldung testen<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Klicke auf den neu angelegten Login-Provider, um die dazugeh\u00f6rige Detailseite aufzurufen. Hier findest du nochmal alle Angaben zur Verbindung. Im unteren Bereich kannst du nun die <strong>OICD-Anmeldung testen<\/strong>. Klicke auf die blaue Schaltfl\u00e4che, um zu pr\u00fcfen, ob die Verbindung korrekt eingerichtet wurde.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Es \u00f6ffnet sich ein zus\u00e4tzliches Browserfenster. Falls dein Browser es blockiert, erlaube es. Melde dich dann dort beim Anbieter an.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kehre zur Detailseite zur\u00fcck und pr\u00fcfe das Ergebnis. Bei Erfolg siehst du, welche Arten von Informationen der Anbieter \u00fcbermittelt hat. Die pers\u00f6nlichen Inhalte werden im Test nicht angezeigt.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-Test.png\"><img decoding=\"async\" width=\"1924\" height=\"380\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-Test.png\" alt=\"OICD-Anmeldung testen\" class=\"wp-image-97990\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-Test.png 1924w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-Test-300x59.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-Test-765x151.png 765w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-Test-1024x202.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-Test-1536x303.png 1536w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/10\/OICD-Server-Test-360x71.png 360w\" sizes=\"(max-width: 1924px) 100vw, 1924px\" \/><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Der Test pr\u00fcft die technische Verbindung und die G\u00fcltigkeit der Anmeldung. Er erstellt keine Personen in ChurchTools, verkn\u00fcpft kein Benutzerkonto und meldet keine Person bei ChurchTools an. Ein erfolgreicher Test beweist daher noch nicht, dass die Personenzuordnung funktioniert.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pr\u00fcfe deshalb anschlie\u00dfend die echte Anmeldung in einem separaten Browserprofil oder privaten Fenster. Nutze eine eindeutig passende, aktive Person und kontrolliere danach, ob du im richtigen ChurchTools-Profil angemeldet bist. Falls ihr neue Personen zulassen wollt, pr\u00fcfe am besten auch diesen Fall und die zugewiesenen Berechtigungen.<\/p>\n\n\n\n<aside class=\"wp-block-group ct-artikel-zum-weiterlesen has-background is-layout-constrained wp-container-core-group-is-layout-79a8db7e wp-block-group-is-layout-constrained\" style=\"border-radius:8px;background-color:#f9fafb;margin-top:24px;margin-bottom:24px;padding-top:32px;padding-right:24px;padding-bottom:32px;padding-left:24px\">\n<h2 class=\"wp-block-heading has-medium-font-size\">Artikel zum Weiterlesen<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/login-systemeinstellungen\/login-bei-und-mit-churchtools\/\" data-type=\"docs\" data-id=\"43227\">Login bei und mit ChurchTools<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/login-systemeinstellungen\/ueberblick-ueber-die-angebotenen-login-methoden\/\" data-type=\"link\" data-id=\"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/login-systemeinstellungen\/ueberblick-ueber-die-angebotenen-login-methoden\/\">\u00dcberblick \u00fcber die angebotenen Login-Methoden<\/a><\/li>\n<\/ul>\n<\/aside>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Hier erkl\u00e4ren wir dir, wie du einen externen Login-Provider per OIDC mit deinem ChurchTools verbinden kannst. So k\u00f6nnen deine Benutzer ihren Login aus einem Drittsystem wie beispielsweise Microsoft365 nutzen, um sich damit in eurem ChurchTools einzuloggen. 1. ChurchTools beim Anbieter registrieren Lege beim Anbieter eine Anwendung f\u00fcr euer ChurchTools-System an. Manche Anbieter nennen sie auch [&hellip;]<\/p>\n","protected":false},"author":43,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[698],"doc_tag":[],"knowledge_base":[346],"class_list":["post-97957","docs","type-docs","status-publish","hentry","doc_category-oauth-oidc-und-saml-login-systemeinstellungen","knowledge_base-system-einstellungen"],"pp_statuses_selecting_workflow":false,"pp_workflow_action":"current","pp_status_selection":"publish","pp_force_visibility":null,"pp_subpost_visibility":null,"pp_inherited_force_visibility":null,"pp_inherited_subpost_visibility":null,"acf":[],"year_month":"2026-11","word_count":577,"total_views":"1","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Stefan Krumsdorf","author_nicename":"skrumsdorf","author_url":"https:\/\/churchtools.academy\/de\/author\/skrumsdorf\/"},"doc_category_info":[{"term_name":"OAuth, OIDC und SAML","term_url":"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/oauth-oidc-und-saml-login-systemeinstellungen\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"System-Einstellungen","term_url":"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/","term_slug":"system-einstellungen"}],"knowledge_base_slug":["system-einstellungen"],"_links":{"self":[{"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/docs\/97957","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/users\/43"}],"replies":[{"embeddable":true,"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/comments?post=97957"}],"version-history":[{"count":8,"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/docs\/97957\/revisions"}],"predecessor-version":[{"id":98109,"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/docs\/97957\/revisions\/98109"}],"wp:attachment":[{"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/media?parent=97957"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/doc_category?post=97957"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/doc_tag?post=97957"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/churchtools.academy\/de\/wp-json\/wp\/v2\/knowledge_base?post=97957"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}