{"section":"announcements","requestedLocale":"pt","requestedSlug":"2024-12-03-chaves-de-api-nova-experiencia-com-foco-em-usabilidade-e-seguranca","locale":"pt","slug":"2024-12-03-chaves-de-api-nova-experiencia-com-foco-em-usabilidade-e-seguranca","path":"docs/pt/announcements/2024/dezembro/2024-12-03-chaves-de-api-nova-experiencia-com-foco-em-usabilidade-e-seguranca.md","branch":"main","content":"Introduzimos uma nova experiência de gerenciamento de [chaves de API](/pt/docs/tutorials/chaves-de-api) para proporcionar um controle mais eficiente sobre suas credenciais.\n\nA atualização inclui uma interface otimizada para facilitar a gestão e novas funcionalidades voltadas para segurança, como a definição da duração de tokens, a renovação de tokens e a exclusão de chaves não utilizadas.\n\n![apikeys-pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/announcements/2024/dezembro/2024-12-03-chaves-de-api-nova-experiencia-com-foco-em-usabilidade-e-seguranca_1.png)\n\n## O que mudou?\n\nVeja todas as novidades a seguir:\n\n| Alteração | Descrição |\n| :---- | :---- |\n| **Nomenclatura** | Alteramos a nomenclatura *chaves de aplicação* para *chaves de API* na interface do Admin. |\n| **Design** | A interface de gerenciamento, criação e edição de chaves de API foi redesenhada para uma experiência mais intuitiva e eficiente. |\n| **Separação de chaves** | Chaves geradas internamente e chaves de terceiros agora são separadas em abas distintas para facilitar o gerenciamento de cada tipo de chave. |\n| **Duração de tokens** | Todos os tokens de API gerados internamente agora têm uma duração padrão de 3 meses, que pode ser alterada para 6 meses na interface.<br /><br />A configuração se aplica a todos os tokens novos e existentes gerados na conta e terá a data de criação da chave como referência para a contagem da duração.<br /><br />A duração de tokens terceiros é visível e configurável somente pela conta que criou o token.<br /><br />Quando os tokens gerados se tornarem obsoletos, os lojistas serão informados na interface. Não há impacto no uso do token — o status obsoleto é apenas um recurso visual para indicar o estado do token e sugerir a renovação.<br /><br />Saiba mais em [Configurar alerta para renovar tokens de API](/pt/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api). |\n| **Renovação de tokens** | Agora é possível renovar tokens de chaves geradas na conta. A funcionalidade permite optar por excluir o token antigo imediatamente ou em outro momento.<br /><br />Ao optar por excluir em outro momento, os dois tokens estarão válidos e funcionais até a exclusão do antigo, permitindo que o lojista atualize o token utilizado em integrações sem prejudicar a operação. Saiba mais em [Renovar token de API](/pt/docs/tutorials/renovar-token-de-api). |\n| **Exclusão de chaves de API** | Os lojistas agora podem excluir chaves de API que não serão mais utilizadas. |\n| **Permissões específicas** | Novas permissões necessárias para gerenciar chaves de API:<br /><ul class=\"t-body c-on-base mb7 lh-copy\"><li class=\"t-body c-on-base mb5 lh-copy\">*View API Keys* (visualizar, filtrar, buscar e ordenar chaves de API geradas e terceiras)</li><li class=\"t-body c-on-base mb5 lh-copy\">*Edit API Keys* (criar, excluir, mudar o status e adicionar ou remover permissões de chaves de API)</li><li class=\"t-body c-on-base mb5 lh-copy\">*Renew API Token* (visualizar e renovar tokens de chaves geradas)</li><li class=\"t-body c-on-base mb5 lh-copy\">*Edit API Keys settings* (editar configuração da duração de tokens de chaves geradas)</li></ul>Saiba mais em [Recursos do License Manager](/pt/docs/tutorials/recursos-do-license-manager).<br /><br />Os usuários com as permissões para controle de usuários e perfis de acesso vão obter as novas permissões de forma automática, conforme a tabela: <br /><br /><table><thead><tr class=\"bb b--muted-4\"><th class=\"t-body fw5 c-muted-1 bw1 pa3 pb3 b--muted-4 tl\">Usuários com…</th><th class=\"t-body fw5 c-muted-1 bw1 pa3 pb3 b--muted-4 tl\">Recebem automaticamente…</th></tr></thead><tbody><tr class=\"bb b--muted-4\"><td class=\"t-body pa3 bb b--muted-4\">Get account by identifier</td><td class=\"t-body pa3 bb b--muted-4\">View API Keys</td></tr><tr class=\"bb b--muted-4\"><td class=\"t-body pa3 bb b--muted-4\">Get paged users</td><td class=\"t-body pa3 bb b--muted-4\">View API Keys</td></tr><tr class=\"bb b--muted-4\"><td class=\"t-body pa3 bb b--muted-4\">Get paged roles</td><td class=\"t-body pa3 bb b--muted-4\">View API Keys</td></tr><tr class=\"bb b--muted-4\"><td class=\"t-body pa3 bb b--muted-4\">Find user by email</td><td class=\"t-body pa3 bb b--muted-4\">View API Keys</td></tr><tr class=\"bb b--muted-4\"><td class=\"t-body pa3 bb b--muted-4\">Save user</td><td class=\"t-body pa3 bb b--muted-4\">Edit API Keys</td></tr><tr class=\"bb b--muted-4\"><td class=\"t-body pa3 bb b--muted-4\">Owner - Super Admin</td><td class=\"t-body pa3 bb b--muted-4\">Edit API Keys settings</td></tr><tr class=\"bb b--muted-4\"><td class=\"t-body pa3\">[User Administrator - RESTRICTED](/pt/docs/tutorials/perfis-de-acesso-predefinidos#user-administrator-restricted)</td><td class=\"t-body pa3\">Renew API Token</td></tbody></table> |\n\n## Por que fizemos essa mudança?\n\nO objetivo da nova experiência é proporcionar mais controle e segurança sobre suas chaves de API, com facilidade de uso. A interface agiliza a gestão de diferentes tipos de chaves e otimiza a visibilidade das informações.\n\nAlém disso, a configuração da duração de tokens adiciona uma camada extra de segurança, enquanto as opções de renovação garantem que a operação da loja não seja impactada.\n\n## O que precisa ser feito?\n\nSiga os passos abaixo para acessar a nova experiência:\n\n1. Na barra superior do Admin VTEX, clique no **avatar do seu perfil**, marcado pela inicial do seu email, e depois em **Configurações da conta > Chaves de API**.  \n2. Clique em `Testar nova experiência`.\n\nÉ possível voltar para a versão anterior da página ao clicar em `Voltar à versão anterior`.\n\nPara mais informações, acesse a documentação relacionada:\n\n* [Chaves de API](/pt/docs/tutorials/chaves-de-api)  \n* [Configurar alerta pare renovar tokens de API](/pt/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api)  \n* [Chaves geradas](/pt/docs/tutorials/chaves-geradas)  \n* [Renovar token de API](/pt/docs/tutorials/renovar-token-de-api) \n* [Chaves externas](/pt/docs/tutorials/chaves-externas)"}