Guide
Unternehmensdomain mit Kopexa verbinden: SSO sicher einrichten
Domain verifizieren, SAML-Metadaten austauschen und die Anmeldung prüfen. Mit wichtigen Grenzen zu Auto-Join, MFA und Space-Zugriff.


SSO verlagert die Anmeldung zu eurem Identity Provider. Damit wird die Freigabe der Kopexa-App dort zu einer wichtigen Betriebsaufgabe. Bereitet die Umstellung vor, bevor ihr den Schalter für die gesamte Domain aktiviert.
Der Ablauf führt von der Domainverifizierung zum Anmeldetest. Am Ende prüft ihr getrennt, ob Anmeldung, Organisationsmitgliedschaft und Space-Zugriff für die vorgesehenen Personen stimmen.
Was ihr dafür benötigt
Ihr braucht Zugriff auf die Organisationseinstellungen in Kopexa, die DNS-Verwaltung eurer E-Mail-Domain und die SAML-Konfiguration des Identity Providers. Es geht um Organisationsdomains für die Anmeldung, nicht um Internet-Domains, die in einem Space technisch geprüft werden.
Klärt vorab, welche bestehenden Nutzer die Domain verwenden. Nach der Aktivierung müssen sich alle Nutzer dieser Domain über den Identity Provider anmelden; die bisherige Passwortanmeldung steht ihnen dann nicht mehr zur Verfügung.
Domain verifizieren
Öffnet Einstellungen → Domains in der Organisation und fügt eure Domain hinzu. Übernehmt den angezeigten DNS-TXT-Eintrag bei eurem DNS-Anbieter. Sobald er öffentlich auflösbar ist, könnt ihr die Verifizierung erneut prüfen lassen.
Verwendet exakt den in Kopexa angezeigten Wert. Eine beliebige Domainbestätigung aus einem anderen Dienst funktioniert dafür nicht. Erst eine verifizierte Domain lässt sich für SSO konfigurieren.
Metadaten austauschen
Der Identity Provider benötigt die Kopexa-Metadaten unter https://id.kopexa.com/sso/saml/metadata. Die Antwort-URL lautet https://id.kopexa.com/sso/saml/acs. Stellt sicher, dass der Provider die E-Mail-Adresse des Nutzers übermittelt.
In Kopexa öffnet ihr die SSO-Einstellungen der Domain. Dort hinterlegt ihr die Metadaten-URL oder XML-Metadaten des Providers. Das Signaturzertifikat wird daraus übernommen. Die URL wird beim Einlesen geladen; plant spätere Zertifikatswechsel ausdrücklich ein.
Die vollständigen Felder beschreibt die Kopexa-Dokumentation.
Vor dem Umschalten prüfen
Weist allen benötigten Personen die Anwendung im Provider zu. Stellt MFA dort sicher: Eine SSO-Anmeldung ersetzt die zusätzliche Kopexa-Zwei-Faktor-Abfrage. Vereinbart außerdem ein Wiederherstellungsverfahren für eine fehlerhafte Konfiguration.
Aktiviert SSO im abgestimmten Zeitfenster. Testet danach mit einem bestehenden Nutzer und einem vorgesehenen neuen Nutzer. Prüft auch die Ablehnung eines nicht zugewiesenen Kontos.
Auto-Join ist keine Space-Freigabe
Mit Auto-Join werden Nutzer der Domain beim SSO-Login als Organisationsmitglied aufgenommen. Ohne Auto-Join ist für die Organisation weiterhin eine Einladung erforderlich. Welche Spaces sichtbar sind, bleibt separat geregelt.
Haltet die Entscheidung in eurem Berechtigungskonzept fest. Prüft beim Austritt auch aktive Sitzungen und Zugänge nach eurem Verfahren; aus einer gesperrten Anmeldung allein solltet ihr keine ungeprüfte Aussage über jede bestehende Sitzung ableiten.
Den Umstieg als Zugangsänderung abnehmen
Ein erfolgreicher Login des Administrators genügt nicht. Haltet vor dem Umstellungsfenster fest, welche Nutzergruppen betroffen sind und wer den Test bestätigt. Bestehende Mitarbeitende, neue Mitglieder und ausdrücklich nicht berechtigte Konten benötigen unterschiedliche erwartete Ergebnisse.
Trennt dabei vier Ebenen: Domainbesitz, erfolgreiche SAML-Anmeldung, Mitgliedschaft in der Organisation und Zugriff auf einen Space. Wenn die Anmeldung funktioniert, aber ein Space fehlt, hilft eine erneute DNS-Verifizierung nicht weiter. Wenn bereits die SAML-Anmeldung scheitert, ist die fachliche Space-Rolle noch nicht die Ursache.
Dokumentiert Fehler mit Zeitpunkt und betroffener Ebene. SAML-Antworten können personenbezogene Informationen enthalten; gebt sie nicht ungefiltert in öffentliche Tickets. Für die Abstimmung mit dem Support reichen häufig zunächst Fehlerbild und Zeitbezug.
Als Abschlussnachweis eignen sich die überprüfte Konfiguration und die Ergebnisse der vorgesehenen Kontotypen. Passwörter, private Schlüssel und vollständige Token gehören nicht in diesen Nachweis.
Den laufenden Betrieb übernehmen
Benennt Verantwortliche für Zertifikate, App-Zuweisungen und Fehlermeldungen. Dokumentiert einen erfolgreichen Test als Nachweis zur Maßnahme und legt den nächsten Prüfanlass fest. So bleibt die Nachweishistorie auch nach der Einrichtung brauchbar.
Kurz beantwortet
Häufige Fragen
Noch eine Frage offen? Hier findest du die Antworten zum Nachlesen.
Meldet Auto-Join automatisch jeden in allen Spaces an?
Nein. Auto-Join betrifft die Mitgliedschaft in der Organisation beim SSO-Login. Space-Berechtigungen werden gesondert vergeben.
Quellen
- Organisationsdomains und SAML-SSO — Kopexa [Abgerufen am ]