Configurar identidade de terceiros

Compatível com:

Este guia é destinado aos administradores do Google Security Operations que querem autenticar a força de trabalho (usuários e grupos) no Google SecOps usando um provedor de identidade (IdP) de terceiros. Esse processo é possível usando a Google Cloud federação de identidade de colaboradores.

A federação de identidade de colaboradores é compatível com qualquer IdP que use a Linguagem de marcação para autorização de segurança (SAML 2.0) ou o OpenID Connect (OIDC), como Okta, Microsoft Entra ID e Serviços de Federação do Active Directory (AD FS) da Microsoft.

Neste documento, descrevemos as etapas gerais para configurar a autenticação por meio de um IdP baseado em SAML ou OIDC usando a federação de identidade de colaboradores:

  1. Planeje os recursos necessários. Decida sobre os detalhes do pool de identidades de colaboradores e do provedor e identifique os atributos de usuário e os grupos necessários para configurar o acesso aos recursos no Google SecOps.
  2. Configure o aplicativo IdP de terceiros. Crie um aplicativo SAML ou OIDC de IdP para integração com a federação de identidade de colaboradores e o Google SecOps.
  3. Configure a federação de identidade de colaboradores. Configure o pool de identidade de colaboradores e o provedor e conceda papéis do Google Cloud Identity and Access Management (IAM) a grupos e usuários do IdP.
  4. Configure o Logon único (SSO) usando o provedor recém-criado.

Depois de concluir essas etapas, faça login no Google SecOps com seu provedor de identidade e gerencie o acesso do usuário usando o controle de acesso baseado em função (RBAC) com o IAM.

Casos de uso comuns

O Google SecOps exige o uso da federação de identidade de colaboradores como o agente de SSO para um conjunto variado de casos de uso.

Atender a padrões de segurança rigorosos

  • Objetivo: atender a padrões regulatórios rígidos para acesso ao sistema e à nuvem.
  • Valor: ajuda a atender aos requisitos de conformidade do FedRAMP High (ou superior) ao intermediar o SSO com segurança.

Gerenciar o controle de acesso corporativo

  • Objetivo: controlar o acesso a recursos e dados de forma centralizada em toda a organização.
  • Valor: ativa o RBAC de nível empresarial no Google SecOps usando o IAM.

Terminologia importante

  • Pool de colaboradores: um recurso globalmente exclusivo do Google Cloud definido no nível da organização que concede aos colaboradores acesso ao Google SecOps.
  • Provedor de colaboradores: um sub-recurso do pool de identidade de colaboradores que armazena detalhes de configuração de um único IdP externo.
  • Mapeamento de atributos: o processo de tradução de atributos de declaração fornecidos pelo IdP em atributos do Google Cloud usando a Common Expression Language (CEL).
  • URL do Assertion Consumer Service (ACS): um URL específico (às vezes chamado de URL de logon único, dependendo do provedor) usado para configurar um aplicativo SAML para se comunicar com o Google SecOps.
  • ID da entidade: um URL identificador globalmente exclusivo que identifica um aplicativo ou serviço específico, como o Google SecOps, e configura o aplicativo SAML no IdP.

Visão geral do processo

O Google SecOps é compatível com SSO SAML ou OIDC iniciado pelo provedor de serviços (SP). Com esse recurso, você navega diretamente para o Google SecOps. O Google SecOps emite uma solicitação pela federação de identidade de colaboradores do IAM para o IdP de terceiros.

Depois que o IdP autentica a identidade do usuário, ele é retornado ao Google SecOps com uma declaração de autenticação SAML ou um token de ID OIDC. Google Cloud A federação de identidade de colaboradores atua como um intermediário no fluxo de autenticação.

Comunicação entre o Google SecOps, a federação de identidade de colaboradores do IAM do Google Cloud e o IdP

Comunicação entre o Google SecOps, a federação de identidade de colaboradores do IAM e o IdP

De modo geral, a comunicação é a seguinte:

  1. O usuário acessa o Google SecOps.
  2. O Google SecOps procura informações do IdP no Google Cloud pool de identidade de colaboradores.
  3. Uma solicitação é enviada ao IdP.
  4. A declaração SAML ou o token de ID do OIDC é enviado ao pool de identidades de colaboradores do Google Cloud .
  5. Se a autenticação for bem-sucedida, o Google SecOps vai receber apenas os atributos SAML ou as declarações OIDC definidas quando você configurou o provedor de força de trabalho no pool de identidades de força de trabalho.

Como administrador do Google SecOps, você cria grupos no seu provedor de identidade, configura o aplicativo SAML ou OIDC para transmitir informações de associação ao grupo na declaração ou no token de ID e associa usuários e grupos aos papéis predefinidos do Google SecOps no IAM ou às funções personalizadas que você criou.

Antes de começar

Planejar a implementação

