Köra om PR-skanningar

Varje pull request skannas automatiskt när den öppnas och vid varje push. Skannrarna – beroenden (fremforge/dep-scan), SAST (fremforge/sast), licenser (fremforge/license-scan), container-image (fremforge/image-scan) och signaturverifiering (fremforge/cosign-verify, informativ) – publicerar sina resultat som commit-statusar på pull requesten, och dina branch-skyddsregler spärrar på dem.

Ibland kan en pull requests skanningsstatusar bli inaktuella, till exempel när en tillfällig störning i plattformen gjorde att en status aldrig publicerades. Du behöver inte pusha en tom commit (och vänta igenom ett helt CI-bygge) bara för att köra om skannrarna, som tar ungefär en minut. Kör om dem direkt i stället.

Kör om skannrarna för en pull request

curl -sS -X POST \
  -H "Authorization: Bearer <token with findings:write>" \
  https://frem.sh/_app/api/v1/orgs/<org>/repos/<repo>/pulls/<number>/rescan

• Scope: findings:write.
• Kör om skannrarna mot pull requestens aktuella head-commit och publicerar om commit-statusarna fremforge/*. Skannrarna blir normalt klara på några sekunder.
• Idempotent: säkert att anropa flera gånger; resultaten dedupliceras på repo + commit + skanner. Inget nytt CI-bygge startas.
• Följer organisationens skanningspolicy (en skanner som är satt till off för organisationen eller repot körs inte), precis som den automatiska skanningen vid push.

Lyckat anrop

{
  "repo_full_name": "acme/api",
  "pr_number": 42,
  "head_sha": "a1b2c3d4…",
  "scanners_enqueued": 5
}

Andra svar

När du ska använda det

• En pull request är blockerad av en skanningsstatus som aldrig publicerades eller ser inaktuell ut.
• Du har ändrat skanningspolicyn för organisationen eller repot och vill utvärdera en öppen pull request mot den nya policyn utan att pusha en commit.

Hur den automatiska skanningen fungerar och detaljer per skanner finns under Beroendeskanning, SAST, Licensskanning, Image-skanning och Signaturverifiering. Det fullständiga schemat för anrop och svar finns i API-referensen.