Documentation Guardrail Ledger

Dépannage

Commencez par le journal du pipeline. L'étape nomme le scanner ou l'erreur.

SymptômeCause et solution
L'étape échoue en nommant un scannerLe scanner est absent du PATH, a planté, s'est terminé par une erreur ou n'a écrit aucun SARIF exploitable. Installez-le sur l'agent et relancez.
L'ingestion répond 401Le jeton d'ingestion est absent, incorrect ou révoqué. Créez-en un nouveau sur la page Pipeline.
L'ingestion répond 415Envoyez Content-Type: application/json.
L'ingestion répond 400 empty_sarif ou invalid_sarifLe corps ne contient aucun SARIF, ou des documents qui ne nomment pas leur outil. Vérifiez la sortie du scanner.
L'ingestion répond 409Le contrôle a bloqué l'exécution. Ouvrez Constats, corrigez ou mettez en exception les constats situés au niveau de votre seuil ou au-dessus.
Aucun commentaire sur la pull requestAzure DevOps : ajoutez la ligne d'environnement SYSTEM_ACCESSTOKEN, donnez au service de build la permission Contribute to pull requests et exécutez le pipeline sur les pull requests. GitHub : donnez au job pull-requests: write et exécutez sur des branches, pas sur des forks.
Une modification est refusée avec insufficient_roleSeuls les propriétaires et administrateurs de l'espace de travail peuvent modifier le contrôle, les jetons, le partage Azure DevOps et les exceptions.
Aucun lien vers la Marketplace sur la page PipelineL'extension est partagée manuellement après l'enregistrement de votre organisation. D'ici là, utilisez l'exemple de premier scan ou l'Action GitHub.
Rien sous ConstatsEnvoyez l'exemple de premier scan depuis la page Pipeline, puis vérifiez le filtre de statut sur Constats.

Pour toute autre question, écrivez à hello@spot-suite.com en indiquant l'adresse de l'espace de travail et le journal du pipeline.