1. Einführung
Google Workspace SSO ermöglicht es Ihrer Organisation, Ihre Google-Kontodaten zu verwenden, um sich bei anderen Geschäftsanwendungen anzumelden. Das bedeutet, dass sich Ihre Benutzer einmal mit ihren Google Workspace-Anmeldedaten einloggen und automatisch bei genehmigten Apps angemeldet werden. In diesem Leitfaden erklären wir, wie Sie Google Workspace als Identity Provider (IdP) einrichten, um auf die Cyber Guru-Plattform zuzugreifen.
2. Was Sie vor Beginn benötigen
- Ein Administratorkonto für Google Workspace (das Konto mit der Rolle „Admin“)
- Zugriff auf Ihre Google Admin-Konsole (normalerweise unter https://admin.google.com)
- Verfügbarkeit der Werte für die folgenden Ansprüche:
- Benutzername
- Vorname
- Nachname
- Holen Sie sich die IdP-Anbietermetadaten als URL, die über das Internet erreichbar ist
- Identifizieren Sie Benutzer, die zur Nutzung der Anwendung autorisiert werden sollen (geeignete Gruppen wären besser)
- Erstellen Sie nach Möglichkeit einen Benutzer für Cyber Guru zu Testzwecken
3. Schritt-für-Schritt-Anleitung
3.1. Anmelden bei der Google Admin-Konsole
- Öffnen Sie Ihren Webbrowser und gehen Sie zu https://admin.google.com.
- Melden Sie sich mit Ihrer Administrator-E-Mail-Adresse und Ihrem Passwort an.
3.2. SAML SSO-Einstellungen finden und IdP-Metadaten senden
- Je nach Layout Ihrer Google Admin-Konsole finden Sie die SSO-Einstellungen an einem von zwei Hauptorten. Versuchen Sie Folgendes:
- Option A: Von der Startseite
- Auf der Startseite der Admin-Konsole
- Suchen Sie nach „Apps“ (es könnte als Symbol dargestellt oder im Menü aufgeführt sein) und klicken Sie darauf.
- Klicken Sie anschließend auf „Web- und mobile Apps“. Hier verwalten Sie SAML-Apps.
- Option B: Über das Sicherheitsmenü
- Wenn Sie „Sicherheit“ auf der Startseite sehen, klicken Sie darauf.
- Unter „Sicherheit“ suchen Sie nach „Einmaliges Anmelden (SSO) für SAML-Anwendungen einrichten“. (Wenn Sie „Sicherheit“ nicht sehen, klicken Sie auf „Mehr anzeigen“ oder verwenden Sie die Suchleiste oben in der Admin-Konsole, um nach „SSO“ zu suchen).
In diesem Dokument wird Option 1 verwendet
Wählen Sie im linken Menü „Apps“ und dann „Web- und mobile Apps“
Wählen Sie „Einstellungen“ -> „SAML-Zertifikate“
Sie erhalten eine Seite mit den Details des Google Identity Providers.
Gehen Sie zum unteren Ende der Seite
Klicken Sie auf „METADATEN HERUNTERLADEN“
Senden Sie die Datei GoogleIDPMetadata.xml an Cyber Guru. Sobald Cyber Guru die Konfiguration auf seiner Seite abgeschlossen hat, wird die SP-Metadaten-XML-Datei an den Kunden gesendet.
3.3. Eine neue SAML-App hinzufügen
Zurück zum Hauptmenü
Wählen Sie „Apps“ -> „Web- und mobile Apps“
Wählen Sie dann im rechten Bereich „App hinzufügen“ -> „Benutzerdefinierte SAML-App hinzufügen“
Füllen Sie den „App-Name“ und die „Beschreibung“ aus und klicken Sie auf „Weiter“.
Dies sind die IdP-Metadaten. Sie haben diese Daten bereits in den vorherigen Schritten gesendet.
Klicken Sie auf „Weiter“.
Die Werte für die roten Felder (ACS-URL und Entity-ID) befinden sich in der SP-Metadatendatei, die von Cyber Guru gesendet wurde. Hier unten die Auszüge der XML-Datei, in der die Daten zu finden sind:
ACS-URL
<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://login.stage.cyberguru.dev/realms/techcorpgoo/broker/saml/endpoint" isDefault="true" index="1"/>
Entity-ID
<md:EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" entityID="https://login.stage.cyberguru.dev/realms/techcorpgoo" ID="ID_dcdf9592-8351-4344-936c-5fc195636230">
Füllen Sie das Formular mit der ACS-URL und der Entity-ID aus und ändern Sie das „Name ID-Format“ zu „TRANSIENT“
Klicken Sie auf "Weiter"
Klicken Sie auf „MAPPING HINZUFÜGEN“
Hier konfigurieren wir die von Cyber Guru nach der Authentifizierung angeforderten Ansprüche.
Benutzername
HINWEIS: Für dieses Feld empfiehlt Cyber Guru dringend, einen Wert zu verwenden, der sich in Zukunft nicht ändern wird. Wenn also die Möglichkeit besteht, dass sich die „Primäre E-Mail“ in Zukunft ändert, verwenden Sie ein anderes Feld wie „Mitarbeiter-ID“ oder Ähnliches
Klicken Sie auf „MAPPING HINZUFÜGEN“
Klicken Sie auf "MAPPING HINZUFÜGEN"
Klicken Sie auf "MAPPING HINZUFÜGEN"
Klicken Sie am Ende der Seite auf „Fertigstellen“. Die App wird erstellt und das sollten Sie sehen:
3.4. Aktivieren Sie die App für Ihre Benutzer
In der Übersicht der gerade erstellten App finden Sie das Benutzerzugriff-Panel
Klicken Sie auf "AUS für alle"
Klicken Sie auf „Gruppen“ und wählen Sie die Gruppe aus, die die zur Nutzung der App berechtigten Benutzer enthält.
In diesem Konfigurationsbeispiel wählen wir TechCorporation. Bitte wählen Sie die Gruppe Ihrer Organisation aus, aktivieren Sie den Servicestatus und klicken Sie auf „Speichern“.
3.5. Testen Sie den SSO-Login
Bevor Sie es in Ihrer gesamten Organisation einführen, lassen Sie uns die Einrichtung testen:
Öffnen Sie ein Inkognito- oder privates Browserfenster.
-
Navigieren Sie zur Anmeldeseite: https://<subdomain>.platform.cyberguru.eu
Klicken Sie auf die Schaltfläche „LogInWith (Techcorpgoo IdP)“
HINWEIS: Techcorpgoo ist das Unternehmen, das für die Tests dieses Leitfadens verwendet wird.
Die Anmeldeseite Ihres Google Workspace wird angezeigt:
Melden Sie sich mit Ihren Google Workspace-Anmeldedaten an und werden Sie dann zurück zum Dienst weitergeleitet. Wenn alles funktioniert, sollten Sie die Willkommensseite von Cyber Guru erhalten.
4. Fehlerbehebung und Tipps
Wenn Sie beim Anmelden eine Fehlerseite erhalten, überprüfen Sie, ob die SSO-URL und andere Details in der Konfiguration des Dienstanbieters mit dem übereinstimmen, was Sie von Google heruntergeladen haben.
Denken Sie daran, dass die DNS- oder Zertifikatsverbreitung einige Minuten dauern kann. Wenn Änderungen nicht sofort sichtbar sind, warten Sie ein wenig und versuchen Sie es erneut.
Bewahren Sie das heruntergeladene Zertifikat oder die Metadatendatei an einem sicheren Ort auf. Möglicherweise müssen Sie es aktualisieren, wenn sich Ihre Google Workspace-Konfiguration ändert.
Verwenden Sie einen SAML-Tracer, um die Werte der Ansprüche in der SAML-Antwort zu überprüfen. Zum Beispiel:
.
<saml2:AttributeStatement>
<saml2:Attribute Name="username">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
gianmarco.cagnotto@testcyberguru.org
</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="firstName"><saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
Gianmarco
</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="lastName">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
Cagnotto</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="email">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
gianmarco.cagnotto@testcyberguru.org
</saml2:AttributeValue>
</saml2:Attribute>
</saml2:AttributeStatement>5. Weitere Hilfe erhalten
-
Google hat ein eigenes Hilfe-Center unter https://support.google.com/ für zusätzliche Artikel und Tipps zur Fehlerbehebung.
-
Wenn Sie sich unsicher sind, fragen Sie den technischen Support Ihrer Organisation oder Ihren Google Workspace-Partner um Hilfe.