Guardrail-Ledger-Dokumentation
Fehlerbehebung
Beginnen Sie mit dem Pipeline-Log. Der Schritt nennt den Scanner oder den Fehler.
| Symptom | Ursache und Lösung |
|---|---|
| Der Schritt schlägt fehl und nennt einen Scanner | Der Scanner fehlt im PATH, ist abgestürzt, mit einem Fehler beendet worden oder hat kein brauchbares SARIF geschrieben. Installieren Sie ihn auf dem Agent und führen Sie den Lauf erneut aus. |
| Ingest antwortet mit 401 | Das Ingest-Token fehlt, ist falsch oder wurde widerrufen. Erzeugen Sie auf der Seite Pipeline ein neues. |
| Ingest antwortet mit 415 | Senden Sie Content-Type: application/json. |
Ingest antwortet mit 400 empty_sarif oder invalid_sarif | Der Body enthält kein SARIF oder Dokumente, die ihr Tool nicht nennen. Prüfen Sie die Scanner-Ausgabe. |
| Ingest antwortet mit 409 | Das Gate hat den Lauf blockiert. Öffnen Sie Findings und beheben Sie die Befunde auf oder über Ihrem Schwellenwert oder nehmen Sie sie aus. |
| Kein Kommentar am Pull Request | Azure DevOps: Fügen Sie die Zeile SYSTEM_ACCESSTOKEN unter env hinzu, geben Sie dem Build-Service Contribute to pull requests und führen Sie die Pipeline bei Pull Requests aus. GitHub: Geben Sie dem Job pull-requests: write und führen Sie ihn auf Branches aus, nicht auf Forks. |
Eine Änderung wird mit insufficient_role abgelehnt | Nur Workspace-Owner und -Admins können das Gate, Tokens, die Azure-DevOps-Freigabe und Ausnahmen ändern. |
| Kein Marketplace-Link auf der Seite Pipeline | Die Erweiterung wird von Hand geteilt, nachdem Sie Ihre Organisation gespeichert haben. Bis dahin verwenden Sie das Beispiel für den ersten Scan oder die GitHub Action. |
| Nichts unter Findings | Senden Sie das Beispiel für den ersten Scan von der Seite Pipeline und prüfen Sie dann den Statusfilter unter Findings. |
Schreiben Sie für alles Weitere an hello@spot-suite.com und geben Sie die Workspace-Adresse und das Pipeline-Log an.