Como definir permissões e restrições de chaves API sem expor sua conta

Criar uma chave API parece simples: você dá um nome, copia a chave e o segredo e cola no seu robô ou planilha. O problema aparece quando essa chave nasce com permissões que você não precisa, como saque habilitado, e sem qualquer restrição de endereço IP. Se o arquivo de configuração vazar, o segredo for colado em um fórum ou o computador for comprometido, quem tiver a chave pode agir como se fosse você dentro dos limites que ela permite. A boa notícia é que a maior parte desse risco é controlável no momento da criação e em revisões periódicas. Neste guia você vai aprender a decidir o que cada chave precisa fazer, como restringir origem e permissões, o que registrar para auditar depois e quando revogar em vez de tentar corrigir. O foco é o processo: pensar antes de clicar, testar com pouco, registrar o que foi feito e revisar. Como as telas e os nomes de menu mudam, trate cada caminho citado como algo a confirmar na sua conta e na central de ajuda da exchange que você usa.

Decida o que a chave precisa fazer antes de criá-la

Antes de abrir a tela de criação, escreva em uma frase qual tarefa a chave vai executar. Exemplos comuns: ler saldo e histórico para uma planilha, enviar ordens de compra e venda em um par específico, ou apenas consultar posições. Essa frase define tudo o resto. Uma chave de leitura não deve ter permissão de negociação, e uma chave de negociação não deve ter permissão de saque. Quanto menor o conjunto de ações permitidas, menor o estrago possível se o segredo escapar.

Separe também o ambiente. Se você testa estratégias, crie uma chave distinta da que opera de verdade, mesmo que as permissões pareçam iguais. Assim, ao desligar os testes, você revoga só aquela chave e mantém a produção intacta. Evite reaproveitar a mesma chave em vários programas, porque fica impossível saber qual deles causou um comportamento estranho e qual deve ser desligado.

Por fim, defina um prazo de validade mental para a chave. Anote a data de criação e uma data de revisão. Chaves antigas costumam sobreviver a mudanças de estratégia, troca de computador e projetos abandonados, e viram pontos cegos. Se a exchange oferecer expiração automática, considere usar; se não oferecer, a revisão periódica cumpre esse papel.

Restrinja permissões, IP e saque na criação

Na tela de criação, procure os blocos de permissões e marque apenas o necessário. Leitura de dados costuma ser a opção mais inofensiva. Negociação permite enviar e cancelar ordens, então só ative se o seu uso realmente exigir. Saque é a permissão mais perigosa: se o seu caso não precisa dela, deixe desativada. Mesmo que a exchange exija etapas extras para habilitar saque em uma chave, não passe por elas sem uma razão concreta.

A restrição por endereço IP é o segundo filtro mais importante. Quando ativada, a exchange só aceita requisições vindas do endereço que você cadastrou. Isso não protege contra alguém que já esteja dentro da sua rede, mas bloqueia o uso da chave copiada de outro lugar. Cadastre o IP fixo do servidor ou da sua conexão e confirme que ele não muda com frequência; se mudar, a chave para de funcionar e você precisa atualizar o cadastro. Teste a chave logo após criar, com uma chamada simples, para confirmar que a restrição está funcionando como esperado.

Se a exchange permitir escopo por produto, como spot ou derivados, limite a chave ao mercado que você opera. Em contas com vários produtos, uma chave ampla pode alcançar mercados que você nem acompanha. Sempre que houver dúvida entre uma permissão ampla e uma restrita, escolha a restrita e crie outra chave depois se faltar algo. Consulte a central de ajuda para os nomes exatos das opções, porque a terminologia varia entre plataformas.

Guarde o segredo apenas no gerenciador de senhas ou no cofre de segredos do servidor, nunca em arquivos de texto, capturas de tela ou conversas. Se a exchange mostrar o segredo uma única vez, essa é a hora de salvá-lo no lugar certo. Se você precisar compartilhar o acesso com outra pessoa, crie uma chave separada para ela, com as mesmas restrições, em vez de entregar a sua.

Registre cada chave e revise periodicamente