Nesta seção, descrevemos as decisões que você precisa tomar e as informações que precisa definir antes de realizar as etapas deste documento.

Definir o pool de identidade de colaboradores e o provedor de colaboradores

Para configurar a autenticação por um IdP, é necessário configurar a federação de identidade de colaboradores como intermediária no fluxo de autenticação. Antes de configurar a federação de identidade de colaboradores, defina os seguintes recursos doGoogle Cloud :

  • Pool de colaboradores: um pool de identidade de colaboradores concede aos seus colaboradores (como funcionários) acesso ao Google SecOps.
  • Provedor de colaboradores: um sub-recurso do pool de identidade de colaboradores que armazena detalhes sobre um único IdP.

A relação entre o pool de identidade da força de trabalho, os provedores de força de trabalho e uma instância do Google SecOps, identificada por um único subdomínio de cliente, é a seguinte:

  • Um pool de identidade de colaboradores é definido no nível da organização.
  • Cada instância do Google SecOps tem um pool de identidade de colaboradores configurado e associado a ela.
  • Um pool de identidade de colaboradores pode ter vários provedores de colaboradores.
  • Cada provedor de colaboradores integra um IdP de terceiros ao pool de identidades de colaboradores.

  • O pool de identidade de colaboradores precisa ser dedicado ao Google SecOps. Não é possível compartilhar o pool criado para o Google SecOps para outros fins.

  • Você precisa ter o pool de identidades de colaboradores na mesma organização doGoogle Cloud que contém o projeto vinculado ao Google SecOps.

Confira a seguir as diretrizes para definir os valores dos identificadores de chave do pool e do provedor de colaboradores:

  • ID do pool de colaboradores (WORKFORCE_POOL_ID): defina um valor que indique o escopo ou a finalidade do pool de identidade de colaboradores. O valor precisa atender aos seguintes requisitos:
    • Precisa ser globalmente exclusivo.
    • Use apenas caracteres minúsculos [a-z], dígitos [0-9] e traços [-].
    • Precisa começar com um caractere minúsculo [a-z].
    • Precisa terminar com um caractere minúsculo [a-z] ou um dígito [0-9].
    • Pode ter entre 4 e 61 caracteres.
  • Nome de exibição do pool de colaboradores (WORKFORCE_POOL_DISPLAY_NAME): defina um nome fácil de usar para o pool de identidade de colaboradores.
  • Descrição do pool de colaboradores (WORKFORCE_POOL_DESCRIPTION): defina uma descrição detalhada do pool de identidade de colaboradores.
  • ID do provedor de colaboradores (WORKFORCE_PROVIDER_ID): defina um valor que indique o IdP que ele representa. O valor precisa atender aos seguintes requisitos:
    • Use apenas caracteres minúsculos [a-z], dígitos [0-9] e traços [-].
    • Pode ter entre 4 e 32 caracteres.
  • Nome de exibição do provedor de colaboradores (WORKFORCE_PROVIDER_DISPLAY_NAME): defina um nome fácil de usar para o provedor de colaboradores. Ele precisa ter menos de 32 caracteres.
  • Descrição do provedor de colaboradores (WORKFORCE_PROVIDER_DESCRIPTION): defina uma descrição detalhada do provedor de colaboradores.

Definir atributos e grupos de usuários no IdP

Antes de criar o aplicativo SAML ou OIDC no IdP, identifique os atributos do usuário ou as declarações e os grupos do OIDC necessários para configurar o acesso aos recursos no Google SecOps. Os atributos típicos do usuário incluem:

  • Assunto
  • E-mail
  • Nome
  • Sobrenome
  • Nome de exibição

Você precisa das informações sobre grupos e atributos de usuários ou declarações do OIDC durante as seguintes fases desse processo:

  • Ao configurar o aplicativo SAML ou OIDC, você cria os grupos definidos durante o planejamento. Configure o aplicativo IdP para transmitir as associações de grupo na declaração SAML ou no token de ID do OIDC.

  • Ao criar o provedor de colaboradores, você mapeia atributos de declaração SAML ou declarações e grupos do OIDC para atributos doGoogle Cloud . Essas informações são enviadas na declaração ou no token de ID como parte da identidade de um usuário.

Configurar o aplicativo do IdP

Nesta seção, descrevemos apenas a configuração específica necessária em um aplicativo IdP SAML ou OIDC para integração com a Google Cloud federação de identidade de colaboradores e o Google SecOps. Consulte a documentação do IdP para ver as etapas detalhadas.

