> ## 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 OneLogin

> Conecte o OneLogin ao Living Security para obter dados de ciclo de vida de usuários, autenticação, MFA e atividade administrativa.

export const EgressIpAllowlistBothSets = ({system}) => <Warning>
    <strong>{system} precisa de dois conjuntos de endereços, não de um.</strong> A Living Security gera o token de acesso desta
    integração em sua própria infraestrutura e o atualiza continuamente; por isso, o tráfego de configuração e o tráfego de
    sincronização saem de redes diferentes. Inclua ambos os conjuntos na lista de permissões em {system} e
    mantenha os dois configurados — isso não é um requisito apenas para a configuração.
    <br />
    <br />
    <strong>Tráfego de sincronização da integração</strong> — o mesmo em todas as regiões:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    <strong>Tráfego da plataforma</strong> — use somente a linha da região que hospeda a sua
    organização:
    <br />
    Estados Unidos: <code>98.91.60.249/32</code>, <code>13.216.91.102/32</code>
    <br />
    União Europeia: <code>34.246.236.210/32</code>, <code>52.31.102.238/32</code>
    <br />
    <br />
    Se você incluir apenas o conjunto de sincronização na lista de permissões, a configuração nunca será concluída. Se incluir apenas o conjunto da plataforma, a
    configuração será bem-sucedida, mas todas as sincronizações falharão. Consulte{' '}
    <a href="/pt-BR/integrations/managing/egress-ip-addresses">
      Configuração dos endereços IP de saída das Integrações
    </a>{' '}
    para conhecer as duas assinaturas de falha e a política de alterações.
  </Warning>;

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="OneLogin" recommendDelegated={true} />

## O que esta integração fornece

O OneLogin pode fornecer dados normalizados de ciclo de vida de usuários, autenticação, MFA e atividade administrativa. Entre os exemplos analisados, estão:

* `mfa.success` — conclui desafios de MFA
* `mfa.failed` — falha em desafios de MFA
* `account.locked` — conta bloqueada

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

## O que o Living Security precisa

| Credencial | Descrição |
| - | - |
| **ID do cliente** | O ID do cliente de um par de credenciais de API do OneLogin com permissão para ler usuários e eventos. |
| **Segredo do cliente** | O segredo do cliente desse par de credenciais. |
| **Subdomínio do tenant** | O valor que precede `.onelogin.com` na URL do seu tenant do OneLogin. |

## Configuração

<Steps>
  <Step title="Crie credenciais de API no OneLogin">
    Como proprietário da conta ou administrador, abra **Developers → API Credentials**, crie uma credencial dedicada e selecione um escopo que permita ler usuários e eventos. Armazene o ID do cliente e o segredo com segurança.
  </Step>

  <ConnectInPlatform tile="OneLogin">
    Informe o subdomínio do tenant, o ID do cliente e o segredo do cliente e, em seguida, conecte.
  </ConnectInPlatform>
</Steps>

O Living Security troca o par de credenciais por um token de acesso e o renova
antes que expire, portanto não há nenhum token para você gerar ou rotacionar. Rotacione o
próprio par de credenciais conforme a sua programação habitual e reconecte o bloco depois.

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

Verifique se a conexão consegue ler pelo menos um usuário. Os eventos de auditoria podem estar vazios quando o tenant não tem atividade recente.

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    O ID do cliente ou o segredo do cliente está incorreto, ou o par de credenciais foi excluído no OneLogin. Confirme se o par ainda existe em **Developers → API Credentials** e reconecte com os valores atuais.
  </Accordion>

  <Accordion title="403 Forbidden">
    Recrie a credencial de API com permissão para ler as APIs de recursos, os usuários e os eventos do OneLogin.
  </Accordion>

  <Accordion title="Não é possível acessar o tenant">
    Informe apenas o subdomínio do tenant, não uma URL completa nem o nome de exibição administrativo.

    Se o subdomínio estiver correto e ainda não for possível acessar o tenant, verifique se o OneLogin restringe o acesso à API por endereço IP de origem em sua conta. Esta integração exige que **dois** conjuntos de endereços estejam na lista de permissões, pois o Living Security gera o token de acesso por conta própria e o renova continuamente — portanto, as solicitações de token e as sincronizações agendadas partem de redes diferentes.

    <EgressIpAllowlistBothSets system="OneLogin" />
  </Accordion>
</AccordionGroup>

Para obter detalhes do lado do fornecedor, consulte [o guia de credenciais de API do OneLogin](https://developers.onelogin.com/api-docs/2/getting-started/working-with-api-credentials).

<PublicIntegrationNextSteps />


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