Tudo o que vale a pena saber, nada do que não vale.
Gire sem tempo de inatividade
Gere uma nova chave no painel de controlo (Chaves de API → gerar) enquanto a chave atual ainda estiver ativa. Implante a nova chave nas suas aplicações e confirme se o tráfego está a fluir por ela. Em seguida, revogue a chave antiga. Como ambas as chaves são válidas durante o período de sobreposição, não há interrupção no serviço — este é o padrão de rotação sem tempo de inatividade.
Revogar uma chave
A revogação de uma chave no painel de controlo tem efeito imediato: qualquer solicitação que apresente a chave revogada será rejeitada. Como o BroadNet nunca regista as chaves brutas, uma chave revogada não deixa nenhum rasto que possa ser exposto. Revogue imediatamente se houver suspeita de que uma chave tenha sido incluída no controlo de versão, colada num ticket ou exposta de alguma outra forma.
Trate as credenciais de teste como segredos de produção
As credenciais de teste funcionam no endpoint de produção, https://api.broadnet.me, portanto, proteja-as como qualquer segredo de produção desde o primeiro dia: mantenha o token numa variável de ambiente ou num gestor de segredos, nunca no controlo de versão, no código do lado do cliente ou em fixtures de teste partilhados, e realize a rotação se houver suspeita de exposição. Veja /answers/what-is-sandbox-vs-production.
Quando rotacionar
Faça o rodízio num cronograma fixo (trimestral é uma base comum) para que nenhuma chave permaneça ativa indefinidamente e faça o rodízio imediatamente em caso de suspeita de exposição ou quando alguém com acesso a uma chave deixar a equipa. O rodízio programado limita o impacto de uma chave que você não sabia que estava comprometida.
As chaves podem ser revogadas
As chaves API podem ser revogadas a qualquer momento, o que torna a rotação rotineira segura e económica. Combine a rotação com o uso de chaves de privilégio mínimo para que cada aplicação possua apenas as credenciais de que realmente necessita. Veja /developers/authentication.