Configura l'identità di terze parti

Supportata in:

Questa guida è rivolta agli amministratori di Google Security Operations che vogliono autenticare la propria forza lavoro (utenti e gruppi) su Google SecOps utilizzando un provider di identità (IdP) di terze parti. Questo processo è possibile sfruttando laGoogle Cloud federazione delle identità per la forza lavoro.

La federazione delle identità per la forza lavoro supporta qualsiasi IdP che utilizzi Security Assertion Markup Language (SAML 2.0) o OpenID Connect (OIDC), come Okta, Microsoft Entra ID e Microsoft Active Directory Federation Services (AD FS).

Questo documento descrive i passaggi di alto livello per configurare l'autenticazione tramite un IdP basato su SAML o OIDC utilizzando la federazione delle identità per la forza lavoro:

  1. Pianifica le risorse necessarie. Decidi i dettagli del pool di identità della forza lavoro e del provider e identifica gli attributi e i gruppi di utenti necessari per configurare l'accesso alle funzionalità in Google SecOps.
  2. Configura l'applicazione IdP di terze parti. Crea un'applicazione SAML o OIDC IdP da integrare con la federazione delle identità per la forza lavoro e Google SecOps.
  3. Configura la federazione delle identità per la forza lavoro. Configura il pool e il provider di identità della forza lavoro e concedi i ruoli IAM (Identity and Access Management) Google Cloud ai gruppi e agli utenti IdP.
  4. Configura il Single Sign-On (SSO) utilizzando il provider appena creato.

Dopo aver completato questi passaggi, puoi accedere a Google SecOps con il tuo provider di identità e gestire l'accesso degli utenti tramite il controllo controllo dell'accesso basato sui ruoli (RBAC) delle funzionalità utilizzando IAM.

Casi d'uso comuni

Google SecOps richiede l'utilizzo della federazione delle identità per la forza lavoro come broker SSO per una serie di casi d'uso diversi.

Rispetta standard di sicurezza rigorosi

  • Obiettivo: soddisfare standard normativi rigorosi per l'accesso ai sistemi e al cloud.
  • Valore: aiuta a soddisfare i requisiti di conformità FedRAMP High (o superiore) mediante l'intermediazione sicura del Single Sign-On (SSO).

Gestisci controllo dell'accesso aziendali

  • Obiettivo: controllare l'accesso a funzionalità e dati a livello centrale in tutta l'organizzazione.
  • Valore: abilita l'RBAC a livello aziendale in Google SecOps utilizzando IAM.

Terminologia chiave

  • Pool di forza lavoro: una risorsa Google Cloud univoca a livello globale definita a livello di organizzazione che concede alla tua forza lavoro l'accesso a Google SecOps.
  • Provider della forza lavoro: una risorsa secondaria del pool di identità della forza lavoro che archivia i dettagli di configurazione di un singolo IdP esterno.
  • Mappatura degli attributi: il processo di traduzione degli attributi di asserzione forniti dal tuo IdP in attributi Google Cloud utilizzando il Common Expression Language (CEL).
  • URL ACS (Assertion Consumer Service): un URL specifico (a volte chiamato URL Single Sign-On a seconda del provider) utilizzato per configurare un'applicazione SAML per comunicare con Google SecOps.
  • ID entità: un URL identificatore univoco globale che identifica un'applicazione o un servizio specifico, ad esempio Google SecOps, e configura l'applicazione SAML all'interno dell'IdP.

Panoramica della procedura

Google SecOps supporta il Single Sign-On (SSO) SAML o OIDC avviato dal fornitore di servizi (SP). Con questa funzionalità, puoi accedere direttamente a Google SecOps. Google SecOps invia una richiesta all'IdP di terze parti tramite la federazione delle identità per la forza lavoro di IAM.

Dopo che l'IdP ha autenticato l'identità dell'utente, quest'ultimo viene reindirizzato a Google SecOps con un'asserzione di autenticazione SAML o un token ID OIDC. Google Cloud La federazione delle identità per la forza lavoro funge da intermediario nel flusso di autenticazione.

Comunicazione tra Google SecOps, la federazione delle identità per la forza lavoro IAM Google Cloud e l'IdP

Comunicazione tra Google SecOps, la federazione delle identità per la forza lavoro IAM e l'IdP

In linea generale, la comunicazione avviene come segue:

  1. L'utente accede a Google SecOps.
  2. Google SecOps cerca le informazioni dell'IdP nel pool di identità della forza lavoro Google Cloud.
  3. Viene inviata una richiesta all'IdP.
  4. L'asserzione SAML o il token ID OIDC viene inviato al pool di identità della forza lavoro Google Cloud .
  5. Se l'autenticazione va a buon fine, Google SecOps riceve solo gli attributi SAML o le rivendicazioni OIDC definite durante la configurazione del provider della forza lavoro nel pool di identità della forza lavoro.

In qualità di amministratore di Google SecOps, crei gruppi nel tuo provider di identità, configuri l'applicazione SAML o OIDC per trasmettere le informazioni sull'appartenenza ai gruppi nell'asserzione o nel token ID e associ utenti e gruppi ai ruoli predefiniti in IAM o ai ruoli personalizzati che hai creato in Google SecOps.

Prima di iniziare

Pianifica l'implementazione

Questa sezione descrive le decisioni che devi prendere e le informazioni che devi definire prima di eseguire i passaggi descritti in questo documento.

Definisci il pool di identità della forza lavoro e il provider della forza lavoro

Per configurare l'autenticazione tramite un IdP, devi configurare la federazione delle identità per la forza lavoro come intermediario nel flusso di autenticazione. Prima di configurare la federazione delle identità per la forza lavoro, definisci le seguenti risorseGoogle Cloud :

  • Pool di forza lavoro: un pool di identità della forza lavoro concede alla tua forza lavoro (ad esempio i dipendenti) l'accesso a Google SecOps.
  • Provider di forza lavoro: una risorsa secondaria del pool di identità della forza lavoro che archivia i dettagli di un singolo IdP.

La relazione tra il pool di identità della forza lavoro, i provider della forza lavoro e un'istanza di Google SecOps, identificata da un singolo sottodominio del cliente, è la seguente:

  • Un pool di identità della forza lavoro è definito a livello di organizzazione.
  • A ogni istanza di Google SecOps è associato un pool di identità per la forza lavoro configurato.
  • Un pool di identità della forza lavoro può avere più provider di forza lavoro.
  • Ogni provider di forza lavoro integra un IdP di terze parti con il pool di identità della forza lavoro.

  • Il pool di identità della forza lavoro deve essere dedicato a Google SecOps. Non puoi condividere il pool creato per Google SecOps per altri scopi.

  • Il pool di identità per la forza lavoro deve trovarsi nella stessa organizzazioneGoogle Cloud che contiene il progetto associato a Google SecOps.

Di seguito sono riportate le linee guida per la definizione dei valori degli identificatori chiave del pool di forza lavoro e del provider di forza lavoro:

  • ID pool di forza lavoro (WORKFORCE_POOL_ID): definisci un valore che indichi l'ambito o lo scopo del pool di identità della forza lavoro. Il valore deve soddisfare i seguenti requisiti:
    • Deve essere univoco a livello globale.
    • Deve utilizzare solo caratteri minuscoli [a-z], cifre [0-9] e trattini [-].
    • Deve iniziare con un carattere minuscolo [a-z].
    • Deve terminare con un carattere minuscolo [a-z] o una cifra [0-9].
    • Può avere una lunghezza compresa tra 4 e 61 caratteri.
  • Nome visualizzato del pool di forza lavoro (WORKFORCE_POOL_DISPLAY_NAME): definisci un nome facile da usare per il pool di identità della forza lavoro.
  • Descrizione del pool di forza lavoro (WORKFORCE_POOL_DESCRIPTION): definisci una descrizione dettagliata del pool di identità della forza lavoro.
  • ID provider forza lavoro (WORKFORCE_PROVIDER_ID): definisci un valore che indica l'IdP che rappresenta. Il valore deve soddisfare i seguenti requisiti:
    • Deve utilizzare solo caratteri minuscoli [a-z], cifre [0-9] e trattini [-].
    • Può avere una lunghezza compresa tra 4 e 32 caratteri.
  • Nome visualizzato del provider di forza lavoro (WORKFORCE_PROVIDER_DISPLAY_NAME): definisci un nome facile da usare per il provider di forza lavoro. Deve contenere meno di 32 caratteri.
  • Descrizione del provider di forza lavoro (WORKFORCE_PROVIDER_DESCRIPTION): definisci una descrizione dettagliata del provider di forza lavoro.

Definisci gli attributi e i gruppi utente nell'IdP

Prima di creare l'applicazione SAML o OIDC nell'IdP, identifica gli attributi utente o le attestazioni e i gruppi OIDC necessari per configurare l'accesso alle funzionalità in Google SecOps. Gli attributi utente tipici includono:

  • Oggetto
  • Email
  • Nome
  • Cognome
  • Nome visualizzato

Le informazioni sui gruppi e sugli attributi degli utenti o sulle rivendicazioni OIDC sono necessarie durante le seguenti fasi di questo processo:

  • Quando configuri l'applicazione SAML o OIDC, crei i gruppi definiti durante la pianificazione. Configuri l'applicazione IdP per trasmettere le appartenenze ai gruppi nell'asserzione SAML o nel token ID OIDC.

  • Quando crei il provider per la forza lavoro, mappi gli attributi delle asserzioni SAML o i claim e i gruppi OIDC agli attributiGoogle Cloud . Queste informazioni vengono inviate nell'asserzione o nel token ID come parte dell'identità di un utente.

Configura l'applicazione IdP

Questa sezione descrive solo la configurazione specifica necessaria in un'applicazione SAML o OIDC IdP per l'integrazione con la federazione delle identità per la forza lavoro Google Cloude Google SecOps. Per i passaggi dettagliati, consulta la documentazione del tuo IdP.

Configura un'applicazione SAML nel tuo IdP

  1. Crea i gruppi nel tuo IdP, se non sono già stati creati.

    Come best practice, utilizza i gruppi anziché i singoli account utente per gestire l'accesso alla tua istanza Google SecOps. Google consiglia di creare nel tuo IdP gruppi che corrispondano direttamente ai ruoli predefiniti di Google SecOps.

    Fai riferimento al seguente esempio:

    Ruolo Google SecOps Gruppo IdP (consigliato)
    Chronicle API Admin chronicle_secops_admins
    Chronicle API Editor chronicle_secops_editor
    Chronicle API Viewer chronicle_secops_viewer
  2. Crea una nuova applicazione SAML nell'IdP.

  3. Configura l'applicazione con quanto segue:

    1. Specifica l'URL Assertion Consumer Service (ACS), che viene anche chiamato URL Single Sign-On a seconda del fornitore di servizi.

      https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      

      Sostituisci quanto segue:

      • WORKFORCE_POOL_ID: l'identificatore che hai definito per il pool di identità della forza lavoro.
      • WORKFORCE_PROVIDER_ID: l'identificatore che hai definito per il provider della forza lavoro.

      Per le descrizioni dei valori, consulta Definisci il pool di identità per la forza lavoro e il provider di forza lavoro.

    2. Specifica il seguente ID entità (chiamato anche ID entità SP).

      https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    3. Configura l'identificatore del nome nell'IdP per assicurarti che il campo NameID venga restituito nella risposta SAML.

      Puoi impostare questo valore in modo che supporti le policy dell'organizzazione, ad esempio l'indirizzo email o il nome utente. Consulta la documentazione del tuo IdP per informazioni sulla configurazione di questo valore. Per ulteriori informazioni su questo requisito, consulta Risolvi i problemi relativi alla federazione delle identità per la forza lavoro.

  4. Aggiungi le istruzioni degli attributi che ti consentono di trasmettere le informazioni utente dall'IdP alle Application Integration. Hai definito gli attributi quando hai pianificato l'implementazione dell'IdP.

    Ad esempio, utilizza la seguente tabella per mappare gli attributi negli IdP di uso comune, come Okta, Microsoft AD FS o Entra ID:

    Nome attributo Valore Okta AD FS/Entra ID (attributo di origine)
    subject user.email user.mail o user.userprincipalname
    emailaddress user.email user.mail
    first_name user.firstName user.givenname
    last_name user.lastName user.surname
    display_name user.displayName user.displayname
    groups Configurato utilizzando un filtro dei gruppi nell'IdP, ad esempio Corrisponde all'espressione regolare con .* Ricavato dalla mappatura dei gruppi nell'IdP

    Se stai configurando un'applicazione IdP Okta, assicurati di selezionare Non specificato come formato quando aggiungi gli attributi. Lascia vuoto lo spazio dei nomi se utilizzi Microsoft AD FS o Entra ID come IdP.

  5. Assegna i gruppi e gli utenti appropriati all'applicazione all'interno del tuo IdP.

    Questi gruppi e utenti saranno autorizzati ad accedere a Google SecOps.

  6. Scarica il file XML dei metadati dell'applicazione.

    Nella sezione successiva, utilizzerai questo file di metadati durante la configurazione del provider di identità per la forza lavoro. Se utilizzi Google Cloud CLI, devi caricare questo file dal tuo sistema locale alla tua directory home Google Cloud utilizzando Cloud Shell.

Configura un'applicazione OIDC nel tuo IdP

Per configurare un'applicazione OIDC nel tuo IdP in modo che si integri con la federazione delle identità per la forza lavoro e Google SecOps, completa i seguenti passaggi:

  1. Se non hai ancora creato i gruppi, creali nel tuo IdP. Come best practice, utilizza i gruppi anziché i singoli account utente per gestire l'accesso alla tua istanza di Google SecOps.

  2. Crea una nuova applicazione OIDC nel tuo IdP e segui i passaggi di preparazione dell'IdP in Crea un provider di pool di forza lavoro OIDC.

  3. Configura l'applicazione con entrambi i seguenti URI di reindirizzamento, che alcuni IdP chiamano URL di callback o URI di reindirizzamento di accesso:

    • Per l'accesso a Google SecOps:

      https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    • Per la convalida della mappatura degli attributi e dei token della federazione delle identità per la forza lavoro:

      https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      

    Sostituisci quanto segue:

    • WORKFORCE_POOL_ID: l'identificatore che hai definito per il pool di identità della forza lavoro.
    • WORKFORCE_PROVIDER_ID: l'identificatore che hai definito per il provider della forza lavoro.

    Per le descrizioni dei valori, consulta Definisci il pool di identità per la forza lavoro e il provider di forza lavoro.

  4. Seleziona il grant type nell'applicazione IdP: il flusso del codice di autorizzazione consigliato o il flusso implicito. Se utilizzi il flusso implicito, assicurati che l'applicazione sia configurata in modo da restituire il token ID.

  5. Configura l'applicazione IdP in modo che restituisca l'attestazione sub e le attestazioni di utenti e gruppi che hai identificato quando hai pianificato l'implementazione dell'IdP.

    Ad esempio, utilizza la seguente tabella per mappare le attestazioni negli IdP di uso comune, come Okta, Microsoft AD FS o Entra ID:

    Nome richiesta Valore Okta AD FS/Entra ID (attributo di origine)
    sub user.email user.mail o user.userprincipalname
    email user.email user.mail
    given_name user.firstName user.givenname
    family_name user.lastName user.surname
    name user.displayName user.displayname
    groups Configurato utilizzando un filtro dei gruppi nell'IdP, ad esempio Corrisponde all'espressione regolare con .* Ricavato dalla mappatura dei gruppi nell'IdP

    Se stai configurando un'applicazione IdP Okta o Entra ID, assicurati che vengano concessi gli ambiti standard (come openid, profile e email) per trasmettere queste rivendicazioni. Se utilizzi Microsoft AD FS o Entra ID, configura le mappature delle attestazioni di conseguenza.

    Se la tua applicazione Okta OIDC utilizza un server di autorizzazione dell'organizzazione, devi anche passare groups come ambito aggiuntivo quando crei il provider di federazione delle identità per la forza lavoro in modo che Okta restituisca la rivendicazione groups. Per ulteriori informazioni, consulta Configura la federazione delle identità per la forza lavoro con Okta.

  6. Assegna i gruppi e gli utenti appropriati all'applicazione OIDC nel tuo IdP.

  7. Registra le seguenti credenziali dalla tua applicazione IdP da utilizzare quando crei un provider di pool di identità per la forza lavoro OIDC:

    • Flusso del codice di autorizzazione: ID client, URI emittente e client secret.
    • Flusso implicito: ID client e URI emittente.

Configura la federazione delle identità per la forza lavoro

Questa sezione descrive solo i passaggi specifici necessari per configurare la federazione delle identità per la forza lavoro con l'applicazione SAML o OIDC dell'IdP creata nella sezione precedente. Per ulteriori informazioni sulla gestione dei pool di identità per la forza lavoro, consulta Gestisci i provider di pool di identità per la forza lavoro.

Imposta il progetto di fatturazione e quota

  1. Apri la console Google Cloud come utente con le autorizzazioni richieste sul progetto associato a Google SecOps. Hai identificato o creato questo utente in precedenza. Consulta la sezione Prima di iniziare.

  2. Avvia una sessione di Cloud Shell.

  3. Imposta il progetto Google Cloud per cui vengono fatturate e addebitate le quote per le operazioni eseguite utilizzando gcloud CLI. Utilizza il seguente comando gcloud come esempio:

    gcloud config set billing/quota_project PROJECT_ID
    

    Sostituisci PROJECT_ID con l'ID progetto del progetto associato a Google SecOps che hai creato in Configura un progetto Google Cloud per Google SecOps. Per una descrizione dei campi che identificano un progetto, consulta Creazione e gestione dei progetti.

    Per informazioni sulle quote, consulta i seguenti documenti:

    Se si verifica un errore, consulta Risolvi gli errori relativi alle quote.

Crea e configura un pool di identità per la forza lavoro

Puoi configurare un pool di identità per la forza lavoro in modo che si integri con un provider di identità (IdP) esterno o con Google Workspace o Cloud Identity.

Console

Per creare il pool di identità della forza lavoro, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Pool di identità per la forza lavoro:

    Vai a Pool di identità per la forza lavoro

  2. Seleziona l'organizzazione per il pool di identità della forza lavoro. I pool di identità della forza lavoro sono disponibili in tutti i progetti e le cartelle di un'organizzazione.

  3. Fai clic su Crea pool e segui questi passaggi:

    1. Nel campo Nome, inserisci il nome visualizzato del pool. L'ID pool viene ricavato automaticamente dal nome durante la digitazione e viene visualizzato sotto il campo Nome. Puoi aggiornare l'ID pool facendo clic su Modifica accanto all'ID pool.

    2. (Facoltativo) In Descrizione, inserisci una descrizione del pool.

  4. Fai clic su Avanti.

La durata della sessione del pool di identità della forza lavoro è di un'ora per impostazione predefinita. Questa durata determina la validità dei token di accesso Google Cloud , della console di federazione delle identità per la forza lavoroGoogle Cloud e delle sessioni di accesso a gcloud CLI. Puoi aggiornare il pool per impostare una durata della sessione personalizzata compresa tra 15 minuti e 12 ore.

gcloud

  1. Crea un pool di identità per la forza lavoro.

    Utilizza il seguente comando gcloud come esempio:

    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
    

    Sostituisci quanto segue:

    • WORKFORCE_POOL_ID: il valore che hai definito per l'ID del pool di identità della forza lavoro.
    • ORGANIZATION_ID: l'ID organizzazione numerico.
    • WORKFORCE_POOL_DESCRIPTION: una descrizione facoltativa del pool di identità della forza lavoro.
    • WORKFORCE_POOL_DISPLAY_NAME: un nome facoltativo facile da usare per il pool di identità della forza lavoro.
    • SESSION_DURATION: un valore facoltativo per la durata della sessione, espresso come numero seguito da s, ad esempio 3600s. Questa durata determina la validità dei token di accesso Google Cloud, della console della federazione delle identità per la forza lavoroGoogle Cloud e delle sessioni di accesso a gcloud CLI. Puoi aggiornare il pool per impostare una durata della sessione personalizzata compresa tra 15 minuti e 12 ore.

    Per utilizzare Google Workspace o Cloud Identity per accedere a Google SecOps, aggiungi i flag --allowed-services domain=backstory.chronicle.security e --disable-programmatic-signin al comando.

    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-signin
    

    Questo comando crea un pool di identità per la forza lavoro che non supporta l'accesso a Google Cloud. Per attivare la funzionalità di accesso, devi utilizzare i flag appropriati per ogni scenario.

  2. Se ti viene richiesto di abilitare l'API Chronicle, inserisci Yes.

Crea un provider di pool di identità per la forza lavoro

Un provider di pool di identità della forza lavoro descrive una relazione tra la tua organizzazioneGoogle Cloud e il tuo IdP. Scegli la sezione corrispondente al tuo protocollo di autenticazione:

Crea un provider di pool di identità della forza lavoro SAML

Console