Configurar um aplicativo SAML no IdP

  1. Crie grupos no IdP, se ainda não tiver feito isso.

    Como prática recomendada, use grupos em vez de contas de usuário individuais para gerenciar o acesso à sua instância do Google SecOps. O Google recomenda criar grupos no IdP que correspondam diretamente aos papéis padrão do Google SecOps.

    Consulte o exemplo a seguir:

    Papel do Google SecOps Grupo do IdP (sugerido)
    Administrador da API Chronicle chronicle_secops_admins
    Editor da API Chronicle chronicle_secops_editor
    Leitor da API Chronicle chronicle_secops_viewer
  2. Crie um novo aplicativo SAML no IdP.

  3. Configure o aplicativo com o seguinte:

    1. Especifique o URL do Assertion Consumer Service (ACS), que também é chamado de URL de Logon único, dependendo do provedor de serviços.

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

      Substitua:

      • WORKFORCE_POOL_ID: o identificador que você definiu para o pool de identidades de força de trabalho.
      • WORKFORCE_PROVIDER_ID: o identificador que você definiu para o provedor de colaboradores.

      Para descrições de valores, consulte Definir o pool de identidade de colaboradores e o provedor de colaboradores.

    2. Especifique o seguinte ID da entidade (também chamado de ID da entidade do provedor de serviços).

      https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    3. Configure o identificador de nome no IdP para garantir que o campo NameID seja retornado na resposta SAML.

      É possível definir um valor que seja compatível com as políticas da organização, como endereço de e-mail ou nome de usuário. Consulte a documentação do IdP para saber como configurar esse valor. Para mais informações sobre esse requisito, consulte Resolver problemas na federação de identidade de colaboradores.

  4. Adicione as declarações de atributo que permitem transmitir informações do usuário do IdP para as Application Integrations. Você definiu os atributos quando planejou a implementação do IdP.

    Por exemplo, use a tabela a seguir para mapear atributos em IdPs usados com frequência, como Okta, Microsoft AD FS ou Entra ID:

    Nome do atributo Valor do Okta AD FS / Entra ID (atributo de origem)
    subject user.email user.mail ou 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 Configurado usando um filtro de grupo no IdP, como Corresponde à regex com .*. Retirado do mapeamento de grupo no IdP

    Se você estiver configurando um aplicativo IdP do Okta, selecione Não especificado como o formato ao adicionar os atributos. Deixe o namespace em branco ao usar o Microsoft AD FS ou o Entra ID como IdP.

  5. Atribua os grupos e usuários adequados ao aplicativo no IdP.

    Esses grupos e usuários serão autorizados a acessar o Google SecOps.

  6. Faça o download do arquivo XML de metadados do aplicativo.

    Na próxima seção, você vai usar esse arquivo de metadados ao configurar seu provedor de identidade de colaboradores. Se você usa a Google Cloud CLI, precisa fazer upload desse arquivo do sistema local para o diretório inicial do Google Cloud usando o Cloud Shell.

Configurar um aplicativo OIDC no IdP

Para configurar um aplicativo OIDC no IdP para integração com a federação de identidade de colaboradores e o Google SecOps, siga estas etapas:

  1. Se você ainda não tiver criado grupos, faça isso no IdP. Como prática recomendada, use grupos em vez de contas de usuário individuais para gerenciar o acesso à sua instância do Google SecOps.

  2. Crie um novo aplicativo OIDC no IdP e siga as etapas de preparação do IdP em Criar um provedor de pool de força de trabalho OIDC.

  3. Configure o aplicativo com os dois URIs de redirecionamento a seguir, que alguns IdPs chamam de URLs de callback ou URIs de redirecionamento de login:

    • Para fazer login no Google SecOps:

      https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    • Para validação de token e mapeamento de atributos da federação de identidade de colaboradores:

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

    Substitua:

    • WORKFORCE_POOL_ID: o identificador que você definiu para o pool de identidades de força de trabalho.
    • WORKFORCE_PROVIDER_ID: o identificador que você definiu para o provedor de colaboradores.

    Para descrições de valores, consulte Definir o pool de identidade de colaboradores e o provedor de colaboradores.

  4. Selecione o tipo de permissão de acesso no aplicativo do IdP: o fluxo do código de autorização recomendado ou o fluxo implícito. Se você usar o fluxo implícito, verifique se o aplicativo está configurado para retornar o token de ID.

  5. Configure o aplicativo do IdP para retornar a declaração sub e as declarações de usuário e grupo que você identificou ao planejar a implementação do IdP.

    Por exemplo, use a tabela a seguir para mapear declarações em IdPs usados com frequência, como Okta, Microsoft AD FS ou Entra ID:

    Nome da declaração Valor do Okta AD FS / Entra ID (atributo de origem)
    sub user.email user.mail ou 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 Configurado usando um filtro de grupo no IdP, como Corresponde à regex com .*. Retirado do mapeamento de grupo no IdP

    Se você estiver configurando um aplicativo IdP do Okta ou do Entra ID, verifique se os escopos padrão (como openid, profile e email) foram concedidos para transmitir essas declarações. Se estiver usando o Microsoft AD FS ou o Entra ID, configure os mapeamentos de declarações adequadamente.

    Se o aplicativo OIDC do Okta usar um servidor de autorização da organização, você também precisará transmitir groups como um escopo adicional ao criar o provedor de federação de identidade de colaboradores para que o Okta retorne a declaração groups. Para mais informações, consulte Configurar a federação de identidade de colaboradores com o Okta.

  6. Atribua os grupos e usuários apropriados ao aplicativo OIDC no IdP.

  7. Registre as seguintes credenciais do aplicativo IdP para usar ao criar um provedor de pool de identidade de colaboradores do OIDC:

    • Fluxo do código de autorização: ID do cliente, URI do emissor e chave secreta do cliente.
    • Fluxo implícito: ID do cliente e URI do emissor.

