Configurar identidade de terceiros
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:
- 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.
- 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.
- 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.
- 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 e o IdP
De modo geral, a comunicação é a seguinte:
- O usuário acessa o Google SecOps.
- O Google SecOps procura informações do IdP no Google Cloud pool de identidade de colaboradores.
- Uma solicitação é enviada ao IdP.
- A declaração SAML ou o token de ID do OIDC é enviado ao pool de identidades de colaboradores do Google Cloud .
- 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
- Conheça o Cloud Shell,
o comando
gcloude o console do Google Cloud . - Configure um projeto do Google Cloud para o Google SecOps para configurar um projeto que se vincule ao Google SecOps.
- Revise a Google Cloud federação de identidade de colaboradores.
- Verifique se você tem as permissões para executar as etapas deste documento. Para informações sobre as permissões necessárias para cada fase do processo de integração, consulte Papéis necessários.
- Verifique se a lista de permissões do firewall ou do proxy inclui os domínios necessários do Google SecOps, da federação de identidade de colaboradores e do IdP de terceiros na porta TCP
443. Para mais informações, consulte Acesso à rede e lista de permissões de domínio.
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
- 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
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 Crie um novo aplicativo SAML no IdP.
Configure o aplicativo com o seguinte:
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_IDSubstitua:
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.
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_IDConfigure o identificador de nome no IdP para garantir que o campo
NameIDseja 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.
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) subjectuser.emailuser.mailouuser.userprincipalnameemailaddressuser.emailuser.mailfirst_nameuser.firstNameuser.givennamelast_nameuser.lastNameuser.surnamedisplay_nameuser.displayNameuser.displaynamegroupsConfigurado 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.
Atribua os grupos e usuários adequados ao aplicativo no IdP.
Esses grupos e usuários serão autorizados a acessar o Google SecOps.
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:
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.
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.
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_IDPara 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.
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.
Configure o aplicativo do IdP para retornar a declaração
sube 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) subuser.emailuser.mailouuser.userprincipalnameemailuser.emailuser.mailgiven_nameuser.firstNameuser.givennamefamily_nameuser.lastNameuser.surnamenameuser.displayNameuser.displaynamegroupsConfigurado 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,profileeemail) 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
groupscomo um escopo adicional ao criar o provedor de federação de identidade de colaboradores para que o Okta retorne a declaraçãogroups. Para mais informações, consulte Configurar a federação de identidade de colaboradores com o Okta.Atribua os grupos e usuários apropriados ao aplicativo OIDC no IdP.
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
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.
Inicie uma sessão do Cloud Shell.
Defina o Google Cloud projeto que é faturado e cobrado pela cota para operações realizadas usando a CLI gcloud. Use o seguinte comando
gcloudcomo exemplo:gcloud config set billing/quota_project PROJECT_IDSubstitua
PROJECT_IDpelo 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:
No console do Google Cloud , acesse a página Pools de identidade da força de trabalho:
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.
Clique em Criar pool e faça o seguinte:
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.
Opcional: em Descrição, insira uma descrição do pool.
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
Crie um pool de identidades de colaboradores.
Use o seguinte comando
gcloudcomo 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_DURATIONSubstitua:
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 coms, 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.securitye--disable-programmatic-signinao 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-signinEsse 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.
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
- Criar um provedor de pool de identidades de colaboradores OIDC
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:
No console do Google Cloud , acesse a página Pools de identidade de colaboradores:
Na tabela Pools de identidade de colaboradores, selecione o pool em que você quer criar o provedor.
Na seção Provedores, clique em Adicionar provedor.
Em Selecionar um fornecedor do provedor, escolha seu IdP.
Se o IdP não estiver listado, selecione Provedor de identidade genérico.
Em Selecionar um protocolo de autenticação, escolha SAML.
Na seção Criar um provedor, faça o seguinte:
Em Nome, digite um nome para o provedor.
Opcional: em Descrição, digite uma descrição para o provedor.
Em Arquivo de metadados do IdP (XML), selecione o arquivo XML de metadados gerado anteriormente neste guia.
Verifique se a opção Ativar provedor está ativada.
Clique em Continuar.
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.
- Configure o primeiro URL (
Clique em Continuar.
Na seção Configurar provedor, faça o seguinte:
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.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]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_nameattribute.last_nameattribute.user_emailgoogle.groupsgoogle.display_name
Opcional: se você selecionou o Microsoft Entra ID como IdP, faça o seguinte para aumentar o número de grupos:
- Selecione Usar atributos extras.
- No campo URI do emissor de atributos extras, insira o URL do emissor.
- No campo ID do cliente de atributos extras, insira o ID do cliente.
- No campo Chave secreta do cliente para atributos extras, insira a chave secreta do cliente.
- Na lista Tipo de atributos extras, selecione um tipo de atributo para atributos extras.
- No campo Filtro de atributos extras, insira uma expressão de filtro usada ao consultar a API Microsoft Graph para grupos.
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
ipaddra um determinado intervalo de IP, defina a condiçãoassertion.attributes.ipaddr.startsWith('98.11.12.'). Este exemplo de condição garante que apenas os usuários com um endereço IP que comece com98.11.12.possam fazer login usando esse provedor de força de trabalho.Para ativar o registro de auditoria detalhado, em Registro detalhado, clique no botão Ativar registro de auditoria do valor do atributo.
Para criar o provedor, clique em Enviar.
gcloud
Para configurar o provedor de pool de identidade de colaboradores:
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.
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.
Crie um provedor de pool de identidade de colaboradores e especifique os detalhes do IdP.
Use o seguinte comando
gcloudcomo 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.groupsO exemplo anterior mapeia os seguintes atributos:
assertion.subjectparagoogle.subject. Esse é um requisito mínimo.assertion.attributes.name[0]paragoogle.display_name.assertion.attributes.groupsao atributogoogle.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_nameattribute.last_nameattribute.user_emailgoogle.groupsgoogle.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,idpGroupememberOf. No mapeamento de atributos da federação de identidade de colaboradores, verifique se o nome do atributo emassertion.attributes.ATTRIBUTE_NAMEcorresponde 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/groupque contém caracteres especiais paragoogle.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:
Siga as instruções em Criar um provedor de pool de colaboradores do OIDC para criar o provedor no pool de identidades de colaboradores.
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)
- URI de redirecionamento de login do Google SecOps
(
Mapeamentos de atributos: mapeie suas declarações do OIDC para atributos doGoogle Cloud usando a Common Expression Language (CEL). No mínimo, mapeie
google.subjectparaassertion.subegoogle.groupsparaassertion.groupspara que o RBAC do Google SecOps funcione como esperado:google.subject=assertion.sub,google.groups=assertion.groupsSe 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.nameExemplos 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,idpGroupememberOf. No mapeamento de atributos da federação de identidade de colaboradores, verifique se o nome da declaração emassertion.CLAIM_NAMEcorresponde 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']"
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.
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
No console do Google Cloud , acesse a página IAM.
Selecione o projeto do Google SecOps Google Cloud .
Na guia Visualizar por principais, clique em Conceder acesso.
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_IDPara 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çãogoogle.groupsmapeada. Esse grupo precisa ser criado no IdP.
Na seção Atribuir papéis, selecione ou pesquise um papel aplicável da API Chronicle, como Leitor da API Chronicle (
roles/chronicle.viewer).Clique em Salvar.
Repita as etapas de 3 a 5 para cada principal a que você quer conceder papéis.
gcloud
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:
PROJECT_ID: pelo ID do projeto vinculado ao Google SecOps que você configurou 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.WORKFORCE_POOL_ID: o valor definido para o ID do pool de identidade de colaboradores.Para conceder o papel de Leitor da API Chronicle a um grupo específico, execute o seguinte 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"Substitua
GROUP_ID: um grupo na declaraçãogoogle.groupsmapeada. Esse grupo precisa ser criado no IdP.Configure outras políticas do IAM para atender aos requisitos da sua organização.
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:
- No console do Google Cloud , acesse a página Segurança > Google SecOps.
- Clique na guia Logon único e selecione Federação de identidade de colaboradores.
- 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.
- 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.
- 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:
Acesse a página Pools de identidade da força de trabalho:
Na tabela, selecione o pool.
Atualize os parâmetros do pool.
Clique em Salvar pool.
Para atualizar um provedor:
Acesse a página Pools de identidade da força de trabalho:
Na tabela, selecione o pool em que você quer atualizar o provedor.
Na tabela Provedores, clique em Editar.
Atualize os detalhes do provedor.
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-bindingpara 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:
- No console do Google Cloud , acesse Federação de identidade de colaboradores.
- Selecione o pool e o provedor.
- 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:
- 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.
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:
Siga as etapas para vincular uma instância do Google SecOps aos serviços do Google Cloud .
Se você ainda não configurou a geração de registros de auditoria, ative esse recurso no Google SecOps.
Se você estiver configurando para o Google Security Operations, siga as etapas adicionais em Provisionar, autenticar e mapear usuários no Google Security Operations.
Para configurar o acesso aos recursos, siga as etapas em Configurar o controle de acesso aos recursos usando o IAM e Permissões do Google SecOps no IAM.
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.