Per configurare il provider del pool di identità della forza lavoro, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Pool di identità per la forza lavoro:

    Vai a Pool di identità per la forza lavoro

  2. Nella tabella Pool di identità per la forza lavoro, seleziona il pool per cui vuoi creare il provider.

  3. Nella sezione Provider, fai clic su Aggiungi provider.

  4. In Seleziona un provider, seleziona il tuo IdP.

    Se il tuo IdP non è presente nell'elenco, seleziona Provider di identità generico.

  5. In Seleziona un protocollo di autenticazione, seleziona SAML.

  6. Nella sezione Crea un provider, segui questi passaggi:

    1. In Nome, inserisci un nome per il provider.

    2. (Facoltativo) In Descrizione, inserisci una descrizione del provider.

    3. In File di metadati IDP (XML), seleziona il file XML dei metadati che hai generato in precedenza in questa guida.

    4. Assicurati che l'opzione Abilita provider sia attiva.

    5. Fai clic su Continua.

  7. Nella sezione Condividi le informazioni del tuo provider, copia gli URL:

    • Configura il primo URL (https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) come ID entità nell'IdP.
    • Il secondo URL (https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) viene utilizzato per la convalida dei token e della mappatura della federazione delle identità per la forza lavoro (utilizzando la funzionalità Esegui il debug del token IdP). Assicurati che il tuo IdP includa sia questo URL sia l'URL di accesso ACS di Google SecOps (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) che hai configurato in Configura un'applicazione SAML nel tuo IdP.
  8. Fai clic su Continua.

  9. Nella sezione Configura provider, segui questi passaggi:

    1. In Mappatura attributi, inserisci le mappature nelle rispettive caselle. Ad esempio:

      Google X (dove X è un numero) SAML X (dove X è un numero)
      google.subject assertion.subject
      google.groups assertion.attributes.groups
      google.display_name assertion.attributes.display_name[0]
      attribute.first_name assertion.attributes.first_name[0]
      attribute.last_name assertion.attributes.last_name[0]
      attribute.user_email assertion.attributes.emailaddress[0]

      Se stai eseguendo questa configurazione per Google Security Operations, che include Google Security Operations SIEM e Google SecOps SOAR, mappa i seguenti attributi richiesti da Google SecOps SOAR:

      • attribute.first_name
      • attribute.last_name
      • attribute.user_email
      • google.groups
      • google.display_name
    2. (Facoltativo) Se hai selezionato Microsoft Entra ID come IdP, puoi aumentare il numero di gruppi nel seguente modo:

      1. Seleziona Usa attributi aggiuntivi.
      2. Nel campo URI emittente attributi aggiuntivi, inserisci l'URL dell'emittente.
      3. Nel campo Extra Attributes Client ID (ID client attributi aggiuntivi), inserisci l'ID client.
      4. Nel campo Client secret attributi aggiuntivi, inserisci il client secret.
      5. Nell'elenco Tipo di attributi aggiuntivi, seleziona un tipo di attributo per gli attributi aggiuntivi.
      6. Nel campo Extra Attributes Filter (Filtro attributi aggiuntivi), inserisci un'espressione di filtro utilizzata quando si esegue una query sull'API Microsoft Graph per i gruppi.
    3. (Facoltativo) Per aggiungere una condizione di attributo, fai clic su Aggiungi condizione e inserisci un'espressione CEL che rappresenta una condizione di attributo. Ad esempio, per limitare l'attributo ipaddr a un determinato intervallo IP, puoi impostare la condizione assertion.attributes.ipaddr.startsWith('98.11.12.'). Questa condizione di esempio garantisce che solo gli utenti con un indirizzo IP che inizia con 98.11.12. possano accedere utilizzando questo provider della forza lavoro.

    4. Per attivare l'audit logging dettagliato, in Logging dettagliato, fai clic sul pulsante di attivazione/disattivazione Abilita l'audit logging dei valori degli attributi.

  10. Per creare il provider, fai clic su Invia.

gcloud

Per configurare il provider del pool di identità della forza lavoro:

  1. Carica il file dei metadati dell'applicazione SAML nella home directory di Cloud Shell facendo clic su Altro >. I file possono essere caricati solo nella home directory. Per altre opzioni di trasferimento dei file tra Cloud Shell e la tua workstation locale, consulta Carica e scarica file e cartelle da Cloud Shell.

  2. Prendi nota del percorso della directory in cui hai caricato il file XML dei metadati dell'applicazione SAML in Cloud Shell. Questo percorso ti servirà nel passaggio successivo.

  3. Crea un provider di pool di identità della forza lavoro e specifica i dettagli dell'IdP.

    Utilizza il seguente comando gcloud come esempio:

    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"
    

    Per le descrizioni dei valori, consulta Pianifica l'implementazione.

    Sostituisci quanto segue:

    • WORKFORCE_PROVIDER_ID: il valore definito per l'ID provider della forza lavoro.
    • WORKFORCE_POOL_ID: il valore definito per l'ID del pool di identità della forza lavoro.
    • WORKFORCE_PROVIDER_DISPLAY_NAME: un nome facile da ricordare facoltativo per il provider di forza lavoro. Deve contenere meno di 32 caratteri.
    • WORKFORCE_PROVIDER_DESCRIPTION: una descrizione facoltativa del provider della forza lavoro.
    • PATH_TO_METADATA_XML: la posizione della directory di Cloud Shell del file XML dei metadati dell'applicazione che hai caricato utilizzando Cloud Shell, ad esempio: /path/to/sso_metadata.xml.
    • ATTRIBUTE_MAPPINGS: definizione di come mappare gli attributi di asserzione agli attributiGoogle Cloud . Per interpretare questa mappatura viene utilizzato il Common Expression Language. Ad esempio:
    google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.groups
    

    L'esempio precedente mappa i seguenti attributi:

    • assertion.subject a google.subject. Questo è un requisito minimo.
    • assertion.attributes.name[0] a google.display_name.
    • assertion.attributes.groups all'attributo google.groups.

    Se stai eseguendo questa configurazione per Google Security Operations, che include Google Security Operations SIEM e Google SecOps SOAR, mappa i seguenti attributi richiesti da Google SecOps SOAR:

    • attribute.first_name
    • attribute.last_name
    • attribute.user_email
    • google.groups
    • google.display_name

    La mappatura completa è la seguente:

    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]
    

    Per saperne di più, consulta Esegui il provisioning e la mappatura degli utenti per Google SecOps SOAR.

    Quando configuri l'applicazione SAML per trasmettere le informazioni sull'iscrizione ai gruppi, i nomi degli attributi dei gruppi comuni includono groups, idpGroup e memberOf. Nella mappatura degli attributi della federazione delle identità per la forza lavoro, assicurati che il nome dell'attributo in assertion.attributes.ATTRIBUTE_NAME corrisponda esattamente al nome sensibile alle maiuscole configurato nell'IdP.

    L'esempio seguente mappa più gruppi all'attributo google.groups:

    google.groups="(has(assertion.attributes.idpGroup) ? assertion.attributes.idpGroup : []) + (has(assertion.attributes.groups) ? assertion.attributes.groups : []) + (has(assertion.attributes.memberOf) ? assertion.attributes.memberOf : [])"
    

    L'esempio seguente mappa il gruppo http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group contenente caratteri speciali in google.groups:

    google.groups="assertion.attributes['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
    

    Per saperne di più sulla mappatura degli attributi, consulta Mappature degli attributi.

