Identität von Drittanbieter konfigurieren
Dieser Leitfaden richtet sich an Google Security Operations-Administratoren, die ihre Belegschaft (Nutzer und Gruppen) in Google SecOps über einen externen Identitätsanbieter (IdP) authentifizieren möchten. Dieser Prozess ist mithilfe derGoogle Cloud Mitarbeiteridentitätsföderation möglich.
Die Mitarbeiteridentitätsföderation unterstützt alle IdPs, die Security Assertion Markup Language (SAML 2.0) oder OpenID Connect (OIDC) verwenden, z. B. Okta, Microsoft Entra ID und Microsoft Active Directory Federation Services (AD FS).
In diesem Dokument werden die allgemeinen Schritte zum Einrichten der Authentifizierung über einen SAML- oder OIDC-basierten IdP mithilfe der Mitarbeiteridentitätsföderation beschrieben:
- Erforderliche Ressourcen planen Legen Sie die Details für Ihren Workforce Identity-Pool und den Anbieter fest und ermitteln Sie die Nutzerattribute und Gruppen, die zum Konfigurieren des Zugriffs auf Funktionen in Google SecOps erforderlich sind.
- Konfigurieren Sie die Drittanbieter-IdP-Anwendung. Erstellen Sie eine IdP-SAML- oder OIDC-Anwendung, die Sie in die Mitarbeiteridentitätsföderation und Google SecOps einbinden können.
- Mitarbeiteridentitätsföderation konfigurieren. Konfigurieren Sie Ihren Workforce Identity-Pool und -Anbieter und weisen Sie IdP-Gruppen und -Nutzern IAM-Rollen (Identity and Access Management) von Google Cloud zu.
- Konfigurieren Sie die Einmalanmeldung (SSO) mit dem neu erstellten Anbieter.
Nachdem Sie diese Schritte ausgeführt haben, können Sie sich mit Ihrem Identitätsanbieter in Google SecOps anmelden und den Nutzerzugriff über die rollenbasierte Zugriffssteuerung (RBAC) für Funktionen mit IAM verwalten.
Gängige Anwendungsfälle
Google SecOps erfordert die Verwendung der Mitarbeiteridentitätsföderation als SSO-Broker für eine Vielzahl von Anwendungsfällen.
Strenge Sicherheitsstandards einhalten
- Ziel: Strenge gesetzliche Vorgaben für den System- und Cloud-Zugriff erfüllen.
- Wert: Hilft bei der Einhaltung der FedRAMP High-Compliance-Anforderungen (oder höher), indem SSO sicher vermittelt wird.
Zugriffssteuerung für Unternehmen verwalten
- Ziel: Den Zugriff auf Funktionen und Daten zentral im gesamten Unternehmen steuern.
- Wert: Aktiviert die RBAC auf Unternehmensebene in Google SecOps mithilfe von IAM.
Schlüsselterminologie
- Personalpool: Eine global eindeutige Google Cloud -Ressource, die auf Organisationsebene definiert ist und Ihrer Belegschaft Zugriff auf Google SecOps gewährt.
- Workforce-Anbieter: Eine Unterressource des Workforce Identity-Pools, in der Konfigurationsdetails für einen einzelnen externen IdP gespeichert werden.
- Attributzuordnung: Der Prozess, bei dem von Ihrem IdP bereitgestellte Assertion-Attribute mithilfe der Common Expression Language (CEL) in Google Cloud -Attribute übersetzt werden.
- Assertion Consumer Service (ACS)-URL: Eine bestimmte URL (je nach Anbieter manchmal auch als URL für Einmalanmeldung bezeichnet), die zum Konfigurieren einer SAML-Anwendung für die Kommunikation mit Google SecOps verwendet wird.
- Entitäts-ID: Eine global eindeutige URL, die eine bestimmte Anwendung oder einen bestimmten Dienst wie Google SecOps identifiziert und die SAML-Anwendung in Ihrem IdP konfiguriert.
Prozessübersicht
Google SecOps unterstützt vom Dienstanbieter initiierte (SP-initiierte) SAML- oder OIDC-SSO. Mit dieser Funktion können Sie direkt zu Google SecOps wechseln. Google SecOps sendet über die IAM-Mitarbeiteridentitätsföderation eine Anfrage an den externen IdP.
Nachdem der IdP die Nutzeridentität authentifiziert hat, wird der Nutzer mit einer SAML-Authentifizierungsassertion oder einem OIDC-ID-Token an Google SecOps zurückgeleitet. Google Cloud Die Mitarbeiteridentitätsföderation fungiert als Vermittler im Authentifizierungsablauf.
Kommunikation zwischen Google SecOps, IAM-Mitarbeiteridentitätsföderation und IdP
Auf übergeordneter Ebene sieht die Kommunikation so aus:
- Der Nutzer ruft Google SecOps auf.
- Google SecOps sucht im Google Cloud-Mitarbeiteridentitätspool nach IdP-Informationen.
- Eine Anfrage wird an den IdP gesendet.
- Die SAML-Assertion oder das OIDC-ID-Token wird an den Workforce Identity-Pool von Google Cloud gesendet.
- Wenn die Authentifizierung erfolgreich ist, erhält Google SecOps nur die SAML-Attribute oder OIDC-Ansprüche, die Sie bei der Konfiguration des Workforce-Anbieters im Workforce Identity-Pool definiert haben.
Als Google SecOps-Administrator erstellen Sie Gruppen in Ihrem Identitätsanbieter, konfigurieren die SAML- oder OIDC-Anwendung so, dass Informationen zur Gruppenmitgliedschaft in der Assertion oder im ID-Token übergeben werden, und verknüpfen Nutzer und Gruppen mit vordefinierten IAM-Rollen in Google SecOps oder mit benutzerdefinierten Rollen, die Sie erstellt haben.
Hinweis
- Machen Sie sich mit Cloud Shell, dem
gcloud-Befehl und der Google Cloud Console vertraut. - Google Cloud -Projekt für Google SecOps konfigurieren, um ein Projekt einzurichten, das an Google SecOps gebunden ist.
- Google Cloud Mitarbeiteridentitätsföderation prüfen.
- Prüfen Sie, ob Sie die Berechtigungen zum Ausführen der Schritte in diesem Dokument haben. Informationen zu den erforderlichen Berechtigungen für die einzelnen Phasen des Onboarding-Prozesses finden Sie unter Erforderliche Rollen.
- Achten Sie darauf, dass Ihre Firewall- oder Proxy-Zulassungsliste die erforderlichen Google SecOps-, Mitarbeiteridentitätsföderation- und Drittanbieter-IdP-Domains auf TCP-Port
443enthält. Weitere Informationen finden Sie unter Netzwerkzugriff und Zulassungsliste für Domains.
Implementierung planen
In diesem Abschnitt werden die Entscheidungen beschrieben, die Sie treffen müssen, und die Informationen, die Sie definieren müssen, bevor Sie die Schritte in diesem Dokument ausführen.
Workforce Identity-Pool und Workforce-Anbieter definieren
Wenn Sie die Authentifizierung über einen IdP einrichten möchten, müssen Sie die Mitarbeiteridentitätsföderation als Vermittler im Authentifizierungsablauf konfigurieren. Bevor Sie die Mitarbeiteridentitätsföderation konfigurieren, definieren Sie die folgendenGoogle Cloud -Ressourcen:
- Personalpool: Ein Mitarbeiteridentitätspool gewährt Ihren Mitarbeitern Zugriff auf Google SecOps.
- Workforce-Anbieter: Eine Unterressource des Workforce Identity-Pools, in der Details zu einem einzelnen IdP gespeichert werden.
Die Beziehung zwischen dem Mitarbeiteridentitätspool, den Anbietern von Mitarbeiteridentitäten und einer Google SecOps-Instanz, die durch eine einzelne Kundensubdomain identifiziert wird, ist so:
- Ein Workforce Identity-Pool wird auf Organisationsebene definiert.
- Für jede Google SecOps-Instanz ist ein Mitarbeiteridentitätspool konfiguriert und mit ihr verknüpft.
- Ein Workforce Identity-Pool kann mehrere Workforce-Anbieter haben.
Jeder Workforce-Anbieter bindet einen externen IdP in den Workforce Identity-Pool ein.
Der Workforce Identity-Pool muss Google SecOps zugeordnet sein. Sie können den für Google SecOps erstellten Pool nicht für andere Zwecke freigeben.
Der Mitarbeiteridentitätspool muss sich in derselbenGoogle Cloud -Organisation befinden, die das an Google SecOps gebundene Projekt enthält.
Im Folgenden finden Sie die Richtlinien zum Definieren der Werte für die Schlüsselkennungen des Workforce-Pools und des Workforce-Anbieters:
- Mitarbeiterpool-ID (
WORKFORCE_POOL_ID): Definieren Sie einen Wert, der den Umfang oder Zweck des Mitarbeiteridentitätspools angibt. Der Wert muss die folgenden Anforderungen erfüllen:- Muss global eindeutig sein.
- Darf nur Kleinbuchstaben [a–z], Ziffern [0–9] und Bindestriche [-] enthalten.
- Muss mit einem Kleinbuchstaben [a–z] beginnen.
- Muss mit einem Kleinbuchstaben [a–z] oder einer Ziffer [0–9] enden.
- Kann 4 bis 61 Zeichen lang sein.
- Anzeigename des Personalpools (
WORKFORCE_POOL_DISPLAY_NAME): Definieren Sie einen nutzerfreundlichen Namen für den Mitarbeiteridentitätspool. - Beschreibung des Workforce-Pools (
WORKFORCE_POOL_DESCRIPTION): Definieren Sie eine detaillierte Beschreibung des Workforce Identity-Pools. - Workforce-Anbieter-ID (
WORKFORCE_PROVIDER_ID): Definieren Sie einen Wert, der den repräsentierten IdP angibt. Der Wert muss die folgenden Anforderungen erfüllen:- Darf nur Kleinbuchstaben [a–z], Ziffern [0–9] und Bindestriche [-] enthalten.
- Kann 4 bis 32 Zeichen lang sein.
- Anzeigename des Personalanbieters (
WORKFORCE_PROVIDER_DISPLAY_NAME): Legen Sie einen nutzerfreundlichen Namen für den Personalanbieter fest. Er muss weniger als 32 Zeichen lang sein. - Beschreibung des Personalanbieters (
WORKFORCE_PROVIDER_DESCRIPTION): Definieren Sie eine detaillierte Beschreibung des Personalanbieters.
Nutzerattribute und Gruppen im IdP definieren
Bevor Sie die SAML- oder OIDC-Anwendung im IdP erstellen, müssen Sie die Nutzerattribute oder OIDC-Anforderungen und -Gruppen ermitteln, die für die Konfiguration des Zugriffs auf Funktionen in Google SecOps erforderlich sind. Zu den typischen Nutzerattributen gehören:
- Betreff
- Vorname
- Nachname
- Anzeigename
Sie benötigen die Informationen zu Nutzergruppen und Attributen oder OIDC-Anforderungen in den folgenden Phasen dieses Prozesses:
Beim Konfigurieren der SAML- oder OIDC-Anwendung erstellen Sie die Gruppen, die Sie bei der Planung definiert haben. Sie konfigurieren die IdP-Anwendung so, dass Gruppenmitgliedschaften in der SAML-Assertion oder im OIDC-ID-Token übergeben werden.
Wenn Sie den Workforce-Anbieter erstellen, ordnen Sie SAML-Assertionsattribute oder OIDC-Anforderungen und -Gruppen Google Cloud -Attributen zu. Diese Informationen werden in der Assertion oder im ID-Token als Teil der Identität eines Nutzers gesendet.
IdP-Anwendung konfigurieren
In diesem Abschnitt wird nur die spezifische Konfiguration beschrieben, die in einer IdP-SAML- oder OIDC-Anwendung für die Integration in die Google CloudMitarbeiteridentitätsföderation und Google SecOps erforderlich ist. Eine detaillierte Anleitung finden Sie in der Dokumentation Ihres IdP.
SAML-Anwendung in Ihrem IdP konfigurieren
Erstellen Sie Gruppen in Ihrem IdP, falls noch nicht geschehen.
Als Best Practice sollten Sie Gruppen anstelle von einzelnen Nutzerkonten verwenden, um den Zugriff auf Ihre Google SecOps-Instanz zu verwalten. Google empfiehlt, in Ihrem IdP Gruppen zu erstellen, die direkt den Google SecOps-Standardrollen entsprechen.
Sehen Sie sich folgendes Beispiel an:
Google SecOps-Rolle IdP-Gruppe (vorgeschlagen) Chronicle API-Administrator chronicle_secops_admins Chronicle API Editor chronicle_secops_editor Chronicle API-Betrachter chronicle_secops_viewer Erstellen Sie eine neue SAML-Anwendung in Ihrem IdP.
Konfigurieren Sie die Anwendung so:
Geben Sie die Assertion Consumer Service-URL (ACS-URL) an, die je nach Dienstanbieter auch als SSO-URL bezeichnet wird.
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDErsetzen Sie Folgendes:
WORKFORCE_POOL_ID: die ID, die Sie für den Workforce Identity-Pool definiert haben.WORKFORCE_PROVIDER_ID: die Kennung, die Sie für den Workforce-Anbieter definiert haben.
Beschreibungen der Werte finden Sie unter Mitarbeiteridentitätspool und Mitarbeiteranbieter definieren.
Geben Sie die folgende Entitäts-ID (auch SP-Entitäts-ID genannt) an.
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDKonfigurieren Sie die Namenskennung in Ihrem IdP, damit das Feld
NameIDin der SAML-Antwort zurückgegeben wird.Sie können hier einen Wert festlegen, der den Organisationsrichtlinien Ihrer Organisation entspricht, z. B. eine E‑Mail-Adresse oder einen Nutzernamen. Informationen zum Konfigurieren dieses Werts finden Sie in der Dokumentation Ihres IdP. Weitere Informationen zu dieser Anforderung finden Sie unter Fehlerbehebung bei der Mitarbeiteridentitätsföderation.
Fügen Sie die Attributanweisungen hinzu, mit denen Sie Nutzerinformationen vom IdP an Ihre Anwendungsintegrationen übergeben können. Sie haben die Attribute bei der Planung der IdP-Implementierung definiert.
In der folgenden Tabelle finden Sie beispielsweise Informationen zum Zuordnen von Attributen in häufig verwendeten IdPs wie Okta, Microsoft AD FS oder Entra ID:
Attributname Okta-Wert AD FS / Entra ID (Quellattribut) subjectuser.emailuser.mailoderuser.userprincipalnameemailaddressuser.emailuser.mailfirst_nameuser.firstNameuser.givennamelast_nameuser.lastNameuser.surnamedisplay_nameuser.displayNameuser.displaynamegroupsKonfiguriert mit einem Gruppenfilter im IdP, z. B. Entspricht Regex mit .*Aus der Gruppenzuordnung im IdP übernommen Wenn Sie eine Okta-IdP-Anwendung konfigurieren, wählen Sie beim Hinzufügen der Attribute das Format Nicht angegeben aus. Lassen Sie den Namespace leer, wenn Sie Microsoft AD FS oder Entra ID als IdP verwenden.
Weisen Sie der Anwendung in Ihrem IdP die entsprechenden Gruppen und Nutzer zu.
Diese Gruppen und Nutzer sind berechtigt, auf Google SecOps zuzugreifen.
Laden Sie die XML-Datei mit den Anwendungsmetadaten herunter.
Im nächsten Abschnitt verwenden Sie diese Metadatendatei, wenn Sie Ihren Workforce Identity-Anbieter konfigurieren. Wenn Sie die Google Cloud CLI verwenden, müssen Sie diese Datei mit Cloud Shell von Ihrem lokalen System in Ihr Google Cloud Home-Verzeichnis hochladen.
OIDC-Anwendung in Ihrem IdP konfigurieren
So konfigurieren Sie eine OIDC-Anwendung in Ihrem IdP für die Einbindung in die Mitarbeiteridentitätsföderation und Google SecOps:
Wenn Sie noch keine Gruppen erstellt haben, erstellen Sie sie in Ihrem IdP. Als Best Practice sollten Sie Gruppen anstelle einzelner Nutzerkonten verwenden, um den Zugriff auf Ihre Google SecOps-Instanz zu verwalten.
Erstellen Sie in Ihrem IdP eine neue OIDC-Anwendung und folgen Sie den Schritten zur IdP-Vorbereitung unter OIDC-Workforce-Pool-Anbieter erstellen.
Konfigurieren Sie die Anwendung mit den beiden folgenden Weiterleitungs-URIs, die von einigen IdPs als Callback-URLs oder Weiterleitungs-URIs für die Anmeldung bezeichnet werden:
Für die Anmeldung bei Google SecOps:
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDFür die Validierung von Token und Attributzuordnungen der Mitarbeiteridentitätsföderation:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Ersetzen Sie Folgendes:
WORKFORCE_POOL_ID: die ID, die Sie für den Workforce Identity-Pool definiert haben.WORKFORCE_PROVIDER_ID: die Kennung, die Sie für den Workforce-Anbieter definiert haben.
Beschreibungen der Werte finden Sie unter Workforce Identity-Pool und Workforce-Anbieter definieren.
Wählen Sie den Genehmigungstyp in Ihrer IdP-Anwendung aus: entweder den empfohlenen Autorisierungscode-Vorgang oder den impliziten Ablauf. Wenn Sie den impliziten Ablauf verwenden, muss die Anwendung so konfiguriert sein, dass sie das ID-Token zurückgibt.
Konfigurieren Sie Ihre IdP-Anwendung so, dass die Anforderung
subsowie die Nutzer- und Gruppenanforderungen zurückgegeben werden, die Sie bei der Planung der IdP-Implementierung festgelegt haben.In der folgenden Tabelle finden Sie beispielsweise Zuordnungen für Anforderungen in häufig verwendeten IdPs wie Okta, Microsoft AD FS oder Entra ID:
Anspruchsname Okta-Wert AD FS / Entra ID (Quellattribut) subuser.emailuser.mailoderuser.userprincipalnameemailuser.emailuser.mailgiven_nameuser.firstNameuser.givennamefamily_nameuser.lastNameuser.surnamenameuser.displayNameuser.displaynamegroupsKonfiguriert mit einem Gruppenfilter im IdP, z. B. Entspricht Regex mit .*Aus der Gruppenzuordnung im IdP übernommen Wenn Sie eine Okta- oder Entra ID-IdP-Anwendung konfigurieren, müssen Standardbereiche (z. B.
openid,profileundemail) gewährt werden, um diese Anforderungen zu übergeben. Wenn Sie Microsoft AD FS oder Entra ID verwenden, konfigurieren Sie die Claim-Mappings entsprechend.Wenn Ihre Okta-OIDC-Anwendung einen Organisationsautorisierungsserver verwendet, müssen Sie beim Erstellen des Mitarbeiteridentitätsföderationsanbieters auch
groupsals zusätzlichen Bereich übergeben, damit Okta diegroups-Anforderung zurückgibt. Weitere Informationen finden Sie unter Mitarbeiteridentitätsföderation mit Okta konfigurieren.Weisen Sie der OIDC-Anwendung in Ihrem IdP die entsprechenden Gruppen und Nutzer zu.
Notieren Sie sich die folgenden Anmeldedaten aus Ihrer IdP-Anwendung, um sie beim Erstellen eines OIDC-Workforce-Identity-Pool-Anbieters zu verwenden:
- Autorisierungscode-Vorgang: Client-ID, Aussteller-URI und Clientschlüssel.
- Impliziter Ablauf: Client-ID und Aussteller-URI.
Identitätsföderation von Arbeitslasten konfigurieren
In diesem Abschnitt werden nur die spezifischen Schritte beschrieben, die zum Konfigurieren der Mitarbeiteridentitätsföderation mit der IdP-SAML- oder OIDC-Anwendung erforderlich sind, die Sie im vorherigen Abschnitt erstellt haben. Weitere Informationen zum Verwalten von Mitarbeiteridentitätspools finden Sie unter Anbieter von Mitarbeiteridentitätspools verwalten.
Abrechnungs- und Kontingentprojekt festlegen
Öffnen Sie die Google Cloud -Konsole als Nutzer mit den erforderlichen Berechtigungen für das an Google SecOps gebundene Projekt. Sie haben diesen Nutzer bereits identifiziert oder erstellt. Weitere Informationen finden Sie im Abschnitt Vorbereitung.
Starten Sie eine Cloud Shell-Sitzung.
Legen Sie das Projekt von Google Cloud fest, das für die in der gcloud CLI durchgeführten Vorgänge in Rechnung gestellt und mit einem Kontingent belastet wird. Verwenden Sie den folgenden
gcloud-Befehl als Beispiel:gcloud config set billing/quota_project PROJECT_IDErsetzen Sie
PROJECT_IDdurch die Projekt-ID des an Google SecOps gebundenen Projekts, das Sie unter Google Cloud -Projekt für Google SecOps konfigurieren erstellt haben. Eine Beschreibung der Felder, die ein Projekt identifizieren, finden Sie unter Projekte erstellen und verwalten.Informationen zu Kontingenten finden Sie in den folgenden Dokumenten:
Wenn ein Fehler auftritt, lesen Sie den Abschnitt Kontingentfehler beheben.
Mitarbeiteridentitätspool erstellen und konfigurieren
Sie können einen Workforce Identity-Pool so konfigurieren, dass er in einen externen Identitätsanbieter (IdP) oder in Google Workspace oder Cloud Identity eingebunden wird.
Console
So erstellen Sie den Workforce Identity-Pool:
Rufen Sie in der Google Cloud Console die Seite Workforce Identity-Pools auf:
Wählen Sie die Organisation für Ihren Workforce Identity-Pool aus. Workforce Identity-Pools sind in allen Projekten und Ordnern einer Organisation verfügbar.
Klicken Sie auf Pool erstellen und gehen Sie so vor:
Geben Sie im Feld Name den Anzeigenamen des Pools ein. Die Pool-ID wird während der Eingabe automatisch aus dem Namen abgeleitet und unter dem Feld Name angezeigt. Sie können die Pool-ID aktualisieren, indem Sie neben der Pool-ID auf Bearbeiten klicken.
Optional: Geben Sie unter Beschreibung eine Beschreibung des Pools ein.
Klicken Sie auf Weiter.
Die Sitzungsdauer des Workforce Identity-Pools beträgt standardmäßig eine Stunde. Diese Dauer bestimmt die Gültigkeit von Google Cloud -Zugriffstokens, der Google Cloud Workforce Identity Federation Console und der gcloud CLI-Anmeldesitzungen. Sie können den Pool aktualisieren, um eine benutzerdefinierte Sitzungsdauer zwischen 15 Minuten und 12 Stunden festzulegen.
gcloud
Erstellen Sie einen Workforce Identity-Pool.
Verwenden Sie den folgenden
gcloud-Befehl als Beispiel:gcloud iam workforce-pools create WORKFORCE_POOL_ID\ --location="global" \ --organization=ORGANIZATION_ID \ --description="WORKFORCE_POOL_DESCRIPTION" \ --display-name="WORKFORCE_POOL_DISPLAY_NAME" \ --session-duration=SESSION_DURATIONErsetzen Sie Folgendes:
WORKFORCE_POOL_ID: der Wert, den Sie für die ID des Workforce Identity-Pools definiert haben.ORGANIZATION_ID: die numerische Organisations-ID.WORKFORCE_POOL_DESCRIPTION: eine optionale Beschreibung des Workforce Identity-Pools.WORKFORCE_POOL_DISPLAY_NAME: ein optionaler nutzerfreundlicher Name für den Workforce Identity-Pool.SESSION_DURATION: ein optionaler Wert für die Sitzungsdauer, ausgedrückt als Zahl, an diesangehängt wird, z. B.3600s. Diese Dauer bestimmt die Gültigkeit von Google Cloud-Zugriffstokens, der Google Cloud Console für die Mitarbeiteridentitätsföderation und der gcloud CLI-Anmeldesitzungen. Sie können den Pool aktualisieren, um eine benutzerdefinierte Sitzungsdauer zwischen 15 Minuten und 12 Stunden festzulegen.
Wenn Sie sich mit Google Workspace oder Cloud Identity in Google SecOps anmelden möchten, fügen Sie dem Befehl die Flags
--allowed-services domain=backstory.chronicle.securityund--disable-programmatic-signinhinzu.gcloud iam workforce-pools create WORKFORCE_POOL_ID\ --location="global" \ --organization="ORGANIZATION_ID" \ --description="WORKFORCE_POOL_DESCRIPTION" \ --display-name="WORKFORCE_POOL_DISPLAY_NAME" \ --session-duration=SESSION_DURATION \ --allowed-services domain=backstory.chronicle.security \ --disable-programmatic-signinMit diesem Befehl wird ein Workforce Identity-Pool erstellt, der die Anmeldung bei Google Cloudnicht unterstützt. Wenn Sie die Anmeldefunktion aktivieren möchten, müssen Sie für jedes Szenario die entsprechenden Flags verwenden.
Wenn Sie aufgefordert werden, die Chronicle API zu aktivieren, geben Sie
Yesein.
Workforce Identity-Anbieter erstellen
Ein Anbieter von Pools für Workforce Identity beschreibt eine Beziehung zwischen IhrerGoogle Cloud -Organisation und Ihrem IdP. Wählen Sie den Abschnitt aus, der Ihrem Authentifizierungsprotokoll entspricht:
SAML-Workforce Identity-Pool-Anbieter erstellen
Console
So konfigurieren Sie den Anbieter des Workforce Identity-Pools:
Rufen Sie in der Google Cloud Console die Seite Workforce Identity-Pools auf:
Wählen Sie in der Tabelle Workforce Identity-Pools den Pool aus, für den Sie den Anbieter erstellen möchten.
Klicken Sie im Bereich Anbieter auf Anbieter hinzufügen.
Wählen Sie unter Anbieter auswählen Ihren IdP aus.
Wenn Ihr IdP nicht aufgeführt ist, wählen Sie Generischer Identitätsanbieter aus.
Wählen Sie unter Authentifizierungsprotokoll auswählen die Option SAML aus.
Führen Sie im Abschnitt Anbieter erstellen folgende Schritte aus:
Geben Sie unter Name einen Namen für den Anbieter ein.
Optional: Geben Sie unter Beschreibung eine Beschreibung für den Anbieter ein.
Wählen Sie in der IdP-Metadatendatei (XML) die XML-Metadatendatei aus, die Sie zuvor in dieser Anleitung generiert haben.
Anbieter aktivieren muss aktiviert sein.
Klicken Sie auf Weiter.
Kopieren Sie im Abschnitt Anbieterinformationen teilen die URLs:
- Konfigurieren Sie die erste URL (
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) als Entitäts-ID in Ihrem IdP. - Die zweite URL (
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) wird für die Validierung von Tokens und Zuordnungen der Mitarbeiteridentitätsföderation verwendet (mit der Funktion IdP-Token debuggen). Achten Sie darauf, dass Ihr IdP sowohl diese URL als auch die Google SecOps ACS-Anmelde-URL (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) enthält, die Sie unter SAML-Anwendung in Ihrem IdP konfigurieren konfiguriert haben.
- Konfigurieren Sie die erste URL (
Klicken Sie auf Weiter.
Führen Sie im Abschnitt Anbieter konfigurieren die folgenden Schritte aus:
Geben Sie unter Attributzuordnung die Zuordnungen in die entsprechenden Felder ein. Beispiel:
Google X (wobei X eine Zahl ist) SAML X (wobei X eine Zahl ist) google.subjectassertion.subjectgoogle.groupsassertion.attributes.groupsgoogle.display_nameassertion.attributes.display_name[0]attribute.first_nameassertion.attributes.first_name[0]attribute.last_nameassertion.attributes.last_name[0]attribute.user_emailassertion.attributes.emailaddress[0]Wenn Sie diese Konfiguration für Google Security Operations ausführen, das Google Security Operations SIEM und Google SecOps SOAR umfasst, ordnen Sie die folgenden von Google SecOps SOAR erforderlichen Attribute zu:
attribute.first_nameattribute.last_nameattribute.user_emailgoogle.groupsgoogle.display_name
Optional: Wenn Sie Microsoft Entra ID als IdP ausgewählt haben, können Sie die Anzahl der Gruppen so erhöhen:
- Wählen Sie Zusätzliche Attribute verwenden aus.
- Geben Sie im Feld Aussteller-URI für zusätzliche Attribute die Aussteller-URL ein.
- Geben Sie im Feld Client-ID für zusätzliche Attribute die Client-ID ein.
- Geben Sie im Feld Clientschlüssel für zusätzliche Attribute den Clientschlüssel ein.
- Wählen Sie in der Liste Typ für zusätzliche Attribute einen Attributtyp für zusätzliche Attribute aus.
- Geben Sie im Feld Filter für zusätzliche Attribute einen Filterausdruck ein, mit dem die Microsoft Graph API nach Gruppen abgefragt wird.
Optional: Klicken Sie auf Bedingung hinzufügen und geben Sie einen CEL-Ausdruck ein, der eine Attributbedingung darstellt, um eine Attributbedingung hinzuzufügen. Wenn Sie beispielsweise das Attribut
ipaddrauf einen bestimmten IP-Bereich beschränken möchten, können Sie die Bedingungassertion.attributes.ipaddr.startsWith('98.11.12.')festlegen. Durch diese Beispielbedingung wird gewährleistet, dass sich nur Nutzer mit einer IP-Adresse, die mit98.11.12.beginnt, über diesen Workforce-Anbieter anmelden können.Wenn Sie das detaillierte Audit-Logging aktivieren möchten, klicken Sie unter Detailliertes Logging auf den Schalter Audit-Logging für Attributwerte aktivieren.
Klicken Sie auf Senden, um den Anbieter zu erstellen.
gcloud
So konfigurieren Sie den Workforce Identity-Pool-Anbieter:
Laden Sie die Metadatendatei der SAML-Anwendung in Ihr Cloud Shell-Basisverzeichnis hoch, indem Sie auf Mehr > klicken. Dateien können nur in Ihr Basisverzeichnis hochgeladen werden. Weitere Optionen zum Übertragen von Dateien zwischen Cloud Shell und Ihrer lokalen Workstation finden Sie unter Dateien und Ordner aus Cloud Shell hoch- und herunterladen.
Notieren Sie sich den Verzeichnispfad, in den Sie die XML-Datei mit den Metadaten der SAML-Anwendung in Cloud Shell hochgeladen haben. Sie benötigen diesen Pfad im nächsten Schritt.
Erstellen Sie einen Workforce Identity-Pool-Anbieter und geben Sie die IdP-Details an.
Verwenden Sie den folgenden
gcloud-Befehl als Beispiel:gcloud iam workforce-pools providers create-saml WORKFORCE_PROVIDER_ID \ --workforce-pool="WORKFORCE_POOL_ID" \ --location="global" \ --display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \ --description="WORKFORCE_PROVIDER_DESCRIPTION" \ --idp-metadata-path=PATH_TO_METADATA_XML \ --attribute-mapping="ATTRIBUTE_MAPPINGS"Eine Beschreibung der Werte finden Sie unter Implementierung planen.
Ersetzen Sie Folgendes:
WORKFORCE_PROVIDER_ID: der Wert, den Sie für die ID des Workforce-Anbieters definiert haben.WORKFORCE_POOL_ID: der Wert, den Sie für die ID des Mitarbeiteridentitätspools definiert haben.WORKFORCE_PROVIDER_DISPLAY_NAME: ein optionaler nutzerfreundlicher Name für den Workforce-Anbieter. Er muss weniger als 32 Zeichen lang sein.WORKFORCE_PROVIDER_DESCRIPTION: eine optionale Beschreibung des Workforce-Anbieters.PATH_TO_METADATA_XML: der Cloud Shell-Verzeichnispfad der XML-Datei mit den Anwendungsmetadaten, die Sie mit Cloud Shell hochgeladen haben, z. B./path/to/sso_metadata.xml.ATTRIBUTE_MAPPINGS: Definition, wie Assertionsattribute Google Cloud -Attributen zugeordnet werden. Die Common Expression Language wird verwendet, um diese Zuordnung zu interpretieren. Beispiel:
google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.groupsIm vorherigen Beispiel werden die folgenden Attribute zugeordnet:
assertion.subjectzugoogle.subject. Dies ist eine Mindestanforderung.assertion.attributes.name[0]zugoogle.display_name.assertion.attributes.groupszum Attributgoogle.groupshinzu.
Wenn Sie diese Konfiguration für Google Security Operations ausführen, das Google Security Operations SIEM und Google SecOps SOAR umfasst, ordnen Sie die folgenden von Google SecOps SOAR erforderlichen Attribute zu:
attribute.first_nameattribute.last_nameattribute.user_emailgoogle.groupsgoogle.display_name
Die vollständige Zuordnung sieht also so aus:
google.subject=assertion.subject,google.groups=assertion.attributes.groups,attribute.first_name=assertion.attributes.first_name[0],attribute.last_name=assertion.attributes.last_name[0],attribute.user_email=assertion.attributes.emailaddress[0],google.display_name=assertion.attributes.display_name[0]Weitere Informationen finden Sie unter Nutzer für Google SecOps SOAR bereitstellen und zuordnen.
Wenn Sie Ihre SAML-Anwendung so konfigurieren, dass Informationen zur Gruppenmitgliedschaft übergeben werden, sind gängige Gruppenattributnamen
groups,idpGroupundmemberOf. Achten Sie bei der Attributzuordnung in der Mitarbeiteridentitätsföderation darauf, dass der Attributname inassertion.attributes.ATTRIBUTE_NAMEgenau mit dem in Ihrem IdP konfigurierten Namen übereinstimmt (Groß-/Kleinschreibung beachten).Im folgenden Beispiel werden mehrere Gruppen dem Attribut
google.groupszugeordnet:google.groups="(has(assertion.attributes.idpGroup) ? assertion.attributes.idpGroup : []) + (has(assertion.attributes.groups) ? assertion.attributes.groups : []) + (has(assertion.attributes.memberOf) ? assertion.attributes.memberOf : [])"Im folgenden Beispiel wird die Gruppe
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/groupmit Sonderzeichengoogle.groupszugeordnet:google.groups="assertion.attributes['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"Weitere Informationen zum Zuordnen von Attributen finden Sie unter Attributzuordnungen.
OIDC-Anbieter von Workforce Identity-Pools erstellen
So erstellen Sie einen OIDC-Anbieter von Mitarbeiteridentitätspools mit derGoogle Cloud Console oder der gcloud CLI:
Folgen Sie der Anleitung unter OIDC-Workforce-Pool-Anbieter erstellen, um den Anbieter in Ihrem Workforce Identity-Pool zu erstellen.
Wenden Sie beim Konfigurieren des OIDC-Anbieters die folgenden Google SecOps-Einstellungen an:
Weiterleitungs-URIs: Achten Sie darauf, dass Ihre OIDC-IdP-Anwendung die beiden folgenden Weiterleitungs-URIs enthält, wie unter OIDC-Anwendung in Ihrem IdP konfigurieren beschrieben:
- Weiterleitungs-URI für die Anmeldung bei Google SecOps (
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) - Weiterleitungs-URI für die Validierung der Mitarbeiteridentitätsföderation (
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
- Weiterleitungs-URI für die Anmeldung bei Google SecOps (
Attributzuordnungen: Ordnen Sie Ihre OIDC-Anforderungen mithilfe der Common Expression Language (CEL) Google Cloud -Attributen zu. Ordnen Sie mindestens
google.subjectzuassertion.subundgoogle.groupszuassertion.groupszu, damit die RBAC von Google SecOps wie erwartet funktioniert:google.subject=assertion.sub,google.groups=assertion.groupsWenn Sie Google Security Operations konfigurieren, das Google Security Operations SIEM und Google SecOps SOAR umfasst, müssen Sie auch die von Google SecOps SOAR erforderlichen Attribute zuordnen. Beispiel:
google.subject=assertion.sub,google.groups=assertion.groups,attribute.first_name=assertion.given_name,attribute.last_name=assertion.family_name,attribute.user_email=assertion.email,google.display_name=assertion.nameBeispiele für die erweiterte Gruppenzuordnung
Wenn Sie Ihre OIDC-Anwendung so konfigurieren, dass Informationen zur Gruppenmitgliedschaft übergeben werden, sind gängige Namen für Gruppenanforderungen
groups,idpGroupundmemberOf. Achten Sie bei der Attributzuordnung der Mitarbeiteridentitätsföderation darauf, dass der Anspruchsname inassertion.CLAIM_NAMEgenau mit dem in Ihrem IdP konfigurierten Namen übereinstimmt (Groß-/Kleinschreibung beachten).Im folgenden Beispiel werden mehrere Gruppen dem Attribut
google.groupszugeordnet:google.groups="(has(assertion.idpGroup) ? assertion.idpGroup : []) + (has(assertion.groups) ? assertion.groups : []) + (has(assertion.memberOf) ? assertion.memberOf : [])"Im folgenden Beispiel wird eine Gruppenanforderung mit Sonderzeichen (z. B. einem URI-Schema)
google.groupszugeordnet:google.groups="assertion['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
Optional: Erstellen Sie eine Attributbedingung. Wenn Ihr mandantenfähiger IdP einen einzelnen Aussteller-URI hat, müssen Sie Attributbedingungen verwenden, um sicherzustellen, dass der Zugriff auf den richtigen Mandanten beschränkt ist. Sie können die Anmeldung beispielsweise auf Nutzer mit einer bestimmten Rolle oder E-Mail-Domain beschränken. Weitere Informationen finden Sie unter Attributbedingungen bei der Föderation mit mandantenfähigen Identitätsanbietern verwenden.
Nachdem Sie den OIDC-Mitarbeiteridentitätsanbieter erstellt haben, empfehlen wir, Ihre Token- und Attributzuordnungen mit IdP-Token debuggen zu validieren und dann mit Rolle zuweisen, um die Anmeldung bei Google SecOps zu ermöglichen fortzufahren, um die verbleibenden Abschnitte in diesem Dokument abzuschließen.
Rolle zuweisen, um die Anmeldung in Google SecOps zu ermöglichen
In den folgenden Schritten wird beschrieben, wie Sie eine bestimmte Rolle mit IAM zuweisen, damit sich Gruppen und Nutzer in Ihrem Workforce Identity-Pool in Google SecOps anmelden können. Führen Sie die Konfiguration mit dem zuvor erstellten, an Google SecOps gebundenen Projekt Google Cloud durch.
Console
Rufen Sie in der Google Cloud Console die Seite IAM auf.
Wählen Sie das an Google SecOps gebundene Projekt Google Cloud aus.
Klicken Sie auf dem Tab Nach Hauptkonten ansehen auf Zugriff gewähren.
Geben Sie im Abschnitt Hauptkonten hinzufügen im Feld Neue Hauptkonten eine Hauptkonto-ID ein.
Beispiel:
Wenn Sie alle Identitäten hinzufügen möchten, die mit dem zuvor erstellten Workforce Identity-Pool und Workforce-Anbieter verwaltet werden, geben Sie Folgendes ein:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_IDWenn Sie eine bestimmte Gruppe als Hauptkonto hinzufügen möchten, geben Sie Folgendes ein:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID
Ersetzen Sie Folgendes:
WORKFORCE_POOL_ID: der Wert, den Sie für die ID des Mitarbeiteridentitätspools definiert haben.GROUP_ID: eine Gruppe im zugeordnetengoogle.groups-Anspruch. Diese Gruppe muss in Ihrem IdP erstellt worden sein.
Wählen Sie im Abschnitt Rollen zuweisen eine entsprechende Chronicle API-Rolle aus oder suchen Sie danach, z. B. Chronicle API Viewer (
roles/chronicle.viewer).Klicken Sie auf Speichern.
Wiederholen Sie die Schritte 3 bis 5 für jedes Hauptkonto, dem Sie Rollen zuweisen möchten.
gcloud
Weisen Sie Nutzern oder Gruppen, die Zugriff auf die Google SecOps-Anwendung haben sollen, die Rolle Chronicle API Viewer (
roles/chronicle.viewer) zu.- Im folgenden Beispiel wird die Rolle „Chronicle API Viewer“ Identitäten zugewiesen, die mit dem zuvor erstellten Workforce Identity-Pool und Workforce-Anbieter verwaltet werden.
gcloud projects add-iam-policy-binding PROJECT_ID \ --role roles/chronicle.viewer \ --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*"Ersetzen Sie Folgendes:
PROJECT_ID: durch die Projekt-ID des an Google SecOps gebundenen Projekts, das Sie unter Google Cloud -Projekt für Google SecOps konfigurieren konfiguriert haben. Eine Beschreibung der Felder, die ein Projekt identifizieren, finden Sie unter Projekte erstellen und verwalten.WORKFORCE_POOL_ID: der Wert, den Sie für die ID des Mitarbeiteridentitätspools definiert haben.Führen Sie den folgenden Befehl aus, um einer bestimmten Gruppe die Rolle „Chronicle API Viewer“ zuzuweisen:
gcloud projects add-iam-policy-binding PROJECT_ID \ --role roles/chronicle.viewer \ --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"Ersetzen Sie
GROUP_ID: eine Gruppe im zugeordnetengoogle.groups-Anspruch. Diese Gruppe muss in Ihrem IdP erstellt worden sein.Konfigurieren Sie zusätzliche IAM-Richtlinien, um die Anforderungen Ihrer Organisation zu erfüllen.
Erforderlich: Um die Authentifizierung abzuschließen und Nutzern den Zugriff auf die Google SecOps-Plattform zu ermöglichen, müssen Sie den Nutzerzugriff über die SOAR-Seite von Google SecOps konfigurieren. Weitere Informationen finden Sie unter Nutzer in der Google SecOps-Plattform zuordnen.
Wiederholen Sie die vorherigen Schritte, um weitere Rollen zuzuweisen.
SSO für Ihre Google SecOps-Instanz konfigurieren
Die letzte Aufgabe bei der Integration Ihres Drittanbieter-IdP in Google SecOps ist die Konfiguration des SSO. Nach Abschluss dieses Schritts können sich Nutzer mit ihren IdP-Anmeldedaten in Google SecOps anmelden.
So konfigurieren Sie SSO:
- Rufen Sie in der Google Cloud Console die Seite Sicherheit > Google SecOps auf.
- Klicken Sie auf den Tab Einmalanmeldung (SSO) und wählen Sie dann Mitarbeiteridentitätsföderation aus.
- Wählen Sie aus der Liste der verfügbaren Anbieter den Anbieter für die Mitarbeiteridentitätsföderation aus, den Sie unter Anbieter für Workforce Identity-Pool erstellen erstellt haben.
- Optional: Klicken Sie auf SSO-Einrichtung testen, um die SSO-Konfiguration zu testen. Wenn die Konfiguration erfolgreich ist, werden Sie zum Anmeldebildschirm Ihres IdP weitergeleitet.
- Klicken Sie auf Speichern.
Konfiguration der Mitarbeiteridentitätsföderation verwalten
In diesem Abschnitt wird erläutert, wie Sie Ihre Anbietereinstellungen aktualisieren und prüfen, ob die Zugriffsebenen der Nutzer richtig konfiguriert sind.
Zugriffssteuerung für Google SecOps-Funktionen prüfen oder konfigurieren
Wenn Sie die Mitarbeiteridentitätsföderation mit Attributen oder Gruppen konfiguriert haben, die dem Attribut google.groups zugeordnet sind, werden diese Informationen an Google SecOps übergeben, damit Sie die rollenbasierte Zugriffssteuerung (RBAC) für Google SecOps-Funktionen konfigurieren können.
Wenn die Google SecOps-Instanz eine vorhandene RBAC-Konfiguration hat, prüfen Sie, ob die ursprüngliche Konfiguration wie erwartet funktioniert.
Wenn Sie die Zugriffssteuerung noch nicht konfiguriert haben, finden Sie unter Funktionszugriffssteuerung mit IAM konfigurieren Informationen zum Steuern des Zugriffs auf Funktionen.
Konfiguration für die Mitarbeiteridentitätsföderation ändern
Wenn Sie den Workforce Identity-Pool oder den Workforce-Anbieter aktualisieren müssen, finden Sie unter Workforce Identity-Pool-Anbieter verwalten Informationen zum Aktualisieren der Konfiguration.
Im Abschnitt Schlüsselverwaltung unter SAML-Mitarbeiterpoolanbieter erstellen wird beschrieben, wie Sie IdP-Signaturschlüssel aktualisieren und dann die Konfiguration des Mitarbeiterpoolanbieters mit der neuesten XML-Datei mit Anwendungsmetadaten aktualisieren. Informationen zu OIDC-Anbietern finden Sie unter Anbieter aktualisieren und OIDC-JWKs verwalten.
Console
So aktualisieren Sie einen bestimmten Workforce-Pool:
Rufen Sie die Seite Mitarbeiteridentitätspools auf.
Wählen Sie in der Tabelle den Pool aus.
Aktualisieren Sie die Poolparameter.
Klicken Sie auf Pool speichern.
So aktualisieren Sie einen Anbieter:
Rufen Sie die Seite Mitarbeiteridentitätspools auf.
Wählen Sie in der Tabelle den Pool aus, für den Sie den Anbieter aktualisieren möchten.
In der Tabelle Anbieter, klicken Sie auf Bearbeiten.
Aktualisieren Sie die Anbieterdetails.
Klicken Sie auf Speichern, um die aktualisierten Anbieterdetails zu speichern.
gcloud
Hier sehen Sie ein Beispiel für einen gcloud-Befehl, mit dem die Konfiguration des Workforce-Anbieters aktualisiert wird:
gcloud iam workforce-pools providers update-saml WORKFORCE_PROVIDER_ID \
--workforce-pool=WORKFORCE_POOL_ID \
--location="global" \
--display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \
--description="WORKFORCE_PROVIDER_DESCRIPTION" \
--idp-metadata-path=PATH_TO_METADATA_XML \
--attribute-mapping="ATTRIBUTE_MAPPINGS"
Ersetzen Sie Folgendes:
WORKFORCE_PROVIDER_ID: der Wert, den Sie für die ID des Workforce-Anbieters definiert haben.WORKFORCE_POOL_ID: der Wert, den Sie für die ID des Mitarbeiteridentitätspools definiert haben.WORKFORCE_PROVIDER_DISPLAY_NAME: ein nutzerfreundlicher Name für den Workforce-Anbieter. Der Wert muss weniger als 32 Zeichen umfassen.WORKFORCE_PROVIDER_DESCRIPTION: die Beschreibung des Workforce-Anbieters.PATH_TO_METADATA_XML: der Speicherort der aktualisierten XML-Datei mit den Anwendungsmetadaten, z. B./path/to/sso_metadata_updated.xml.ATTRIBUTE_MAPPINGS: die zugeordneten Assertionsattribute zu Google Cloud -Attributen. Beispiel:
google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.memberOf
Konfigurationsprobleme beheben
Wenn bei diesem Vorgang Fehler auftreten, lesen Sie den Abschnitt Fehlerbehebung bei der Mitarbeiteridentitätsföderation, um häufige Probleme zu beheben. Wenn Ihre Organisation Firewalls oder Web-Proxys verwendet, prüfen Sie, ob Ihre Netzwerk-Zulassungsliste die erforderlichen Authentifizierungs- und Mitarbeiteridentitätsföderation-Domains enthält, z. B. auth.backstory.chronicle.security, iam.googleapis.com, accounts.google.com und regionale accounts.google.ccTLD-Domains. Weitere Informationen finden Sie unter Netzwerkzugriff und Zulassungsliste für Domains.
Im folgenden Abschnitt finden Sie Informationen zu häufigen Problemen, die bei der Ausführung der Schritte in diesem Dokument auftreten können.
Sollten weiterhin Probleme auftreten, wenden Sie sich an Ihren Google SecOps-Ansprechpartner und stellen Sie Ihre Chrome-Netzwerkprotokolldatei bereit.
Befehl nicht gefunden
Wenn Sie einen Workforce Identity-Poolanbieter erstellen und die IdP-Details angeben, erhalten Sie den folgenden Fehler:
Error: bash: --attribute-mapping=google.subject=assertion.subject, google.display_name=assertion.attributes.name[0], google.groups=assertion.attributes.groups: command not found
Prüfen Sie, ob PATH_TO_METADATA_XML der Speicherort ist, an den Sie die XML-Datei mit den Metadaten der SAML-Anwendung in Ihr Cloud Shell-Basisverzeichnis hochgeladen haben.
Das Dienstkonto hat keine Berechtigung.
Wenn Sie den Befehl
gcloud projects add-iam-policy-bindingausführen, um Nutzern oder Gruppen Rollen zuzuweisen, erhalten Sie den folgenden Fehler:ERROR: (gcloud.organizations.add-iam-policy-binding) User [ ] does not have permission to access organizations instance [538073083963:getIamPolicy] (or it may not exist): The caller does not have permission
Prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Weitere Informationen finden Sie unter Erforderliche Rollen.
Überprüfungsfehler: Fehlende Sitzungs-ID in der Anfrage
Wenn Sie versuchen, sich zu authentifizieren, wird im Browser der folgende Fehler angezeigt:
Verification failure: missing session ID in request
Prüfen Sie, ob die Basis-URLs für ACS und Entitäts-ID korrekt sind. Weitere Informationen finden Sie unter IdP-Anwendung konfigurieren.
IdP-Token debuggen
Mit der Funktion IdP-Token debuggen in der Mitarbeiteridentitätsföderation können Sie prüfen, ob Ihr Identitätsanbieter die richtigen Attribute und Anforderungen übergibt. Dies wird dringend empfohlen, bevor Nutzer versuchen, sich bei Google SecOps anzumelden, da so Fehler bei der Anmeldung und Attributzuordnung vermieden werden können.
So debuggen Sie Ihr Token:
- Rufen Sie in der Google Cloud Console die Seite Mitarbeiteridentitätsföderation auf.
- Wähle deinen Pool und dann deinen Anbieter aus.
- Klicken Sie auf IdP-Token debuggen.
Eine detaillierte Anleitung zur Verwendung dieser Funktion zur Validierung Ihrer Einrichtung finden Sie im Leitfaden zur Validierung vor der Migration.
JWT-Debugging größer als 4 KB
Wenn Sie Probleme bei der Anmeldung in Google SecOps haben, achten Sie darauf, dass Ihre JSON Web Tokens (JWTs) das Limit von 4 KB für Google SecOps nicht überschreiten. Wenn ein Nutzer die Fehlermeldung „Authentifizierungs-JWT größer als 4 KB. Reduce the group membership data sent from the IdP to resolve this error." (Die vom IdP gesendeten Daten zur Gruppenmitgliedschaft müssen reduziert werden, um diesen Fehler zu beheben.) führen Sie die folgenden Schritte zur Fehlerbehebung aus:
- Token debuggen: Sie können Ihr Token auf der Seite mit den Anbieterdetails in der Mitarbeiteridentitätsföderation debuggen. Rufen Sie dazu Mitarbeiteridentitätsföderation > Mitarbeiterpools > POOL_NAME > PROVIDER_NAME auf und klicken Sie auf IdP-Token debuggen. Wenn Sie diese Funktion nutzen möchten, müssen Sie zuerst die URL „ Google Cloud “ zu den Weiterleitungs-URLs Ihres Identitätsanbieters hinzufügen. Dies gilt sowohl für SAML- als auch für OIDC-Protokolle. Weitere Informationen finden Sie unter Fehlerbehebung bei der Mitarbeiteridentitätsföderation.
Gruppenansprüche filtern: Wenn Ihr Identitätsanbieter viele Gruppen sendet, die nicht mit Google SecOps in Verbindung stehen, filtern Sie den Gruppenanspruch auf der Ebene Ihres Anbieters. Wenn Sie Ihren externen Anbieter so konfigurieren, dass nur die für Google SecOps erforderlichen Gruppen gesendet werden, wird die Größe des JWT reduziert und Authentifizierungsfehler werden vermieden.
- Beispiel (Microsoft Entra ID): Sie können die Microsoft Entra-Gruppenfilterung verwenden, um nur eine minimale Anzahl relevanter Gruppen zu senden. Bearbeiten Sie in Ihrer Entra Enterprise-Anwendung unter „Einmalanmeldung“ die Gruppen-Anforderung, um einen Filter anzuwenden (z. B. mit einer Präfixübereinstimmung), damit nur die erforderlichen Gruppen an Google SecOps gesendet werden. Weitere Informationen finden Sie unter Microsoft Entra-Gruppenfilterung.
Nächste Schritte
Nachdem Sie die Schritte in diesem Dokument ausgeführt haben, gehen Sie so vor:
Führen Sie die Schritte unter Google SecOps-Instanz mit Google Cloud -Diensten verknüpfen aus.
Wenn Sie das Audit-Logging noch nicht eingerichtet haben, fahren Sie mit dem Aktivieren des Google SecOps-Audit-Loggings fort.
Wenn Sie die Konfiguration für Google Security Operations vornehmen, führen Sie die zusätzlichen Schritte unter Nutzer in Google Security Operations bereitstellen, authentifizieren und zuordnen aus.
Wenn Sie den Zugriff auf Funktionen konfigurieren möchten, führen Sie die zusätzlichen Schritte unter Funktionszugriffssteuerung mit IAM konfigurieren und Google SecOps-Berechtigungen in IAM aus.
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten