Documentación de Guardrail Ledger

La puerta y las excepciones

La puerta decide si un pull request pasa. Una excepción evita que un hallazgo aceptado lo haga fallar, hasta que la excepción caduca.

Definir la puerta

Un propietario o administrador abre la página Puertas y define:

Elija Guardar. El cambio de la puerta se escribe en el registro de auditoría.

Leer el resultado

Cada ejecución responde con el resultado de la puerta. Cuando la puerta bloquea, la llamada de ingesta responde con el estado 409 y el paso o job falla, a menos que establezca failOnGate: false en la tarea o fail-on-gate: false en la Action. El resultado también se escribe en el comentario del pull request y, en GitHub, en el resumen del job. Los hallazgos permanecen en Hallazgos con el repositorio y el pull request en los que se encontraron.

Un escaneo resuelve solo los hallazgos de los motores que informaron en él. Un hallazgo que ya no aparece se marca como resuelto.

Registrar una excepción

  1. Un propietario o administrador abre la página Excepciones.
  2. Elija un hallazgo abierto, o pegue su huella.
  3. Elija el responsable, un miembro del espacio de trabajo que no sea usted. Usted queda registrado como aprobador.
  4. Escriba el motivo y establezca la caducidad, como máximo 90 días a partir de hoy.
  5. Elija Registrar excepción. Se aplica de inmediato.

Un hallazgo con excepción no hace fallar la puerta. Después de la fecha de caducidad, el siguiente escaneo vuelve a contarlo para la puerta. La consola no tiene ningún botón para revocar una excepción.