# Tokens com Escopo: Melhores Práticas

impact.com permite que você crie *tokens com escopo*: credenciais de API com permissões granulares, que concedem acesso a endpoints específicos da API. Saiba mais sobre [manter seus tokens seguros](https://help.impact.com/other/pt-br/reference-documentation/api-access-tokens-and-changelog/keep-your-access-tokens-secure).

<div data-with-frame="true"><figure><img src="https://1897586174-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhRN1rcrim887TwHLBjac%2Fuploads%2Fgit-blob-fe3efc74bca33b0b652161e5998440268b8aa50d%2F5b0a9e9151e8fbc234e52fbb902b41b711de77f2760d139f813dfbfff1584b99.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### Benefícios dos tokens com escopo

<details>

<summary>Segurança mais robusta</summary>

Tokens com escopo permitem acesso apenas ao necessário, reduzindo o risco caso as credenciais sejam comprometidas.

</details>

<details>

<summary>Melhor controle de acesso</summary>

Defina permissões específicas para o que cada token pode fazer com APIs específicas.

</details>

<details>

<summary>Simplificar o gerenciamento</summary>

Racionalize a supervisão de tokens, especialmente ao trabalhar com várias equipes ou parceiros externos.

</details>

<details>

<summary>Monitoramento esclarecedor</summary>

Obtenha visibilidade sobre o uso dos tokens para entender melhor o tráfego da API e gerenciar limites de taxa de forma eficaz.

</details>

<details>

<summary>Melhor gerenciamento de tokens</summary>

Crie, gerencie e revogue tokens facilmente sem interromper outras integrações.

</details>

#### Melhores práticas para criar tokens com escopo

Siga estas melhores práticas para garantir segurança, clareza e gerenciamento eficaz ao criar tokens com escopo:

<details>

<summary>Escolha apenas as APIs e métodos que você precisa</summary>

Defina escopos selecionando apenas as APIs específicas e os métodos HTTP, como GET, POST, PUT, DELETE, que sua integração realmente necessita. Se sua integração só precisa recuperar dados, conceda acesso à API usando apenas o método GET.

</details>

<details>

<summary>Aplique o princípio do menor privilégio</summary>

Sempre comece com o nível mínimo de acesso necessário e adicione mais permissões somente se for absolutamente necessário. Evite habilitar os métodos POST, PUT ou DELETE, a menos que sua integração exija explicitamente.

</details>

<details>

<summary>Use nomes e explicações descritivas</summary>

Dê a cada token um nome claro e significativo, e inclua uma descrição detalhada. Isso ajuda sua equipe a gerenciar, entender e auditar o uso dos tokens de forma mais eficaz.

</details>

<details>

<summary>Atribua um contato técnico responsável</summary>

Certifique-se de que cada token tenha um contato técnico designado. Essa pessoa será responsável por receber atualizações importantes, alertas ou notificações relacionadas ao acesso à API e ao desempenho da integração.

</details>

<details>

<summary>Selecione a versão correta da API</summary>

Garanta que o token esteja alinhado com a versão da API que sua integração foi construída para usar. Isso ajuda a manter a compatibilidade e evita erros inesperados.

</details>

#### Monitore e gerencie tokens com escopo

<details>

<summary>Verifique o uso dos tokens regularmente</summary>

Crie o hábito de verificar como seus tokens estão sendo usados. Você pode fazer isso configurando um painel para rastrear a atividade dos tokens ou solicitando à impact.com detalhes de uso. Além disso, observe erros frequentes em sua integração.

</details>

<details>

<summary>Evite conceder acesso excessivo</summary>

Tokens que têm mais permissões do que precisam podem ser perigosos se forem expostos. Para evitar isso, compare o que um token está autorizado a fazer com o que ele realmente está fazendo. Se tiver acesso que não precisa, remova-o.

</details>

<details>

<summary>Roteie os tokens com frequência</summary>

Altere as credenciais dos tokens regularmente para ajudar a manter seu sistema seguro. Tente atualizar seus tokens a cada poucos meses—uma vez por trimestre é uma boa regra. Quando você criar um novo token, certifique-se de atualizar suas integrações para usar o novo.

</details>

<details>

<summary>Use nomes e descrições claras</summary>

Dê a cada token um nome e uma descrição que expliquem para que o token serve e quem o possui. Inclua detalhes como o aplicativo ou sistema que o utiliza, seu propósito e se é para teste ou uso em produção. Além disso, atribua uma pessoa da sua equipe como contato principal para cada token em caso de problemas.

</details>

<details>

<summary>Remova tokens que você não usa</summary>

Tokens antigos ou não utilizados podem criar riscos de segurança. Planeje limpezas regulares—uma vez por mês ou por trimestre—para revisar todos os tokens. Exclua ou desative quaisquer tokens que não sejam mais necessários.

</details>

#### Perguntas frequentes

<details>

<summary>As integrações existentes serão impactadas?</summary>

Não. Integrações existentes que usam tokens legados continuarão funcionando. No entanto, recomendamos migrar para tokens de acesso à API com escopo para melhorar a segurança e o gerenciamento.

</details>

<details>

<summary>O que são tokens legados?</summary>

*Tokens legados* são um tipo mais antigo de token de acesso que precedeu *tokens com escopo*. Tokens com escopo ficaram disponíveis no impact.com após maio de 2025.

</details>

<details>

<summary>Quantos tokens com escopo posso criar?</summary>

Cada conta pode ter até 20 tokens com escopo ativos. Tokens podem ser desativados ou excluídos conforme necessário.

</details>

<details>

<summary>O que acontece quando um token é desativado?</summary>

Tokens desativados terão o acesso negado, retornando uma resposta 403 "Acesso negado". Isso permite suspensão temporária sem excluir o token.

</details>

<details>

<summary>O que acontece se você usar um token inválido para acessar uma API?</summary>

Se você fizer uma solicitação a uma API sem um token de acesso com escopo válido, verá uma resposta 403 "Acesso negado".

</details>

<details>

<summary>É possível recuperar um token excluído?</summary>

Não, a funcionalidade de exclusão remove permanentemente o token de acesso e quaisquer permissões atribuídas. Se você excluiu o token por engano, poderá criar um novo token e selecionar os escopos. Integrações existentes precisarão ser atualizadas para usar as novas credenciais do token de acesso.

</details>
