Documentation Guardrail Ledger
Clés d'API et portées
Guardrail Ledger n'a qu'un seul type de clé, le jeton d'ingestion. Il n'a pas de portées configurables.
| Clé | Utilisée pour | Qui peut la gérer |
|---|---|---|
| Jeton d'ingestion | Envoyer du SARIF à /api/v1/ingest/sarif depuis un pipeline. Il ne peut ni lire les constats ni modifier les paramètres. | Propriétaires et administrateurs de l'espace de travail |
Manipuler les jetons
- Créez un jeton sur la page Pipeline. Il n'est affiché qu'une fois et seul son hachage est conservé.
- Stockez-le comme variable secrète. Ne le mettez jamais dans un fichier de dépôt ni dans une capture d'écran.
- Utilisez un jeton par pipeline, afin de pouvoir en révoquer un sans toucher aux autres.
- Révoquer un jeton interrompt immédiatement l'ingestion avec ce jeton. Révoquez via l'API avec
DELETE /api/v1/tokens/<id>, connecté en tant que propriétaire ou administrateur, avec un type de contenu JSON et un corps JSON vide.
Chaque création et chaque révocation est écrite dans le journal d'audit avec l'auteur de l'action.