Crea un provider di pool di identità della forza lavoro OIDC

Per creare un provider di pool di identità per la forza lavoro OIDC utilizzando la consoleGoogle Cloud o gcloud CLI, completa i seguenti passaggi:

  1. Segui le istruzioni riportate in Crea un provider di pool di forza lavoro OIDC per creare il provider nel pool di identità della forza lavoro.

  2. Quando configuri il provider OIDC, applica le seguenti impostazioni di Google SecOps:

    • URI di reindirizzamento: assicurati che l'applicazione IdP OIDC includa entrambi i seguenti URI di reindirizzamento, come descritto in Configura un'applicazione OIDC nell'IdP:

      • URI di reindirizzamento per l'accesso a Google SecOps (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
      • URI di reindirizzamento della convalida della federazione delle identità per la forza lavoro (https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
    • Mappature degli attributi: mappa le tue rivendicazioni OIDC agli attributiGoogle Cloud utilizzando il Common Expression Language (CEL). Come minimo, mappa google.subject a assertion.sub e google.groups a assertion.groups in modo che il RBAC di Google SecOps funzioni come previsto:

      google.subject=assertion.sub,google.groups=assertion.groups
      

      Se stai configurando Google Security Operations, che include Google Security Operations SIEM e Google SecOps SOAR, mappa anche gli attributi richiesti da Google SecOps SOAR. Ad esempio:

      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.name
      

      Esempi di mappatura avanzata dei gruppi

      Quando configuri l'applicazione OIDC per trasmettere le informazioni sull'appartenenza ai gruppi, i nomi delle rivendicazioni dei gruppi comuni includono groups, idpGroup e memberOf. Nella mappatura degli attributi della federazione delle identità per la forza lavoro, assicurati che il nome della rivendicazione in assertion.CLAIM_NAME corrisponda esattamente al nome sensibile alle maiuscole configurato nell'IdP.

      L'esempio seguente mappa più gruppi all'attributo google.groups:

      google.groups="(has(assertion.idpGroup) ? assertion.idpGroup : []) + (has(assertion.groups) ? assertion.groups : []) + (has(assertion.memberOf) ? assertion.memberOf : [])"
      

      L'esempio seguente mappa un'attestazione di gruppo contenente caratteri speciali (come uno schema URI) a google.groups:

      google.groups="assertion['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
      
  3. (Facoltativo) Crea una condizione dell'attributo. Se l'IdP multi-tenant ha un singolo URI emittente, devi utilizzare le condizioni degli attributi per assicurarti che l'accesso sia limitato al tenant corretto. Ad esempio, puoi limitare l'accesso agli utenti con un ruolo o un dominio email specifico. Per saperne di più, consulta Utilizza le condizioni degli attributi durante la federazione con provider di identità multi-tenant.

  4. Dopo aver creato il provider di forza lavoro OIDC, ti consigliamo di convalidare le mappature dei token e degli attributi utilizzando Esegui il debug del token IdP, quindi di continuare con Concedi un ruolo per abilitare l'accesso a Google SecOps per completare le sezioni rimanenti di questo documento.

Concedi un ruolo per abilitare l'accesso a Google SecOps

I passaggi seguenti descrivono come concedere un ruolo specifico utilizzando IAM in modo che i gruppi e gli utenti nel tuo pool di identità della forza lavoro possano accedere a Google SecOps. Esegui la configurazione utilizzando il progetto Google Cloud associato a Google SecOps che hai creato in precedenza.

Console

  1. Nella console Google Cloud vai alla pagina IAM.

    Vai a IAM

  2. Seleziona il progetto Google Cloud associato a Google SecOps.

  3. Nella scheda Visualizza per entità, fai clic su Concedi l'accesso.

  4. Nella sezione Aggiungi entità, inserisci un identificatore entità nel campo Nuove entità.

    Ad esempio:

    • Per aggiungere tutte le identità gestite utilizzando il pool di identità della forza lavoro e il provider della forza lavoro che hai creato in precedenza, inserisci quanto segue:

      principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID

    • Per aggiungere un gruppo specifico come entità, inserisci quanto segue:

      principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID

    Sostituisci quanto segue:

    • WORKFORCE_POOL_ID: il valore definito per l'ID del pool di identità della forza lavoro.
    • GROUP_ID: un gruppo nell'attestazione google.groups mappata. Questo gruppo deve essere creato nel tuo IdP.
  5. roles/chronicle.viewer

  6. Fai clic su Salva.

  7. Ripeti i passaggi da 3 a 5 per ogni entità a cui vuoi concedere i ruoli.

gcloud

  1. Concedi il ruolo Chronicle API Viewer (roles/chronicle.viewer) agli utenti o ai gruppi che devono avere accesso all'applicazione Google SecOps.

    • L'esempio seguente concede il ruolo Visualizzatore API Chronicle alle identità gestite utilizzando il pool di identità per la forza lavoro e il provider di forza lavoro che hai creato in precedenza.
    gcloud projects add-iam-policy-binding PROJECT_ID \
      --role roles/chronicle.viewer \
      --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*"
    

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto del progetto associato a Google SecOps che hai configurato in Configura un progetto Google Cloud per Google SecOps. Per una descrizione dei campi che identificano un progetto, consulta Creazione e gestione dei progetti.
    • WORKFORCE_POOL_ID: il valore definito per l'ID del pool di identità della forza lavoro.

    • Per concedere il ruolo Chronicle API Viewer a un gruppo specifico, esegui questo comando:

    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"
    

    Sostituisci GROUP_ID: un gruppo nell'attestazione google.groups mappata. Questo gruppo deve essere creato nel tuo IdP.

  2. Configura policy IAM aggiuntive per soddisfare i requisiti della tua organizzazione.

  3. Obbligatorio: per completare l'autenticazione e consentire l'accesso degli utenti alla piattaforma Google SecOps, devi configurare l'accesso degli utenti dal lato SOAR di Google SecOps. Per saperne di più, consulta Mappa gli utenti nella piattaforma Google SecOps.

Ripeti i passaggi precedenti per concedere altri ruoli.

Configura il servizio SSO per l'istanza Google SecOps

L'attività finale dell'integrazione dell'IdP di terze parti con Google SecOps consiste nella configurazione del SSO. Dopo aver completato questo passaggio, gli utenti potranno accedere a Google SecOps utilizzando le proprie credenziali IdP.

Di seguito sono riportati i passaggi per configurare l'SSO:

  1. Nella console Google Cloud , vai alla pagina Sicurezza > Google SecOps.
  2. Fai clic sulla scheda Single Sign-On e poi seleziona Federazione delle identità per la forza lavoro.
  3. Dall'elenco dei provider disponibili, seleziona il provider della federazione delle identità per la forza lavoro che hai creato in Crea un provider di pool di identità per la forza lavoro.
  4. (Facoltativo) Per testare la configurazione SSO, fai clic su Test SSO Setup (Testa la configurazione SSO). Se la configurazione va a buon fine, verrai reindirizzato alla schermata di accesso dell'IdP.
  5. Fai clic su Salva.

Gestisci la configurazione della federazione delle identità per la forza lavoro

Questa sezione spiega come aggiornare le impostazioni del provider e verificare che i livelli di accesso degli utenti siano configurati correttamente.

Verifica o configura il controllo dell'accesso alle funzionalità di Google SecOps

Se hai configurato la federazione delle identità per la forza lavoro con attributi o gruppi mappati all'attributo google.groups, queste informazioni vengono passate a Google SecOps in modo da poter configurare il RBAC per le funzionalità di Google SecOps.

Se l'istanza Google SecOps ha una configurazione RBAC esistente, verifica che la configurazione originale funzioni come previsto.

Se non hai configurato in precedenza controllo dell'accesso, consulta Configura il controllo dell'accesso alle funzionalità utilizzando IAM per informazioni sul controllo degli accessi alle funzionalità.

Modifica la configurazione della federazione delle identità per la forza lavoro

Se devi aggiornare il pool di identità per la forza lavoro o il provider di forza lavoro, consulta Gestisci i provider di pool di identità per la forza lavoro per informazioni sull'aggiornamento della configurazione.

La sezione Gestione delle chiavi in Crea un provider di pool di forza lavoro SAML descrive come aggiornare le chiavi di firma dell'IdP e poi aggiornare la configurazione del provider di forza lavoro con il file XML dei metadati dell'applicazione più recente. Per i provider OIDC, consulta Aggiorna un provider e Gestisci i JWK OIDC.

Console

Per aggiornare un pool di forza lavoro specifico:

  1. Vai alla pagina Pool di identità per la forza lavoro:

    Vai a Pool di identità per la forza lavoro

  2. Nella tabella, seleziona il pool.

  3. Aggiorna i parametri del pool.

  4. Fai clic su Save pool (Salva pool).

Per aggiornare un provider:

  1. Vai alla pagina Pool di identità per la forza lavoro:

    Vai a Pool di identità per la forza lavoro

  2. Nella tabella, seleziona il pool per cui vuoi aggiornare il provider.

  3. Nella tabella Provider, fai clic su Modifica.

  4. Aggiorna i dettagli del provider.

  5. Per salvare i dettagli aggiornati del provider, fai clic su Salva.

gcloud

Di seguito è riportato un esempio di comando gcloud che aggiorna la configurazione del provider della forza lavoro:

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"

Sostituisci quanto segue:

  • WORKFORCE_PROVIDER_ID: il valore definito per l'ID provider della forza lavoro.
  • WORKFORCE_POOL_ID: il valore definito per l'ID del pool di identità della forza lavoro.
  • WORKFORCE_PROVIDER_DISPLAY_NAME: un nome facile da ricordare per il provider di forza lavoro. Il valore deve contenere meno di 32 caratteri.
  • WORKFORCE_PROVIDER_DESCRIPTION: la descrizione del provider di forza lavoro.
  • PATH_TO_METADATA_XML: la posizione del file XML dei metadati dell'applicazione aggiornato, ad esempio: /path/to/sso_metadata_updated.xml.
  • ATTRIBUTE_MAPPINGS: gli attributi di asserzione mappati agli attributiGoogle Cloud . Ad esempio:

google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.memberOf

Risolvi i problemi di configurazione

Se si verificano errori durante questo processo, consulta Risolvi i problemi relativi alla federazione delle identità per la forza lavoro per risolvere i problemi comuni. Se la tua organizzazione utilizza firewall o proxy web, verifica che la lista consentita della rete includa i domini di autenticazione e federazione delle identità per la forza lavoro richiesti, come auth.backstory.chronicle.security, iam.googleapis.com, accounts.google.com e i domini accounts.google.ccTLD regionali. Per saperne di più, consulta Accesso alla rete e lista consentita dei domini. La sezione seguente fornisce informazioni sui problemi comuni riscontrati durante l'esecuzione dei passaggi descritti in questo documento.

Se i problemi persistono, contatta il tuo rappresentante di Google SecOps e fornisci il file dei log di rete di Chrome.

Comando non trovato

  • Quando crei un provider di pool di identità per la forza lavoro e specifichi i dettagli dell'IdP, viene visualizzato il seguente errore:

    Error: bash: --attribute-mapping=google.subject=assertion.subject,
    google.display_name=assertion.attributes.name[0],
    google.groups=assertion.attributes.groups: command not found
    

Verifica che PATH_TO_METADATA_XML sia la posizione in cui hai caricato il file XML dei metadati dell'applicazione SAML nella directory home di Cloud Shell.

Il chiamante non dispone dell'autorizzazione

  • Quando esegui il comando gcloud projects add-iam-policy-binding per concedere ruoli a utenti o gruppi, viene visualizzato il seguente errore:

    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
    

Verifica di disporre delle autorizzazioni necessarie. Per saperne di più, consulta Ruoli richiesti.

Verifica non riuscita: ID sessione mancante nella richiesta

  • Quando tenti di eseguire l'autenticazione, nel browser viene visualizzato il seguente errore:

    Verification failure: missing session ID in request
    

Verifica che gli URL di base ACS e ID entità siano corretti. Per saperne di più, consulta Configura l'applicazione IdP.

Esegui il debug del token IdP

Puoi utilizzare la funzionalità Esegui il debug del token IdP nella federazione delle identità per la forza lavoro per verificare che il tuo provider di identità trasmetta gli attributi e le rivendicazioni corretti. Questa operazione è vivamente consigliata prima che gli utenti tentino di accedere a Google SecOps, in quanto può aiutare a prevenire errori di accesso e di mappatura degli attributi.

Per eseguire il debug del token:

  1. Nella console Google Cloud , vai a Federazione delle identità per la forza lavoro.
  2. Seleziona il tuo pool, quindi il tuo provider.
  3. Fai clic su Debug IdP Token (Token IdP di debug).

Per una procedura dettagliata sull'utilizzo di questa funzionalità per convalidare la configurazione, consulta la guida alla convalida pre-migrazione.

Esegui il debug di JWT di dimensioni superiori a 4 kB

Se riscontri problemi con l'accesso a Google SecOps, assicurati che i token web JSON (JWT) non superino il limite di 4 kB per Google SecOps. Se un utente riceve uno stato di errore che indica "JWT di autenticazione superiore a 4 kB. Riduci i dati di appartenenza al gruppo inviati dall'IdP per risolvere questo errore.", segui questi passaggi per la risoluzione dei problemi:

  1. Esegui il debug del token: puoi eseguire il debug del token nella pagina dei dettagli del provider all'interno della federazione delle identità per la forza lavoro (andando su Federazione delle identità per la forza lavoro > Pool di forza lavoro > POOL_NAME > PROVIDER_NAME e facendo clic su Esegui il debug del token IdP). Per utilizzare questa funzionalità, devi prima aggiungere l'URL Google Cloud agli URL di reindirizzamento del tuo provider di identità. Questo vale sia per i protocolli SAML che per quelli OIDC. Per ulteriori informazioni, consulta Risoluzione dei problemi relativi alla federazione delle identità per la forza lavoro.
  2. Filtra le rivendicazioni dei gruppi: se il tuo provider di identità invia molti gruppi non correlati a Google SecOps, filtra la rivendicazione dei gruppi a livello di provider. La configurazione del provider esterno per l'invio solo del set minimo di gruppi richiesti per Google SecOps riduce le dimensioni del JWT ed evita errori di autenticazione.

    • Esempio (Microsoft Entra ID): puoi utilizzare il filtro dei gruppi di Microsoft Entra per inviare solo un insieme minimo di gruppi pertinenti. Nell'applicazione aziendale Entra, in Single Sign-On, modifica l'attestazione Gruppi per applicare un filtro (ad esempio, utilizzando una corrispondenza con prefisso) in modo che solo i gruppi richiesti vengano inviati a Google SecOps. Per saperne di più, consulta Filtro dei gruppi Microsoft Entra.

Passaggi successivi

Dopo aver completato i passaggi descritti in questo documento, esegui quanto segue:

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.