Tout ce qui mérite d'être su, rien qui ne le mérite pas.
Rotation sans interruption de service
Générez une nouvelle clé depuis le tableau de bord (Clés API → Générer) pendant que la clé actuelle est encore active. Déployez la nouvelle clé sur vos applications et vérifiez que le trafic y circule correctement, puis révoquez l'ancienne clé. Les deux clés étant valides pendant la période de chevauchement, il n'y a aucune interruption de service : il s'agit du modèle de rotation standard sans interruption de service.
Révocation d'une clé
La révocation d'une clé depuis le tableau de bord est immédiate : toute requête utilisant cette clé est rejetée. BroadNet ne conservant jamais les clés brutes, une clé révoquée ne laisse aucune trace susceptible d'être divulguée. Révoquez-la sans délai si elle a pu être intégrée à un système de gestion de versions, collée dans un ticket ou exposée d'une autre manière.
Traitez les identifiants de test comme des secrets de production
Les identifiants de test fonctionnent sur l'endpoint de production, https://api.broadnet.me ; protégez-les donc comme n'importe quel secret de production dès le premier jour : conservez le jeton dans une variable d'environnement ou un gestionnaire de secrets, jamais dans le contrôle de source, le code côté client ou des fixtures de test partagées, et renouvelez-le s'il a pu être exposé. Voir /answers/what-is-sandbox-vs-production.
Quand faire tourner
Mettez en place une rotation régulière des clés (trimestrielle étant une fréquence courante) afin qu'aucune clé ne reste indéfiniment accessible, et procédez immédiatement à une rotation en cas de suspicion de compromission ou lorsqu'une personne ayant accès à une clé quitte l'équipe. Cette rotation planifiée limite les risques liés à une clé compromise dont vous ignoriez la nature.
Les clés sont révocables
Les API keys sont révocables à tout moment, ce qui rend la rotation régulière sûre et économique. Combinez la rotation avec une utilisation des clés selon le principe du moindre privilège, afin que chaque application ne détienne que les identifiants dont elle a réellement besoin. Voir /developers/authentication.