Projets et clés API
Un projet par application, une clé par environnement : comment les créer, les utiliser et les révoquer.
Les projets
Un projet regroupe tout ce qui concerne une application ou un site : ses clés API, son journal des décisions, ses statistiques. Créez un projet par application : une boutique, une API, un site vitrine…
Dans le dashboard, le sélecteur de projet (en haut à gauche) permet de créer un projet et de passer de l'un à l'autre. Chaque projet a un nom et un identifiant (minuscules, chiffres, - et _), unique dans votre compte. L'identifiant interne du projet ne change jamais, même si vous le renommez.
Les clés API
Une clé API relie votre application à Zarex. Créez-la dans Clés API, avec un nom (par exemple « Serveur de production ») et un environnement :
| Environnement | Préfixe | À utiliser |
|---|---|---|
| Test | zarex_test_ | En local et en préproduction. |
| Production | zarex_live_ | Sur votre site en ligne. |
L'environnement de chaque décision est visible dans le journal : vous distinguez ainsi le trafic de test du trafic réel.
La clé n'est affichée qu'une seule fois
Zarex n'en conserve qu'une empreinte : impossible de la réafficher. Copiez-la dès sa création, et rangez-la dans les variables d'environnement de votre serveur (ZAREX_KEY), jamais dans votre code ni dans Git.
La liste des clés affiche le nom, le début de chaque clé (pour la reconnaître), l'environnement et le statut.
Révoquer une clé
Une clé perdue, exposée ou devenue inutile se révoque depuis la liste. La révocation est définitive : les applications qui l'utilisent ne sont plus protégées. Elles continuent de fonctionner (fail-open), et le SDK l'indique dans leurs logs.
Pour remplacer une clé sans interruption :
Déployez-la
Mettez à jour ZAREX_KEY sur vos serveurs, et vérifiez que les décisions apparaissent dans le journal.