> ## 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/signals/data-sources">Saiba como os dados de integração se transformam em Sinais de Gerenciamento de Risco Humano</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Explore 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>
      Realizado por quem possui acesso à Living Security — o responsável pelo 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 cartão{' '}
        <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 destina-se ao administrador de {system}.</strong> Abrange a criação de
      credenciais de API no {system}, o que requer acesso de administrador ao {system} — e não à
      Living Security Platform.
    </p>
    <p>
      Se for o <strong>responsável pelo programa</strong> da Living Security e não administrar o {system},
      envie esta página a quem o faça. Essa pessoa conclui a Parte A e devolve-lhe as credenciais
      (ou introduz-las diretamente, caso tenha sido convidada para a plataforma).
      {recommendDelegated && <>
          {' '}Como a configuração gera material de chaves confidencial, recomendamos o percurso de{' '}
          <strong>configuração delegada</strong>, para que o segredo nunca lhe seja enviado.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="CultureAI" />

## O que esta integração fornece

O CultureAI pode fornecer atividades de phishing, treinamento, relatos de colaboradores e proteção de dados. Os 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` — relata 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/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 cada solicitação 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 seu console do CultureAI oferecer a seleção de escopo ou de permissões 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 do 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 **somente 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 não tiver certeza de quais permissões conceder, entre em contato com o representante da sua conta do CultureAI. A Living Security não pode gerar credenciais do CultureAI em seu nome.
    </Note>
  </Step>
</Steps>

***

## Parte B — Na Living Security Platform

*O proprietário do 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 gerada novamente no CultureAI.
  </Accordion>

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

  <Accordion title="Resultados vazios (200 OK, mas sem dados)">
    A chave de API pode não ter acesso aos dados de relatórios que a Living Security importa. Confirme com o representante da sua conta do 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.