Configurar a federação de identidade de colaboradores

Nesta seção, descrevemos apenas as etapas específicas necessárias para configurar a federação de identidade de colaboradores com o aplicativo IdP SAML ou OIDC que você criou na seção anterior. Para mais informações sobre como gerenciar pools de identidade de colaboradores, consulte Gerenciar provedores de pools de identidade de colaboradores.

Definir o projeto de faturamento e cota

  1. Abra o console do Google Cloud como o usuário com as permissões necessárias no projeto vinculado ao Google SecOps. Você identificou ou criou esse usuário anteriormente. Consulte a seção Antes de começar.

  2. Inicie uma sessão do Cloud Shell.

  3. Defina o Google Cloud projeto que é faturado e cobrado pela cota para operações realizadas usando a CLI gcloud. Use o seguinte comando gcloud como exemplo:

    gcloud config set billing/quota_project PROJECT_ID
    

    Substitua PROJECT_ID pelo ID do projeto vinculado ao Google SecOps que você criou em Configurar um projeto do Google Cloud para o Google SecOps. Para uma descrição dos campos que identificam um projeto, consulte Como criar e gerenciar projetos.

    Para informações sobre cotas, consulte os seguintes documentos:

    Se você encontrar um erro, consulte Resolver erros de cota.

Criar e configurar um pool de identidades de colaboradores

É possível configurar um pool de identidades de colaboradores para integração com um provedor de identidade (IdP) externo ou com o Google Workspace ou o Cloud Identity.

Console

Para criar o pool de identidades de colaboradores, faça o seguinte:

  1. No console do Google Cloud , acesse a página Pools de identidade da força de trabalho:

    Acessar pools de identidade de colaboradores

  2. Selecione a organização do pool de identidade de colaboradores. Os pools de identidade de colaboradores estão disponíveis em todos os projetos e pastas de uma organização.

  3. Clique em Criar pool e faça o seguinte:

    1. No campo Nome, digite o nome de exibição do pool. O ID do pool é derivado automaticamente do nome à medida que você digita e é exibido no campo Nome. Para atualizar o ID do pool, clique em Editar ao lado dele.

    2. Opcional: em Descrição, insira uma descrição do pool.

  4. Clique em Próxima.

A duração da sessão do pool de identidade de colaboradores é de uma hora por padrão. Essa duração determina a validade dos tokens de acesso do Google Cloud , do console da federação de identidade de colaboradores doGoogle Cloud e das sessões de login da CLI gcloud. É possível atualizar o pool para definir uma duração da sessão personalizada entre 15 minutos e 12 horas.

gcloud

  1. Crie um pool de identidades de colaboradores.

    Use o seguinte comando gcloud como exemplo:

    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
    

    Substitua:

    • WORKFORCE_POOL_ID: o valor definido para o ID do pool de identidade da força de trabalho.
    • ORGANIZATION_ID: o ID da organização.
    • WORKFORCE_POOL_DESCRIPTION: uma descrição opcional do pool de identidade de força de trabalho.
    • WORKFORCE_POOL_DISPLAY_NAME: um nome opcional e fácil de usar para o pool de Identidades de força de trabalho.
    • SESSION_DURATION: um valor opcional para a duração da sessão, expresso como um número anexado com s, por exemplo, 3600s. Essa duração determina a validade dos tokens de acesso do Google Cloud, do console da federação de identidade de colaboradores doGoogle Cloud e das sessões de login da CLI gcloud. É possível atualizar o pool para definir uma duração da sessão personalizada entre 15 minutos e 12 horas.

    Para usar o Google Workspace ou o Cloud Identity para fazer login no Google SecOps, adicione as flags --allowed-services domain=backstory.chronicle.security e --disable-programmatic-signin ao 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
    

    Esse comando cria um pool de identidades de colaboradores que não é compatível com o login no Google Cloud. Para ativar a funcionalidade de login, use as flags apropriadas para cada cenário.

  2. Se for solicitado que você ative a API Chronicle, digite Yes.

Criar um provedor de pool de identidade de força de trabalho

Um provedor de pool de identidade de colaboradores descreve uma relação entre sua organização doGoogle Cloud e seu IdP. Escolha a seção que corresponde ao seu protocolo de autenticação:

