Para: Administradores
Restringir ou revogar uma chave de API
Limite uma chave a determinados endereços IP, desative-a ou exclua-a e veja quando ela foi usada pela última vez.
Neste artigo6 seções
Antes de começar
Verifique quando cada chave APIChave Um token secreto, criado em Integração, que permite que seu próprio software use a API do hub. foi usada pela última vez. Limite o uso dela apenas para o endereço do seu sistema. Desative-a por um tempo ou exclua-a completamente, caso a chave tenha vazado ou o sistema que a utiliza tenha sido descontinuado.
Verifique a última vez que foi utilizado.
Em Integração › Chaves, Último uso indica a data da última chamada de cada chave. Último IP usado, por sua vez, indica o endereço de onde a chamada veio. Chamadas rejeitadas devido à chave estar desativada, estar em um API errado ou estar fora do alcance da chave não são contadas. Um traço indica que a chave não foi utilizada.
Limite ao seu endereço
Selecione o ícone do lápis, Tecla de edição, na sua linha. Abaixo de Fonte CIDR, digite o endereço IPv4 público do seu sistema, como o indicado em Último IP usado, ou um intervalo de endereços, como 203.0.113.0/24. Para permitir que esse endereço seja utilizado de qualquer lugar, deixe a caixa vazia. Selecione Salve . A mensagem “Chave salva” será exibida, e desde então, chamadas provenientes de outros endereços serão rejeitadas.
Desligue-o
Para parar temporariamente o uso de uma chave, abra-a com Tecla de edição, desative Ativo e selecione Salve . Todas as chamadas que utilizam essa chave serão rejeitadas, até que você volte a ativá-la.
Apague-o
Para eliminar uma chave de uma vez por todas, selecione o ícone do recipiente, Tecla Delete, na sua linha, e depois selecione Excluir. A mensagem “Chave removida” será exibida. A chave deixará de funcionar imediatamente e não poderá ser recuperada.
O que acontece a seguir?
Ninguém é informado sobre quando você altera ou exclui uma chave. As chamadas do seu sistema para essa chave serão rejeitadas a partir daquele momento. Para saber o que acontece, consulte Autenticação de solicitações da API com uma chave.
Se uma chave pudesse ter vazado, desligue-a imediatamente. Depois… Crie uma nova chave., Mova seu sistema para esse novo local, e exclua o antigo. O tipo de chave também não pode ser alterado: crie uma chave do outro tipo, e depois exclua esta chave antiga. Seu hub pode conter duas chaves de cada tipo. Portanto, com já havendo duas chaves, exclua uma delas primeiro.