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

> Conecte o CultureAI à Living Security Platform para importar dados de comportamento de segurança e de relatórios.

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="CultureAI" />

## O que esta integração contribui

O CultureAI pode contribuir com atividades de phishing, Treinamento, reporte por parte dos colaboradores e proteção de dados. Exemplos analisados incluem:

* `phishing.real.clicked` — clica em links em e-mails de phishing reais
* `data.transfer.blocked` — transferência de dados bloqueada
* `phishing.safe.reported` — reporta e-mails posteriormente considerados seguros

Esses exemplos mostram os tipos de atividade normalizada que a Living Security pode utilizar. 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 de API** | Uma chave gerada no console de administração do CultureAI. A Living Security envia essa chave em todas as requisições para se autenticar na API do CultureAI. É a única credencial necessária. |

**Escopos:** as chaves de API do CultureAI não possuem escopo — uma chave válida concede acesso à API. A Living Security apenas lê dados de relatórios; se o console do CultureAI oferecer a seleção de escopo ou de permissão ao criar uma chave, conceda acesso somente leitura aos relatórios.

**Função necessária:** **Administrador** ou **Proprietário** no CultureAI (para gerenciar o acesso à API)

### Pré-requisitos

* Você deve estar conectado ao console de administração do CultureAI com uma função que possa gerenciar o acesso à API — normalmente a função de **Administrador** ou **Proprietário**. Se você não encontrar uma área de API ou de configurações para desenvolvedores, entre em contato com o representante da sua conta CultureAI para solicitar a ativação do acesso à API para a sua organização.

***

## Parte A — No CultureAI

*O administrador do CultureAI da sua organização conclui estas etapas.*

<Steps>
  <Step title="Gerar uma chave de API">
    1. Faça login no console de administração do CultureAI.
    2. Abra as configurações da sua organização ou conta e localize a área **API** (ou **Chaves de API** / **Desenvolvedor**).
    3. Crie uma nova chave de API e atribua a ela um nome descritivo (por exemplo, `Living Security Platform`).

    <Note>
      A Living Security utiliza essa chave para acesso somente leitura aos dados de relatórios que importa do CultureAI. Não é necessário acesso de gravação. Se o CultureAI solicitar a escolha de escopos ou permissões, conceda apenas acesso de leitura aos dados de relatórios.
    </Note>

    <Warning>
      O CultureAI pode exibir o valor da chave de API **apenas uma vez**, no momento da criação. Copie-o imediatamente e armazene-o em um local seguro (por exemplo, um cofre de senhas ou um gerenciador de segredos). Se você sair da página sem copiá-lo, será necessário gerar uma nova chave.
    </Warning>

    <Note>
      Se você não encontrar onde criar uma chave de API ou tiver dúvidas sobre quais permissões conceder, entre em contato com o representante da sua conta CultureAI. A Living Security não pode gerar credenciais do CultureAI em seu nome.
    </Note>
  </Step>
</Steps>

***

## Parte B — Na Living Security Platform

*O responsável pelo programa conclui esta etapa, ou o administrador do sistema, caso a configuração delegada seja utilizada.*

<Steps>
  <ConnectInPlatform tile="CultureAI">
    | Campo | Valor |
    | - | - |
    | **Chave de API** | A chave de API obtida na Parte A |
  </ConnectInPlatform>
</Steps>

Agora você está conectado ao CultureAI.

***

## Solução de problemas

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    A chave de API é inválida ou foi revogada. Verifique se a chave está correta e se não foi regenerada no CultureAI.
  </Accordion>

  <Accordion title="403 Forbidden">
    A chave de API não possui acesso de leitura aos dados de relatórios. No CultureAI, verifique se a chave tem acesso de leitura concedido ou gere uma nova chave com as permissões corretas.
  </Accordion>

  <Accordion title="Resultados vazios (200 OK, mas sem dados)">
    É possível que a chave de API não tenha acesso aos dados de relatórios que a Living Security importa. Confirme com o representante da sua conta CultureAI que a chave possui acesso de leitura aos dados de relatórios.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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