Criar um provedor de pool de identidade de colaboradores SAML

Console

Para configurar o provedor de pool de identidades de colaboradores, faça o seguinte:

  1. No console do Google Cloud , acesse a página Pools de identidade de colaboradores:

    Acessar pools de identidade de colaboradores

  2. Na tabela Pools de identidade de colaboradores, selecione o pool em que você quer criar o provedor.

  3. Na seção Provedores, clique em Adicionar provedor.

  4. Em Selecionar um fornecedor do provedor, escolha seu IdP.

    Se o IdP não estiver listado, selecione Provedor de identidade genérico.

  5. Em Selecionar um protocolo de autenticação, escolha SAML.

  6. Na seção Criar um provedor, faça o seguinte:

    1. Em Nome, digite um nome para o provedor.

    2. Opcional: em Descrição, digite uma descrição para o provedor.

    3. Em Arquivo de metadados do IdP (XML), selecione o arquivo XML de metadados gerado anteriormente neste guia.

    4. Verifique se a opção Ativar provedor está ativada.

    5. Clique em Continuar.

  7. Na seção Compartilhar as informações do provedor, copie os URLs:

    • Configure o primeiro URL (https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) como o ID da entidade no IdP.
    • O segundo URL (https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) é usado para o token da federação de identidade de colaboradores e a validação de mapeamento (usando o recurso Depurar token do IdP). Verifique se o IdP inclui esse URL e o URL de login do ACS do Google SecOps (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) que você configurou em Configurar um aplicativo SAML no IdP.
  8. Clique em Continuar.

  9. Na seção Configurar provedor, faça o seguinte:

    1. Em Mapeamento de atributos, insira os mapeamentos nas caixas correspondentes. Exemplo:

      Google X (em que X é um número) SAML X (em que X é um número)
      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 você estiver realizando essa configuração para o Google Security Operations, que inclui o Google Security Operations SIEM e o Google SecOps SOAR, mapeie os seguintes atributos exigidos pelo Google SecOps SOAR:

      • attribute.first_name
      • attribute.last_name
      • attribute.user_email
      • google.groups
      • google.display_name
    2. Opcional: se você selecionou o Microsoft Entra ID como IdP, faça o seguinte para aumentar o número de grupos:

      1. Selecione Usar atributos extras.
      2. No campo URI do emissor de atributos extras, insira o URL do emissor.
      3. No campo ID do cliente de atributos extras, insira o ID do cliente.
      4. No campo Chave secreta do cliente para atributos extras, insira a chave secreta do cliente.
      5. Na lista Tipo de atributos extras, selecione um tipo de atributo para atributos extras.
      6. No campo Filtro de atributos extras, insira uma expressão de filtro usada ao consultar a API Microsoft Graph para grupos.
    3. Opcional: para adicionar uma condição de atributo, clique em Adicionar condição e insira uma expressão CEL que represente uma condição de atributo. Por exemplo, para limitar o atributo ipaddr a um determinado intervalo de IP, defina a condição assertion.attributes.ipaddr.startsWith('98.11.12.'). Este exemplo de condição garante que apenas os usuários com um endereço IP que comece com 98.11.12. possam fazer login usando esse provedor de força de trabalho.

    4. Para ativar o registro de auditoria detalhado, em Registro detalhado, clique no botão Ativar registro de auditoria do valor do atributo.

  10. Para criar o provedor, clique em Enviar.

gcloud

