Documentación de Guardrail Ledger
Solución de problemas
Empiece por el registro del pipeline. El paso nombra el escáner o el error.
| Síntoma | Causa y solución |
|---|---|
| El paso falla nombrando un escáner | El escáner falta en PATH, se bloqueó, terminó con un error o no escribió un SARIF utilizable. Instálelo en el agente y vuelva a ejecutar. |
| La ingesta responde 401 | El token de ingesta falta, es incorrecto o está revocado. Genere uno nuevo en la página Pipeline. |
| La ingesta responde 415 | Envíe Content-Type: application/json. |
La ingesta responde 400 empty_sarif o invalid_sarif | El cuerpo no contiene SARIF, o contiene documentos que no nombran su herramienta. Compruebe la salida del escáner. |
| La ingesta responde 409 | La puerta bloqueó la ejecución. Abra Hallazgos, corrija los hallazgos en su umbral o por encima, o póngales una excepción. |
| No hay comentario en el pull request | Azure DevOps: añada la línea de env SYSTEM_ACCESSTOKEN, dé al servicio de compilación el permiso Contribute to pull requests y ejecute el pipeline en los pull requests. GitHub: dé al job pull-requests: write y ejecute en ramas, no en forks. |
Un cambio se rechaza con insufficient_role | Solo los propietarios y administradores del espacio de trabajo pueden cambiar la puerta, los tokens, el uso compartido de Azure DevOps y las excepciones. |
| No hay enlace del Marketplace en la página Pipeline | La extensión se comparte a mano después de guardar su organización. Hasta entonces, use el ejemplo de primer escaneo o la GitHub Action. |
| No hay nada en Hallazgos | Envíe el ejemplo de primer escaneo desde la página Pipeline y después compruebe el filtro de estado en Hallazgos. |
Para cualquier otra cuestión, escriba a hello@spot-suite.com e incluya la dirección del espacio de trabajo y el registro del pipeline.