{"section":"tutorials","requestedLocale":"pt","requestedSlug":"chaves-geradas","locale":"pt","slug":"chaves-geradas","path":"docs/pt/tutorials/gerenciamento-da-conta/chaves-de-api/chaves-geradas.md","branch":"main","content":"As chaves de API internas são credenciais internas, geradas e administradas por sua conta VTEX. Isso significa que você deve ter acesso a todos os pares de chaves e tokens de API — o equivalente a nomes de usuário e senhas para integrações de API.\n\nA aba **Geradas** apresenta a listagem de chaves de API criadas pela sua conta. Você pode utilizar a barra de busca para encontrar uma chave pelo nome ou valor preenchido em **Identificação da chave** ao gerá-la.\n\n\n\nA página apresenta as informações a seguir em uma tabela: \n\n| Coluna | Descrição |\n| ---- | ---- |\n| **Chave/Nome** | Chave de API, seguida pelo nome definido durante a criação da chave. Se o token tiver passado do período de renovação recomendado (3 meses, por padrão), ao lado da chave aparece um ícone de alerta para renovação. Saiba mais em [Configurar alerta para renovar tokens de API](/pt/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api). |\n| **Perfil de acesso** | Perfis de acesso associados à chave de API. |\n| **Data de criação** | Data de criação da chave de API. |\n| **Status** | Status da chave de API, que pode ser **Ativo** ou **Inativo**. |\n\nEsta página permite que você realize as seguintes ações:\n\n* [Gerar chave](#gerar-chave) \n* [Editar chave gerada](#editar-chave-gerada) \n* [Inativar ou ativar chave gerada](#inativar-ou-ativar-chave-gerada) \n* [Renovar token](#renovar-token) \n* [Excluir chave](#excluir-chave)\n\n## Gerar chave\n\nSiga as instruções abaixo para criar uma nova chave de API:\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. Certifique-se de que você está na aba **Geradas**. \n3. Clique em `+ Gerar chave`. \n4. Preencha o campo **Identificação da chave** com o nome para identificar a chave de API. Este campo é obrigatório. \n5. Selecione os [perfis de acesso](/pt/docs/tutorials/perfis-de-acesso) que serão associados à chave. Por padrão, nenhum perfil de acesso é pré-selecionado.\n\n > ℹ️ Marque apenas os perfis de acesso necessários para a integração que utilizará a chave de API. O uso irrestrito de perfis de acesso muito permissivos aumenta o risco de ataques nas lojas por vazamento de credenciais de login.\n\n6. Clique em `Gerar`.\n\n Você poderá visualizar o token a partir de um link de acesso único, com duração de 24 horas se não houver acesso.\n\n7. Clique em `Copiar` para copiar o link de acesso único ao novo token para a área de transferência. Este link será exibido apenas uma vez. Nesta etapa, a chave já está ativa e disponível para uso. \n8. Clique em `Encerrar`.\n9. Acesse o link copiado ou compartilhe-o com a pessoa que vai utilizar o token. O link pode ser acessado apenas uma vez e tem duração de 24 horas se não houver acesso.\n10. Clique em `Copiar` para copiar o token da API para a área de transferência. Esse segredo será exibido apenas uma vez. Salve-o em um local seguro.\n\n\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## Editar chave gerada\n\nSiga o passo a passo abaixo para realizar alterações em uma chave de API:\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. Certifique-se de que você está na aba **Geradas**. \n3. Na linha de uma chave de API, clique no menu ⋮ e depois em `Editar`. \n4. Aplique as modificações desejadas, entre as opções abaixo: \n * Modificar a seleção de perfis de acesso associados à chave de API. \n * Desmarcar ou marcar a opção **Ativa** para [inativar ou ativar a chave gerada](#inativar-ou-ativar-chave-gerada). \n5. Clique em `Salvar`.\n\n## Inativar ou ativar chave gerada\n\nSe uma chave de API que tenha acesso à sua conta for comprometida, você deve inativá-la imediatamente para revogar o acesso à sua conta. Se necessário, você pode gerar uma nova chave para substituir a anterior.\n\nCaso cometa algum erro, é possível reativar a chave de API para restabelecer a integração impactada.\n\nSiga o passo a passo abaixo para inativar ou ativar uma chave de API:\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. Certifique-se de que você está na aba **Geradas**. \n3. Na linha de uma chave de API, clique no menu ⋮ e prossiga para uma das ações a seguir: \n * **Inativar:** se a chave estiver **ativa**, clique em `Inativar` para desabilitá-la. Essa ação vai interromper integrações que utilizem a chave, então utilize-a com cautela. É necessário clicar em `Inativar` mais uma vez para confirmar a ação. \n * **Ativar:** se a chave estiver **inativa**, clique em `Ativar` para disponibilizá-la para uso.\n\n> ℹ️ Apenas reative a chave de API se tiver certeza de que ela não foi comprometida. Quando a chave está ativa, qualquer pessoa com o token de API associado pode ter acesso à sua conta.\n\n## Renovar token\n\nRenovar o token de API com frequência é crucial para manter a segurança da sua loja. Para garantir a proteção contínua, faça a renovação antes mesmo de receber o [alerta](/pt/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api) para isso. Siga as instruções descritas em [Renovar token de API](/pt/docs/tutorials/renovar-token-de-api).\n\n## Excluir chave\n\nChaves de API que não serão mais utilizadas podem ser excluídas. Ao excluir essas chaves, é possível manter a listagem organizada e facilitar o gerenciamento das chaves em uso. \n\n> ⚠️ Certifique-se de que a chave de API não está mais em uso por nenhuma integração antes de excluí-la. Este procedimento não pode ser desfeito.\n\nPara excluir uma chave de API de forma definitiva, siga os passos abaixo:\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. Certifique-se de que você está na aba **Geradas**. \n3. Na linha de uma chave de API, clique no menu ⋮ e depois em `Excluir chave`. \n4. Marque a opção *Entendo que essa ação não pode ser desfeita*. \n5. Para confirmar, clique em `Excluir`.\n\n## Saiba mais\n\n* [Chaves de API](/pt/docs/tutorials/chaves-de-api) \n* [Renovar token de API](/pt/docs/tutorials/renovar-token-de-api)\n* [Configurar alerta para renovar tokens de API](/pt/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api) \n* [Chaves externas](/pt/docs/tutorials/chaves-externas)"}