Para configurar o provedor de pool de identidade de colaboradores:

  1. Faça upload do arquivo de metadados do aplicativo SAML para o diretório inicial do Cloud Shell clicando em Mais >. Os arquivos só podem ser enviados para o diretório inicial. Para mais opções de transferência de arquivos entre o Cloud Shell e sua estação de trabalho local, consulte Fazer upload e download de arquivos e pastas do Cloud Shell.

  2. Anote o caminho do diretório em que você fez upload do arquivo XML de metadados do aplicativo SAML no Cloud Shell. Você vai precisar desse caminho na próxima etapa.

  3. Crie um provedor de pool de identidade de colaboradores e especifique os detalhes do IdP.

    Use o seguinte comando gcloud como exemplo:

    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"
    

    Consulte Planejar a implementação para ver as descrições dos valores.

    Substitua:

    • WORKFORCE_PROVIDER_ID: o valor definido para o ID do provedor de colaboradores.
    • WORKFORCE_POOL_ID: o valor definido para o ID do pool de identidade de colaboradores.
    • WORKFORCE_PROVIDER_DISPLAY_NAME: um nome opcional e fácil de usar para o provedor de força de trabalho. Ele precisa ter menos de 32 caracteres.
    • WORKFORCE_PROVIDER_DESCRIPTION: uma descrição opcional do provedor de colaboradores.
    • PATH_TO_METADATA_XML: o local do diretório do Cloud Shell do arquivo XML de metadados do aplicativo que você enviou usando o Cloud Shell, por exemplo: /path/to/sso_metadata.xml.
    • ATTRIBUTE_MAPPINGS: definição de como mapear atributos de declaração para atributos doGoogle Cloud . A Common Expression Language é usada para interpretar esse mapeamento. Exemplo:
    google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.groups
    

    O exemplo anterior mapeia os seguintes atributos:

    • assertion.subject para google.subject. Esse é um requisito mínimo.
    • assertion.attributes.name[0] para google.display_name.
    • assertion.attributes.groups ao atributo google.groups.

    Se você estiver realizando essa configuração para o Google Security Operations, que inclui o Google Security Operations SIEM e o Google SecOps SOAR, mapeie os seguintes atributos exigidos pelo Google SecOps SOAR:

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

    Portanto, o mapeamento completo é o seguinte:

    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]
    

    Para mais informações, consulte Provisionar e mapear usuários para o Google SecOps SOAR.

    Ao configurar o aplicativo SAML para transmitir informações de associação a grupos, os nomes de atributos de grupo comuns incluem groups, idpGroup e memberOf. No mapeamento de atributos da federação de identidade de colaboradores, verifique se o nome do atributo em assertion.attributes.ATTRIBUTE_NAME corresponde ao nome exato, que diferencia maiúsculas de minúsculas, configurado no IdP.

    O exemplo a seguir mapeia vários grupos para o atributo 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 : [])"
    

    O exemplo a seguir mapeia o grupo http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group que contém caracteres especiais para google.groups:

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

    Para mais informações sobre o mapeamento de atributos, consulte Mapeamentos de atributos.

Criar um provedor de pool de identidades de colaboradores do OIDC

