Gå til hovedinnhold

Kjøre PR-skanninger på nytt

Hver pull request skannes automatisk når den åpnes og ved hver push. Skannerne – avhengigheter (fremforge/dep-scan), SAST (fremforge/sast), lisenser (fremforge/license-scan), containerimage (fremforge/image-scan) og signaturverifisering (fremforge/cosign-verify, kun til informasjon) – legger resultatene sine ut som commit-statuser på PR-en, og reglene for branchbeskyttelse sperrer på dem.

Av og til kan skannestatusene til en PR bli utdaterte – for eksempel etter at et forbigående plattformproblem gjorde at en status aldri ble lagt ut. Du trenger ikke å pushe en tom commit (og vente gjennom et fullt CI-bygg) bare for å kjøre skannerne, som tar rundt ett minutt, på nytt. Kjør dem heller direkte.

Kjør skannerne på nytt for en PR

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.
  • Kjører skannerne på nytt mot pull requestens nåværende head-commit og legger ut fremforge/*-commit-statusene på nytt. Skannerne er vanligvis ferdige på sekunder.
  • Idempotent – trygt å kalle gjentatte ganger; resultatene dedupliseres på repository + commit + skanner. Det starter ikke et nytt CI-bygg.
  • Følger skannepolicyen til organisasjonen din (en skanner som er satt til off for organisasjonen eller repositoryet, kjøres ikke), nøyaktig som den automatiske skanningen ved push.

Vellykket

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

Andre svar

StatusBetydning
404Fant ikke pull requesten.
409Ingenting ble kjørt på nytt – detail forklarer hvorfor (sentral PR-skanning er ikke slått på for organisasjonen, organisasjonen er ikke dekket, eller head-commiten kunne ikke slås opp).
503PR-skanning er ikke tilgjengelig på denne instansen.

Når du bør bruke det

  • En PR er blokkert av en skannestatus som aldri ble lagt ut eller ser utdatert ut.
  • Du har endret skannepolicyen for organisasjonen eller repositoryet og vil vurdere en åpen PR mot den nye policyen uten å pushe en commit.

For hvordan den automatiske skanningen oppfører seg og detaljer per skanner, se Avhengighetsskanning, SAST, Lisensskanning, Imageskanning og Signaturverifisering. Det fullstendige skjemaet for forespørsler og svar står i API-referansen.