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

# Chaves de integração: como criar, revogar e proteger

> Crie e gerencie as chaves que identificam sua conta da Autorizou nos sistemas externos, e saiba como protegê-las contra uso indevido.

<Note>
  **Disponível para: Empresa.** Somente contas do tipo Empresa têm acesso às chaves de integração.
</Note>

Uma chave de integração é um código único que identifica sua conta da Autorizou para sistemas externos, como o seu site, loja virtual ou sistema de gestão. Quando você configura uma integração, é essa chave que autoriza a comunicação entre o sistema externo e a Autorizou.

Com as chaves de integração você consegue:

* Criar chaves identificadas por nome para cada sistema que você conecta
* Revogar uma chave imediatamente se ela for comprometida
* Ter múltiplas chaves ativas ao mesmo tempo para integrações diferentes

## Como criar uma chave de integração

<Steps>
  <Step title="Acesse a seção de integrações">
    No menu lateral, vá em **Integrações → Chaves**.
  </Step>

  <Step title="Inicie a criação">
    Clique em **Nova chave**.
  </Step>

  <Step title="Dê um nome descritivo">
    Escolha um nome que identifique para qual sistema essa chave será usada, por exemplo: `Site principal` ou `Sistema de gestão`. Isso facilita o gerenciamento quando você tiver várias chaves.
  </Step>

  <Step title="Confirme a criação">
    Clique em **Criar chave**.
  </Step>

  <Step title="Copie e guarde o valor da chave">
    O valor completo da chave será exibido **uma única vez**. Copie e guarde em local seguro antes de fechar essa tela.
  </Step>
</Steps>

<Warning>
  **O valor da chave aparece somente no momento da criação.** Após fechar a tela, não é possível visualizá-lo novamente. Se você perder a chave, precisará revogá-la e criar uma nova.
</Warning>

## Como revogar uma chave

Revogue uma chave sempre que ela for comprometida, vazar acidentalmente ou quando uma integração for desativada.

<Steps>
  <Step title="Acesse a lista de chaves">
    Vá em **Integrações → Chaves**.
  </Step>

  <Step title="Localize a chave">
    Identifique a chave pelo nome que você deu na criação.
  </Step>

  <Step title="Revogue a chave">
    Clique em **Revogar** ao lado da chave e confirme a ação.
  </Step>
</Steps>

<Warning>
  A revogação é imediata e irreversível. Qualquer sistema usando essa chave perderá o acesso na hora. Certifique-se de ter uma nova chave configurada antes de revogar a antiga, se a integração precisar continuar funcionando.
</Warning>

## Documentação técnica

Este guia cobre o gerenciamento das chaves pelo painel. Para detalhes técnicos de como usar a chave nas chamadas de integração, como cabeçalhos, autenticação e exemplos de requisição, consulte a **documentação para desenvolvedores** disponível no portal técnico da Autorizou.

<Tip>
  Nunca exponha sua chave de integração em código público, repositórios abertos ou mensagens. Use variáveis de ambiente para armazená-la com segurança.
</Tip>

## Boas práticas

* **Uma chave por sistema:** crie chaves separadas para cada integração. Assim, se uma for comprometida, você revoga apenas ela sem afetar as outras.
* **Nomes descritivos:** use nomes que identifiquem claramente o uso, facilitando auditorias futuras.
* **Revogação imediata:** ao suspeitar de vazamento, revogue a chave e crie uma nova sem esperar.
* **Armazenamento seguro:** guarde o valor da chave em um gerenciador de senhas ou cofre de segredos.

## Dúvidas comuns

<AccordionGroup>
  <Accordion title="Perdi o valor da minha chave. Consigo recuperá-lo?">
    Não. O valor da chave só é exibido no momento da criação. Se você perder, revogue a chave atual e crie uma nova para substituí-la.
  </Accordion>

  <Accordion title="Quantas chaves posso ter ao mesmo tempo?">
    Você pode ter múltiplas chaves ativas simultaneamente. Não há um limite fixo padrão, mas recomendamos manter apenas as chaves que estão em uso ativo.
  </Accordion>

  <Accordion title="Revogar uma chave afeta outras integrações?">
    Não. Cada chave é independente. A revogação de uma chave afeta somente os sistemas que usam aquela chave específica.
  </Accordion>

  <Accordion title="Minha chave pode expirar automaticamente?">
    No momento, as chaves não expiram automaticamente. Elas permanecem ativas até você revogar manualmente.
  </Accordion>

  <Accordion title="Como sei se alguém está usando minha chave de forma indevida?">
    Fique atento a transações ou eventos inesperados no painel. Se suspeitar de uso indevido, revogue a chave imediatamente e crie uma nova.
  </Accordion>
</AccordionGroup>

## Veja também

<CardGroup cols={2}>
  <Card title="Webhooks" icon="webhook" href="/integracoes/webhooks">
    Configure notificações automáticas para a sua URL quando eventos ocorrerem na Autorizou.
  </Card>

  <Card title="Colaboradores" icon="users" href="/equipe/colaboradores">
    Controle quem da sua equipe pode acessar e gerenciar as integrações.
  </Card>
</CardGroup>