> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração da integração com o Google Workspace

> Conecte o Google Workspace à Living Security para acompanhar atividades de ciclo de vida de usuários, login, MFA, administração e proteção de dados.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Recursos relacionados</h2>
    <ul>
      <li>
        <a href="/pt-BR/signals/data-sources">Saiba como os dados de integração se transformam em Sinais de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Conheça as Integrações da Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Abra a Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Solicite uma demonstração da Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Insira as credenciais na Living Security Platform">
    <p>
      Esta etapa deve ser concluída por quem possui acesso à Living Security — o proprietário do programa ou o
      administrador do sistema, caso tenha sido convidado (configuração delegada).
    </p>
    <ol>
      <li>
        Acesse <strong>Configurações → Integrações → Catálogo</strong>, localize o card{' '}
        <strong>{tile}</strong> e clique em <strong>Conectar</strong>.
      </li>
      <li>
        Preencha os campos abaixo e, em seguida, clique em <strong>Conectar</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Este guia é destinado ao administrador do {system} da sua organização.</strong> Ele aborda a criação de
      credenciais de API dentro do {system}, o que exige acesso de administrador ao {system}, e não à
      Living Security Platform.
    </p>
    <p>
      Se você é o <strong>responsável pelo programa</strong> da Living Security e não administra o {system},
      envie esta página a quem o administra. Essa pessoa conclui a Parte A e devolve as credenciais a você
      (ou as insere diretamente, caso você a tenha convidado para a plataforma).
      {recommendDelegated && <>
          {' '}Como a configuração gera material de chave confidencial, recomendamos o caminho de{' '}
          <strong>configuração delegada</strong>, para que o segredo nunca seja enviado de volta a você.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Google Workspace" recommendDelegated={true} />

## O que esta integração fornece

O Google Workspace pode fornecer atividades normalizadas de ciclo de vida de usuários, login, MFA, administração e proteção de dados. Entre os exemplos analisados, estão:

* `account.compromised` — conta sinalizada como comprometida
* `data.sensitive.downloaded` — faz download de dados confidenciais
* `auth.login.unusual` — faz login em contextos incomuns

Consulte [como os dados de integração se tornam Sinais](/pt-BR/signals/data-sources).

## O que a Living Security precisa

| Credencial | Descrição |
| - | - |
| **Chave da conta de serviço** | Uma chave JSON de uma conta de serviço dedicada do Google Cloud. |
| **Administrador delegado** | O e-mail de um administrador do Google Workspace que a conta de serviço pode representar. |

Ative as APIs do Admin SDK e autorize somente os escopos que a conexão lê:

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## Configuração

<Steps>
  <Step title="Crie uma conta de serviço do Google Cloud">
    Crie uma conta de serviço dedicada, ative a delegação em todo o domínio e baixe a respectiva chave JSON. Armazene a chave com segurança.
  </Step>

  <Step title="Autorize a delegação em todo o domínio">
    No Google Admin Console, abra **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Adicione o ID de cliente numérico da conta de serviço e os três escopos somente leitura indicados acima.
  </Step>

  <Step title="Escolha o administrador delegado">
    Selecione um administrador ativo do Workspace que possa ler o diretório, as atribuições de função e os relatórios de auditoria. A Living Security usa essa identidade somente para leituras delegadas de API.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Faça upload ou cole a credencial da conta de serviço conforme solicitado e informe o e-mail do administrador delegado.
  </ConnectInPlatform>
</Steps>

## Verificação e solução de problemas

Verifique se a conexão consegue ler um usuário do diretório e a atividade de login recente. O Google informa que novas concessões de delegação em todo o domínio podem levar algum tempo para se propagar.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Confirme que a delegação em todo o domínio usa o ID de cliente numérico da conta de serviço, e não o endereço de e-mail dela, e que os três escopos correspondem exatamente.
  </Accordion>

  <Accordion title="O diretório funciona, mas as atribuições de função estão ausentes">
    Adicione `admin.directory.rolemanagement.readonly` à entrada de delegação e confirme que o administrador delegado pode visualizar as atribuições de função.
  </Accordion>

  <Accordion title="Os relatórios estão vazios">
    Confirme que a Admin Reports API está ativada e que o administrador delegado pode acessar os relatórios de auditoria do tenant do Workspace.
  </Accordion>
</AccordionGroup>

Para obter detalhes do lado do fornecedor, consulte [o guia de delegação em todo o domínio do Google](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority).

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.