Documentação do Guardrail Ledger
Resolução de problemas
Comece pelo registo do pipeline. O passo indica o scanner ou o erro.
| Sintoma | Causa e correção |
|---|---|
| O passo falha indicando um scanner | O scanner não está no PATH, falhou, terminou com erro ou não escreveu SARIF utilizável. Instale-o no agente e execute de novo. |
| A ingestão responde 401 | O token de ingestão está em falta, errado ou foi revogado. Crie um novo na página Pipeline. |
| A ingestão responde 415 | Envie Content-Type: application/json. |
A ingestão responde 400 empty_sarif ou invalid_sarif | O corpo não contém SARIF, ou contém documentos que não indicam a sua ferramenta. Verifique o resultado do scanner. |
| A ingestão responde 409 | O gate bloqueou a execução. Abra Findings, corrija ou abra exceção para as descobertas iguais ou acima do seu limiar. |
| Sem comentário no pull request | Azure DevOps: adicione a linha de env SYSTEM_ACCESSTOKEN, dê ao serviço de compilação a permissão Contribute to pull requests e execute o pipeline em pull requests. GitHub: dê ao job pull-requests: write e execute em ramos, não em forks. |
Uma alteração é recusada com insufficient_role | Apenas os proprietários e administradores do espaço de trabalho podem alterar o gate, os tokens, a partilha do Azure DevOps e as exceções. |
| Sem ligação do Marketplace na página Pipeline | A extensão é partilhada manualmente depois de guardar a sua organização. Até lá, use o exemplo de primeira análise ou a GitHub Action. |
| Nada em Findings | Envie o exemplo de primeira análise a partir da página Pipeline e depois verifique o filtro de estado em Findings. |
Para qualquer outro assunto escreva para hello@spot-suite.com e inclua o endereço do espaço de trabalho e o registo do pipeline.