Guide
Kopexa mit Google Workspace verbinden: SAML-SSO planen und prüfen
Google Workspace als SAML-Identity-Provider für Kopexa planen und prüfen. Domain, Metadaten, Nutzerfreigabe und Grenzen zum Datenimport erklärt.


Wenn sich eure Mitarbeitenden mit verwalteten Google-Konten bei Kopexa anmelden sollen, ist SAML-SSO der passende Verbindungstyp. Ein automatischer Import von Drive-Dateien oder Google-Sicherheitsnachweisen ist damit nicht verbunden.
Die Schritte kombinieren die dokumentierten SAML-Einstellungen beider Systeme. Mit den Abnahmetests prüft ihr E-Mail-Zuordnung, Nutzerfreigabe und Space-Zugriff vor der Freigabe für den Regelbetrieb.
Domain und Zugriff vorbereiten
Verifiziert eure E-Mail-Domain zunächst in Kopexa. Die Dokumentation zur Domain-Einrichtung beschreibt DNS-Verifizierung und die Folgen der Aktivierung. Stellt sicher, dass alle betroffenen Nutzer in Google für die neue Anwendung freigegeben werden können.
Plant MFA in Google und eine verantwortliche Person für die Konfiguration. Nach der Kopexa-SSO-Aktivierung gilt die Anmeldung über den Identity Provider für alle Nutzer der Domain.
Eine eigene SAML-Anwendung anlegen
In der Google-Admin-Konsole erstellt ihr unter Apps eine benutzerdefinierte SAML-App. Ladet die Google-IdP-Metadaten herunter. Als Dienstanbieterwerte verwendet ihr die Kopexa-Entitäts-ID https://id.kopexa.com/sso/saml/metadata und die ACS-URL https://id.kopexa.com/sso/saml/acs.
Google beschreibt Name-ID und Attributzuordnung in seiner Anleitung für eigene SAML-Apps. Kopexa benötigt die E-Mail-Adresse. Prüft, ob der tatsächlich übertragene Wert und die erwartete Attributzuordnung passen; eine gleich aussehende Anzeigename-Einstellung genügt nicht.
Metadaten in Kopexa hinterlegen
Öffnet die SSO-Einstellungen der verifizierten Organisationsdomain und hinterlegt die Google-XML-Metadaten. Das Signaturzertifikat wird daraus gelesen. Gebt die Anwendung zunächst für die vorgesehenen Nutzer beziehungsweise organisatorischen Einheiten frei.
Aktiviert SSO erst im abgestimmten Umstellungsfenster. Bestehende Kopexa-Passwortkonten derselben Domain sind ebenfalls betroffen. Wenn eine Zuordnung unklar ist, klärt sie vor der Umschaltung anhand der SAML-Antwort und der aktuellen Produktdokumentation.
Anmeldung und Berechtigung getrennt testen
Testet einen berechtigten Nutzer, einen nicht freigegebenen Nutzer und einen neuen Nutzer. Kontrolliert danach die Organisationsmitgliedschaft und die tatsächlich sichtbaren Spaces. Erfolgreiche Anmeldung bedeutet nicht automatisch korrekten fachlichen Zugriff.
Auto-Join kann bei SSO eine Organisationsmitgliedschaft herstellen. Es ersetzt keine sorgfältige Vergabe von Space-Rechten. Haltet diese Trennung im Berechtigungskonzept fest.
Google-Identität und Kopexa-Konto müssen zusammenpassen
Prüft besonders die tatsächlich übertragene E-Mail-Adresse. Alias, primäre Adresse und Anzeigename sind unterschiedliche Dinge. Ein Konto kann in der Admin-Konsole richtig aussehen und dennoch einen anderen Wert in der SAML-Antwort liefern.
Verwendet einen berechtigten bestehenden Nutzer und kontrolliert, ob die erwartete Identität in Kopexa verwendet wird. Testet anschließend den vorgesehenen Weg für neue Nutzer. Legt vorab fest, ob eine Organisationsmitgliedschaft per Auto-Join oder per Einladung entstehen soll.
Die drei wichtigsten Abnahmefragen
| Test | Erwartete Aussage |
|---|---|
| Freigegebenes Konto | Anmeldung und fachlicher Zugriff entsprechen der vorgesehenen Rolle |
| Nicht freigegebenes Konto | Es entsteht kein unerwarteter Zugang |
| Konto mit geänderter Adresse | Die Identitätszuordnung wird bewusst geprüft, statt eine problemlose Übernahme anzunehmen |
Die konkrete Wirkung einer Adressänderung müsst ihr im abgestimmten Verfahren prüfen. Diese Anleitung ist aus der Dokumentation beider Systeme abgeleitet; sie ersetzt keinen End-to-End-Test eurer produktiven Domain.
Den Betrieb übernehmen
Notiert Zertifikatsablauf, Verantwortliche und das Verfahren für Änderungen. Übernehmt neue Metadaten rechtzeitig in Kopexa und testet die Anmeldung erneut. Prüft bei einem Austritt die tatsächliche Wirkung eures Sperr- und Sitzungsverfahrens.
Für einen gewünschten Google-Datenimport klärt ihr anschließend separat verfügbare Schnittstellen, Berechtigungen und Umfang. Die SSO-Einrichtung selbst wird als überprüfter Nachweis zur entsprechenden Maßnahme dokumentiert.
Kurz beantwortet
Häufige Fragen
Noch eine Frage offen? Hier findest du die Antworten zum Nachlesen.
Werden durch Google-SSO automatisch Drive-Dokumente in Kopexa übernommen?
Nein. SSO dient der Anmeldung. Ein Import von Dokumenten oder Sicherheitsdaten ist ein eigener Integrationsfall, dessen Verfügbarkeit und Rechte geprüft werden müssen.
Quellen
- Eigene SAML-App einrichten — Google [Abgerufen am ]
- Organisationsdomains und SAML-SSO — Kopexa [Abgerufen am ]