{"section":"announcements","requestedLocale":"pt","requestedSlug":"2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade","locale":"pt","slug":"2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade","path":"docs/pt/announcements/2025/agosto/2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade.md","branch":"main","content":"Para otimizar a gestão das credenciais de acesso e aumentar a segurança, aprimoramos a experiência de **Chaves de API**. As novidades já estão disponíveis para todas as contas.\n\n![generated-keys-pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/announcements/2025/agosto/2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade_1.png)\n\n## O que mudou?\n\nReunimos as novidades em três grupos principais, que aprimoram a segurança, simplificam a gestão e facilitam a visibilidade das chaves de API.\n\n### Segurança no compartilhamento\n\nAgora, em vez de visualizar o novo token diretamente ao gerar e renovar o token, você receberá um link de acesso único. A mudança tem o objetivo de aumentar a segurança no compartilhamento de dados sensíveis e diminuir a superfície de acesso a ataques.\n\nO link de acesso único pode ser copiado para acesso posterior ou compartilhado com a pessoa que precisa utilizá-lo. O link pode ser acessado apenas uma vez, ou seja, expira ao ser clicado. Se não houver interações em 24 horas, o link também expira.\n\n![one-time-link-pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/announcements/2025/agosto/2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade_2.png)\n\n> ⚠️ A URL oficial para acessar o token segue sempre o formato `share.vtex.com/credentials/{token}`. O `{token}` é um identificador aleatório gerado no momento da criação ou renovação da chave. Verifique o formato do link antes de acessá-lo para evitar riscos de phishing ou acesso a páginas maliciosas.\n\n### Facilidade de gestão\n\n* **Exportação de chaves de API**: agora você pode gerar um arquivo XLSX com informações das chaves de API geradas na conta e chaves externas.  \n\n* **Funcionalidade de busca aprimorada**: a lista de chaves de API agora permite buscar uma chave pelo apelido, além do nome original.\n\n### Otimização dos alertas\n\n* **Renovação de token**: a coluna **Duração do token** foi removida para facilitar o entendimento durante a gestão de chaves geradas. O sistema agora exibe alertas recomendando a renovação a partir do período configurado (3 ou 6 meses), ainda mantendo a validade contínua do token.  \n\n  Veja a seguir como os alertas são exibidos na linha da chave de API:\n\n<table>\n  <tr>\n    <td>\n      <img src=\"https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/announcements/2025/agosto/2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade_3.png\" alt=\"renew-recommended-pt\">\n    </td>\n  </tr>\n  <tr>\n    <td>\n       O alerta laranja significa que o token passou do prazo recomendado de uso em até 3 meses.\n    </td>\n  </tr>\n</table>\n\n<br />\n\n<table>\n  <tr>\n    <td>\n      <img src=\"https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/announcements/2025/agosto/2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade_4.png\" alt=\"renew-highly-recommended-pt\">\n    </td>\n  </tr>\n  <tr>\n    <td>\n       O alerta vermelho significa que o token está em uso há 3 meses ou mais além do prazo determinado.\n    </td>\n  </tr>\n</table>\n\n* **Exclusão de token pendente**: adicionamos alertas para notificar quando a exclusão de um token antigo estiver pendente, após a [renovação](/pt/docs/tutorials/renovar-token-de-api).\n\n<table>\n  <tr>\n    <td>\n      <img src=\"https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/announcements/2025/agosto/2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade_5.png\" alt=\"pending-deletion-alert-pt\">\n    </td>\n  </tr>\n  <tr>\n    <td>\n      Alerta geral, no topo da aba **Geradas**.\n    </td>\n  </tr>\n</table>\n\n<br />\n\n<table>\n  <tr>\n    <td>\n      <img src=\"https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/announcements/2025/agosto/2025-08-12-chaves-de-api-melhorias-para-mais-seguranca-controle-e-visibilidade_6.png\" alt=\"delete-pending-pt\">\n    </td>\n  </tr>\n  <tr>\n    <td>\n      Alerta na linha da chave gerada.\n    </td>\n  </tr>\n</table>\n\n## Por que fizemos essa mudança?\n\nAplicamos as melhorias para proporcionar uma experiência mais completa e intuitiva na gestão das chaves de API, contribuindo para a segurança e eficiência das operações.\n\nO objetivo é oferecer mais segurança e praticidade, incluindo:\n\n* Maior proteção no compartilhamento de tokens, reduzindo o risco de exposição acidental.  \n* Colaboração facilitada entre equipes que gerenciam a conta e equipes de desenvolvimento.\n\n## O que precisa ser feito?\n\nNenhuma ação é necessária. A atualização é automática para todas as contas.\n\nConfira a documentação atualizada para explorar todas as funcionalidades:\n\n* [Chaves de API](/pt/docs/tutorials/chaves-de-api)  \n* [Chaves externas](/pt/docs/tutorials/chaves-externas) \n* [Chaves geradas](/pt/docs/tutorials/chaves-geradas)  \n* [Configurar alerta para renovar tokens de API](/pt/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api)  \n* [Exportar chaves de API](/pt/docs/tutorials/exportar-chaves-de-api)  \n* [Renovar token de API](/pt/docs/tutorials/renovar-token-de-api)"}