Mantenha um registro simples, fora da exchange, com uma linha por chave: apelido, data de criação, finalidade, permissões ativas, IP cadastrado e data da próxima revisão. Não anote o segredo nesse registro. O objetivo é conseguir responder rapidamente a perguntas como quais chaves ainda existem, qual delas tem negociação ativa e qual está ligada a um projeto que você abandonou.

Na revisão, abra a lista de chaves na sua conta e compare com o registro. Procure chaves sem uso, chaves com permissões que não combinam com a finalidade, IPs desatualizados e nomes genéricos que não dizem nada. Renomeie o que for ambíguo e revogue o que não tem dono claro. Aproveite para conferir se alguma chave nova foi criada sem passar pelo seu processo, o que pode indicar acesso indevido ou um teste esquecido.

Se a exchange oferecer histórico de uso ou registro de atividades da chave, revise os últimos acessos. Padrões estranhos, como chamadas em horários em que você não opera ou de endpoints que você não usa, merecem investigação. Anote o que encontrou e a ação tomada. Esse histórico também ajuda a decidir se uma chave pode ser desativada sem quebrar nada.

Sempre que trocar de computador, de servidor ou de provedor de nuvem, trate as chaves ligadas ao ambiente antigo como comprometidas até prova em contrário. Revogue e crie novas, em vez de apenas atualizar o IP. A troca de ambiente é um dos momentos mais comuns de esquecimento, e uma chave órfã com negociação ativa pode continuar funcionando por meses.

Quando revogar, como testar e erros comuns

Revogar é a resposta padrão quando há suspeita de vazamento, quando a chave não é mais usada ou quando você não consegue explicar para que ela serve. Antes de revogar, verifique se algum processo depende dela e planeje a substituição: crie a nova chave com as permissões corretas, atualize o programa, confirme que funciona e só então desative a antiga. Esse cuidado evita interromper operações por engano.

Ao testar uma chave nova, comece pelo cenário mais restrito possível. Faça uma consulta de leitura, depois uma ordem pequena se a permissão de negociação estiver ativa, e confirme que uma tentativa de saque ou de acesso fora do IP cadastrado é recusada. Esse teste negativo é tão importante quanto o positivo, porque mostra que as restrições estão realmente valendo. Se algo que deveria ser bloqueado passar, pare e revise a configuração antes de seguir.

Entre os erros mais comuns estão criar a chave com todas as permissões por conveniência, deixar o saque ativo sem necessidade, não cadastrar IP algum, compartilhar a mesma chave entre pessoas e guardar o segredo em local inseguro. Outro erro frequente é nunca revisar: a chave continua ativa anos depois, ligada a um script que ninguém mais entende.

Se você usa serviços de terceiros que pedem sua chave, leia com atenção o que eles declaram precisar e conceda só isso. Prefira chaves dedicadas, com restrição de IP quando o serviço oferecer endereços fixos, e revise o acesso periodicamente. Quando o serviço deixar de ser usado, revogue a chave no mesmo dia. Para detalhes de interface e opções disponíveis na sua conta, confirme na central de ajuda e nas configurações de segurança da exchange.

Limite de risco: Brazil Crypto Guide

Ativos digitais são voláteis e derivativos podem ampliar perdas. Este site não possui login, carteira, depósito ou chat de suporte. Um link de indicação registra apenas atribuição; não garante acesso, preço, recompensa, aprovação ou resultado de investimento. A disponibilidade pode variar por residência, entidade e produto; idioma ou marca não comprovam acesso regional.

Ponto de controle

• Escreva a finalidade de cada chave em uma frase antes de criá-la e mantenha uma chave separada para testes.
• Ative apenas as permissões necessárias e deixe o saque desativado, a menos que exista uma razão concreta e documentada.
• Cadastre a restrição de IP com o endereço fixo do seu servidor ou conexão e teste uma chamada logo após criar a chave.
• Guarde o segredo somente no gerenciador de senhas ou no cofre do servidor, nunca em texto, captura de tela ou conversa.
• Mantenha um registro com apelido, data de criação, finalidade, permissões, IP e data da próxima revisão, sem anotar o segredo.
• Revise a lista de chaves periodicamente e revogue as sem uso, com permissões excessivas ou ligadas a ambientes antigos.