Para criar um provedor de pool de identidades de colaboradores do OIDC usando o console doGoogle Cloud ou a CLI gcloud, siga estas etapas:

  1. Siga as instruções em Criar um provedor de pool de colaboradores do OIDC para criar o provedor no pool de identidades de colaboradores.

  2. Ao configurar o provedor de OIDC, aplique as seguintes configurações do Google SecOps:

    • URIs de redirecionamento: verifique se o aplicativo IdP do OIDC inclui os dois URIs de redirecionamento a seguir, conforme descrito em Configurar um aplicativo OIDC no IdP:

      • URI de redirecionamento de login do Google SecOps (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
      • URI de redirecionamento de validação da federação de identidade de colaboradores (https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
    • Mapeamentos de atributos: mapeie suas declarações do OIDC para atributos doGoogle Cloud usando a Common Expression Language (CEL). No mínimo, mapeie google.subject para assertion.sub e google.groups para assertion.groups para que o RBAC do Google SecOps funcione como esperado:

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

      Se você estiver configurando o Google Security Operations, que inclui o Google Security Operations SIEM e o Google SecOps SOAR, mapeie também os atributos exigidos pelo Google SecOps SOAR. Exemplo:

      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
      

      Exemplos de mapeamento de grupo avançado

      Ao configurar o aplicativo OIDC para transmitir informações de associação a grupos, os nomes comuns de declarações de grupo incluem groups, idpGroup e memberOf. No mapeamento de atributos da federação de identidade de colaboradores, verifique se o nome da declaração em assertion.CLAIM_NAME corresponde exatamente ao nome configurado no IdP, diferenciando maiúsculas de minúsculas.

      O exemplo a seguir mapeia vários grupos para o atributo google.groups:

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

      O exemplo a seguir mapeia uma declaração de grupo que contém caracteres especiais (como um esquema de URI) para google.groups:

      google.groups="assertion['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
      
  3. Opcional: crie uma condição de atributo. Se o IdP multilocatário tiver um único URI de emissor, use condições de atributo para garantir que o acesso seja restrito ao locatário correto. Por exemplo, é possível limitar o login a usuários com uma função ou um domínio de e-mail específico. Para mais informações, consulte Usar condições de atributos ao federar com provedores de identidade multilocatários.

  4. Depois de criar o provedor de força de trabalho do OIDC, recomendamos validar o token e os mapeamentos de atributos usando Depurar o token do IdP e, em seguida, continuar com Conceder um papel para permitir o login no Google SecOps para concluir as seções restantes deste documento.

Conceder um papel para permitir o login no Google SecOps

As etapas a seguir descrevem como conceder um papel específico usando o IAM para que os grupos e usuários no pool de identidade de colaboradores possam fazer login no Google SecOps. Faça a configuração usando o projeto do Google SecOps vinculado a Google Cloud que você criou anteriormente.

Console

  1. No console do Google Cloud , acesse a página IAM.

    Acessar o IAM

  2. Selecione o projeto do Google SecOps Google Cloud .

  3. Na guia Visualizar por principais, clique em Conceder acesso.

  4. Na seção Adicionar principais, insira um identificador de principal no campo Novos principais.

    Exemplo:

    • Para adicionar todas as identidades gerenciadas usando o pool de identidades de colaboradores e o provedor de colaboradores que você criou anteriormente, insira o seguinte:

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

    • Para adicionar um grupo específico como principal, digite o seguinte:

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

    Substitua:

    • WORKFORCE_POOL_ID: o valor definido para o ID do pool de identidade de colaboradores.
    • GROUP_ID: um grupo na declaração google.groups mapeada. Esse grupo precisa ser criado no IdP.
  5. Na seção Atribuir papéis, selecione ou pesquise um papel aplicável da API Chronicle, como Leitor da API Chronicle (roles/chronicle.viewer).

  6. Clique em Salvar.

  7. Repita as etapas de 3 a 5 para cada principal a que você quer conceder papéis.

gcloud

  1. Conceda o papel Leitor da API Chronicle (roles/chronicle.viewer) aos usuários ou grupos que precisam ter acesso ao aplicativo do Google SecOps.

    • O exemplo a seguir concede o papel de Leitor da API Chronicle a identidades gerenciadas usando o pool de identidades de colaboradores e o provedor de colaboradores que você criou anteriormente.
    gcloud projects add-iam-policy-binding PROJECT_ID \
      --role roles/chronicle.viewer \
      --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*"
    

    Substitua:

    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"
    

    Substitua GROUP_ID: um grupo na declaração google.groups mapeada. Esse grupo precisa ser criado no IdP.

  2. Configure outras políticas do IAM para atender aos requisitos da sua organização.

  3. Obrigatório: para concluir a autenticação e permitir o acesso do usuário à plataforma do Google SecOps, é necessário configurar o acesso do usuário no lado do SOAR do Google SecOps. Para mais informações, consulte Mapear usuários na plataforma do Google SecOps.

Repita as etapas anteriores para conceder outros papéis.

Configurar o SSO para sua instância do Google SecOps

A tarefa final de integração do IdP de terceiros com o Google SecOps é configurar o SSO. Depois de concluir essa etapa, os usuários poderão fazer login no Google SecOps usando as credenciais do IdP.

Siga estas etapas para configurar o SSO:

  1. No console do Google Cloud , acesse a página Segurança > Google SecOps.
  2. Clique na guia Logon único e selecione Federação de identidade de colaboradores.
  3. Na lista de provedores disponíveis, selecione o provedor de federação de identidade de colaboradores que você criou em Criar um provedor de pool de identidade de colaboradores.
  4. Opcional: para testar sua configuração de SSO, clique em Testar configuração de SSO. Se a configuração for bem-sucedida, você será redirecionado para a tela de login do IdP.
  5. Clique em Salvar.

Gerenciar a configuração da federação de identidade de colaboradores

Nesta seção, explicamos como atualizar as configurações do provedor e verificar se os níveis de acesso do usuário estão configurados corretamente.

Verificar ou configurar o controle de acesso aos recursos do Google SecOps

Se você configurou a federação de identidade de colaboradores com atributos ou grupos mapeados para o atributo google.groups, essas informações são transmitidas ao Google SecOps para que você possa configurar o RBAC para os recursos do Google SecOps.

Se a instância do Google SecOps tiver uma configuração de RBAC, verifique se ela funciona conforme o esperado.

Se você ainda não configurou o controle de acesso, consulte Configurar o controle de acesso a recursos usando o IAM para saber como controlar o acesso a recursos.

Modificar a configuração da federação de identidade de colaboradores

Se você precisar atualizar o pool de identidade de colaboradores ou o provedor de colaboradores, consulte Gerenciar provedores de pool de identidade de colaboradores para saber como atualizar a configuração.

A seção Gerenciamento de chaves em Criar um provedor de pool de colaboradores SAML descreve como atualizar as chaves de assinatura do IdP e, em seguida, atualizar a configuração do provedor de colaboradores com o arquivo XML de metadados do aplicativo mais recente. Para provedores OIDC, consulte Atualizar um provedor e Gerenciar JWKs OIDC.

Console

Para atualizar um pool de força de trabalho específico:

  1. Acesse a página Pools de identidade da força de trabalho:

    Acessar pools de identidade de colaboradores

  2. Na tabela, selecione o pool.

  3. Atualize os parâmetros do pool.

  4. Clique em Salvar pool.

Para atualizar um provedor:

  1. Acesse a página Pools de identidade da força de trabalho:

    Acessar pools de identidade de colaboradores

  2. Na tabela, selecione o pool em que você quer atualizar o provedor.

  3. Na tabela Provedores, clique em Editar.

  4. Atualize os detalhes do provedor.

  5. Para salvar os detalhes atualizados do provedor, clique em Salvar.

gcloud

Veja a seguir um exemplo de comando gcloud que atualiza a configuração do provedor de força de trabalho:

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"

Substitua:

  • WORKFORCE_PROVIDER_ID: o valor definido para o ID do provedor de colaboradores.
  • WORKFORCE_POOL_ID: o valor definido para o ID do pool de identidade de colaboradores.
  • WORKFORCE_PROVIDER_DISPLAY_NAME: um nome fácil de usar para o provedor de colaboradores. O valor precisa ter menos de 32 caracteres.
  • WORKFORCE_PROVIDER_DESCRIPTION: a descrição do provedor de colaboradores.
  • PATH_TO_METADATA_XML: o local do arquivo XML de metadados do aplicativo atualizado, por exemplo: /path/to/sso_metadata_updated.xml.
  • ATTRIBUTE_MAPPINGS: os atributos de declaração mapeados para atributos doGoogle Cloud . Exemplo:

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

Resolver problemas de configuração

Se você encontrar erros durante esse processo, consulte Resolver problemas da federação de identidade de colaboradores para resolver problemas comuns. Se a organização usa firewalls ou proxies da Web, verifique se a lista de permissões da rede inclui os domínios de autenticação e federação de identidade de colaboradores necessários, como auth.backstory.chronicle.security, iam.googleapis.com, accounts.google.com e domínios regionais accounts.google.ccTLD. Para mais informações, consulte Acesso à rede e lista de permissões de domínio. A seção a seguir fornece informações sobre problemas comuns encontrados ao executar as etapas deste documento.

Se você ainda tiver problemas, entre em contato com seu representante do Google SecOps e forneça o arquivo de registros de rede do Chrome.

Comando não encontrado

  • Ao criar um provedor de pool de identidades de colaboradores e especificar os detalhes do IdP, você recebe o seguinte erro:

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

Verifique se PATH_TO_METADATA_XML é o local em que você fez upload do arquivo XML de metadados do aplicativo SAML para o diretório inicial do Cloud Shell.

O autor da chamada não tem permissão

  • Ao executar o comando gcloud projects add-iam-policy-binding para conceder papéis a usuários ou grupos, você recebe o seguinte erro:

    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
    

Verifique se você tem as permissões necessárias. Para mais informações, consulte Papéis necessários.

Falha na verificação: ID da sessão ausente na solicitação

  • Ao tentar autenticar, você recebe o seguinte erro no navegador:

    Verification failure: missing session ID in request
    

Verifique se os URLs de base do ACS e do ID da entidade estão corretos. Para mais informações, consulte Configurar o aplicativo IdP.

Depurar o token do IdP

Use o recurso Depurar token do IdP na federação de identidade de colaboradores para verificar se o provedor de identidade está transmitindo os atributos e as declarações corretos. Isso é altamente recomendado antes que os usuários tentem fazer login no Google SecOps, porque pode ajudar a evitar erros de login e de mapeamento de atributos.

Para depurar o token:

  1. No console do Google Cloud , acesse Federação de identidade de colaboradores.
  2. Selecione o pool e o provedor.
  3. Clique em Depurar token do IdP.

Para um tutorial detalhado sobre como usar esse recurso para validar sua configuração, consulte o guia de validação pré-migração.

Depurar JWT maior que 4 KB

Se você tiver problemas com o login do Google SecOps, verifique se os JSON Web Tokens (JWTs) não excedem o limite de 4 KB do Google SecOps. Se um usuário receber um erro informando "JWT de autenticação maior que 4 KB. Reduza os dados de associação ao grupo enviados pelo IdP para resolver esse erro.", siga estas etapas de solução de problemas:

  1. Depurar o token: é possível depurar o token na página de detalhes do provedor na federação de identidade de colaboradores. Para isso, acesse Federação de identidade de colaboradores > Pools de colaboradores > POOL_NAME > PROVIDER_NAME e clique em Depurar token do IdP. Para usar esse recurso, primeiro adicione o URL Google Cloud aos URLs de redirecionamento do seu provedor de identidade. Isso se aplica aos protocolos SAML e OIDC. Para mais informações, consulte Solução de problemas da federação de identidade de colaboradores.
  2. Filtrar declarações de grupos: se o provedor de identidade enviar muitos grupos não relacionados ao Google SecOps, filtre a declaração de grupos no nível do provedor. Configurar o provedor externo para enviar apenas o conjunto mínimo de grupos necessários para o Google SecOps reduz o tamanho do JWT e evita erros de autenticação.

    • Exemplo (Microsoft Entra ID): use a filtragem de grupos do Microsoft Entra para enviar apenas um conjunto mínimo de grupos relevantes. No aplicativo empresarial do Entra, em "Logon único", edite a declaração Grupos para aplicar um filtro (por exemplo, usando uma correspondência de prefixo) para que apenas os grupos necessários sejam enviados ao Google SecOps. Para mais informações, consulte Filtragem de grupos do Microsoft Entra.

A seguir

Depois de concluir as etapas deste documento, faça o seguinte:

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.