Gå til hovedindhold

Sikkerhed og forsyningskæde

fremforge leverer en sikkerhed i forsyningskæden i flere lag, som er inkluderet i alle planer med betaling pr. bruger. Kontrollerne kører fire steder, hvor alt skal passere: ved push (scanning af secrets), i pull requesten (scanning af afhængigheder, SAST), på artefaktet (scanning af containere, SBOM, SLSA-provenance) og på committen (signering med SSH-nøgle eller GPG).

Den kontraktlige side (BSI C5, ISO 27001/27017/27018, TISAX, GDPR samt analysen af Schrems II og CLOUD Act) finder du på frem.sh/trust.

Hvor fund vises

Sikkerhed › Fund åbner på Alle: alle åbne fund fra alle scannere i én liste med de vigtigste først (kendt udnyttede, derefter alvorlighed, derefter de ældste). Filtrér listen efter type og alvorlighed; hver chip viser, hvor mange fund den ville vise. En række linker til fundet på dets egen fane (SAST, Secrets, Afhængigheder, Container-images, Licenser, Malware), hvor dets detaljer og handlinger er. Den samme liste findes i API’et som GET /orgs/{org}/security/findings; se Fund-API.

Scanning af secrets (push-beskyttelse)

Gitleaks kører som pre-receive-hook på hvert push, før committen accepteres i repositoryet, fra et nyt repositorys allerførste push. Push-beskyttelse er altid slået til: ingen organisation eller repository kan slå scanningen fra. Den eneste indstilling er scannerens fejltilstand under Sikkerhed › Politikker › Push-beskyttelse: når selve scanneren ikke er tilgængelig, bliver et push enten afvist (standard) eller lukket igennem og registreret som en tilladelse ved fejl i revisionssporet; secrets, der slipper igennem i det tidsrum, fanges senere af den ugentlige gennemgang af historikken. Se Push-beskyttelse.

Hvad der blokeres

Gitleaks matcher over 120 mønstre med høj sikkerhed, herunder:

KategoriEksempler på mønstre
Legitimationsoplysninger til cloududbydereAWS access/secret keys, JSON for GCP-servicekonti, forbindelsesstrenge til Azure Storage
Tokens til kildekodestyringGitHub-PAT’er, GitLab-PAT’er, app-adgangskoder til Bitbucket
BetalingsnøglerStripe secret keys, Stripe-secrets til signering af webhooks
Tokens til kommunikationSlack-bottokens, Slack-webhook-URL’er, Twilio-auth-tokens
Private nøglerPrivate RSA-, EC- og Ed25519-nøgler, PEM-kodede certifikater
Generiske secretsStrenge med høj entropi, der matcher mønsteret generic-api-key, secrets til signering af JWT
Database-URL’erForbindelsesstrenge til PostgreSQL, MySQL, MongoDB og Redis med indlejrede legitimationsoplysninger

Når et push blokeres

Pushet afvises på remoten med en fejlmeddelelse, der angiver den matchede mønstertype samt fil og linjenummer. Committen accepteres ikke.

Slet ikke bare filen og commit igen. Secretet ligger i Git-historikken og vil blive blokeret igen. Den rigtige udbedring:

  1. Rotér secretet med det samme hos den tjeneste, der har udstedt det (AWS IAM, Stripes dashboard osv.). Gå ud fra, at det er kompromitteret.
  2. Omskriv historikken, så secretet fjernes fra alle berørte commits:
# Install git-filter-repo (https://github.com/newren/git-filter-repo)
pip install git-filter-repo

# Create a replacements file
echo '<secret-value>==>REDACTED' > replacements.txt

# Rewrite history
git filter-repo --replace-text replacements.txt

# Force-push the cleaned branch
git push --force-with-lease origin <branch>
  1. Giv besked til alle, der kan have klonet repoet før omskrivningen.

Tilsidesættelse

Er et blokeret secret bevidst (et token til internt værktøj, en offentliggjort testlegitimation), kan en ejer af organisationen tilføje en afgrænset tilsidesættelse:

  1. Gå til Sikkerhed › Politikker › Push-beskyttelse › Aktive tilsidesættelser → Ny tilsidesættelse.
  2. Angiv Repository (eller vælg “Alle repoer”), mønster for secret (fra Gitleaks’ regel-id) og begrundelse (fritekst, logges i revisionssporet).
  3. Gem. Tilsidesættelsen træder i kraft ved næste push.

Alle tilsidesættelser er synlige for organisationens andre ejere og står i revisionsloggen med aktør, tidspunkt og begrundelse. Tilsidesættelser kan til enhver tid tilbagekaldes på den samme side.

Tilsidesættelse af en afvisning af et push

Når et push afvises af scanningen for secrets, ser udvikleren grunden til afvisningen i terminalens output: den matchede mønstertype, filstien og linjenummeret.

En ejer af organisationen kan godkende en tilsidesættelse under Sikkerhed › Politikker › Push-beskyttelse › Seneste afvisninger. Hver afvisning viser repositoryet, committeren, tidspunktet, den registrerede type secret og den berørte filsti.

Omfang af tilsidesættelsen (vælges ved godkendelse):

  • Kun denne commit godkender den bestemte commit-SHA. Det samme secret i en senere commit afvises igen.
  • Denne filsti godkender secretet på den sti i alle senere commits. Brug det til testfixtures eller bevidst ufølsomme pladsholderværdier.
  • Dette repository godkender enhver forekomst af denne type secret i repositoryet. Brug det sparsomt.
  • Hele organisationen godkender typen af secret i alle repositorier. Kun til erklærede falske positiver (f.eks. et eget tokenformat, der matcher en regels mønster, men ikke er et rigtigt secret).

En begrundelse for tilsidesættelsen er påkrævet (fritekst). Den skrives i revisionsloggen.

Udvikleren skal pushe igen, når en tilsidesættelse er givet. Tilsidesættelsen accepterer ikke det afviste push med tilbagevirkende kraft.

Egen tilladelsesliste

Vil du dæmpe kendte falske positiver i et bestemt repository (testfixtures, eksempelnøgler i dokumentation, bevidst offentlige legitimationsoplysninger), så tilføj en .gitleaks.toml i repoets rod:

[extend]
useDefault = true

[[allowlists]]
description = "Test fixture AWS keys"
paths = ["tests/fixtures/.*", "docs/examples/.*"]

[[allowlists]]
description = "Example key in README"
regexes = ["AKIAIOSFODNN7EXAMPLE"]

Tilladelseslisten evalueres pr. repo i pre-receive-hooken. Den tilsidesætter ikke organisationens push-beskyttelse for mønstre, der ikke står på listen.

Tjek af pull requests: kun nye fund blokerer

Tjekkene for afhængigheder (fremforge/dep-scan), SAST (fremforge/sast), licenser (fremforge/license-scan), secrets (fremforge/secret-scan) og images (fremforge/image-scan) scanner hele repositoryet, men hvert af dem afviser kun en pull request på fund, som pull requesten selv tilføjer. Et fund, som branchen, den merges ind i, allerede har, blokerer ikke, så en pull request, der ikke ændrer noget sårbart, kan merges i et repository med åbne fund. Status lyder så for eksempel No new findings at or above critical; 8 already on main.

På en pull request kan SAST nøjes med at scanne de ændrede filer. OpenGreps regler virker inden for én fil, så en pull request kan ikke skabe et SAST-fund i en fil, den ikke har ændret, og en scanning af kun de ændrede filer finder alle fund, pull requesten kan indføre. Statussen siger det så: No new per-file SAST findings in the 3 changed files; not a full-repo scan. Et grønt tjek betyder præcis det, ikke at repositoryet er rent. Standardbranchen scannes altid fuldt ud.

fremforge sammenligner pull requestens fund med den seneste scanning af den branch, foretaget af den samme scanner. Et fund er det samme, når:

TjekSamme fund, når
Afhængighederøkosystem, pakke og advisory stemmer overens. At løfte en pakke til en version, der stadig har den samme advisory, er ikke nyt; en ny advisory er
SASTreglen, filen og den matchede kode stemmer overens. Et fund, der kun er flyttet til en anden linje, er ikke nyt
Licenserøkosystem, pakke og licens stemmer overens
Secretsreglen og de matchede linjer stemmer overens, sammenlignet med en nøglebaseret hash, som scanneren beregner. Selve secretet gemmes eller sendes aldrig. Et secret, der kun er flyttet til en anden linje, er ikke nyt
Imagesadvisory, pakke og fil stemmer overens
  • Kopier tæller: en anden forekomst af et fund, som branchen har én gang, er ny.
  • Alt, hvad der i forvejen afgør, om et fund blokerer, gælder stadig først: blokeringsalvorligheden, afvisninger, undtagelser og licenspolitikken. En ny ondsindet pakke eller kendt udnyttet sårbarhed blokerer altid, uanset om din organisation har valgt, at ikke-nåbare fund ikke blokerer.
  • Eksisterende fund skjules ikke. De står i pull requestens kommentar og under Sikkerhed › Fund, tæller med i din SLA og giver varsler som før.

Branchen scannes efter et push til din standardbranch, højst en gang i timen, og det nyeste push vinder. Et fund, der er nået ind på branchen siden dens seneste scanning, tæller derfor stadig som pull requestens indtil næste scanning; et nyt fund forveksles aldrig med et eksisterende. Er der endnu ingen scanning af branchen, blokerer alle fund som før, og pull requestens scanning beder om en. Når branchens første scanning er registreret, scanner fremforge af sig selv igen de åbne pull requests mod den, hvis tjek er fejlet i mellemtiden (højst 20 pr. repository, de senest opdaterede, pr. tjek), så de bliver grønne eller kun forbliver røde på det, de tilføjer, uden en ny kørsel eller et nyt push. En pull request mod en anden branch end din standardbranch tæller altid alle fund.

Scanning af afhængigheder

osv-scanner tjekker hver pull request, og standardbranchen efter hvert push, mod OSV’s database over advisories. Den læser lockfiler og manifester offline uden at opløse afhængigheder og sætter commit-statussen fremforge/dep-scan og en kommentar på pull requesten. Fund vises under Sikkerhed › Fund › Afhængigheder.

Indstillinger, og hvad der blokerer en merge

Under Sikkerhed › Fund › Afhængigheder kan en ejer slå scanning af afhængigheder fra for organisationen og sætte blokeringsalvorligheden: den laveste alvorlighed, der får fremforge/dep-scan til at fejle. Standarden er critical. På en pull request blokerer kun fund, som pull requesten tilføjer. Om et fejlende tjek faktisk blokerer merge, afhænger af tjekkets tilstand (enforce, audit eller off) under Sikkerhed › Prioritér › Pull request-tjek, og af, at tjekket er påkrævet af branch-beskyttelsen.

For at forhindre et fund i at blokere skal du rette det eller registrere en undtagelse. En organisation kan også vælge, at fund, der ikke er nåbare, ikke blokerer. Det valg dækker aldrig ondsindede pakker eller kendt udnyttede sårbarheder.

Pull requests med rettelser

To ting åbner pull requests med rettelser til sårbare afhængigheder:

  • Sikkerhedsrettelser: Åbn rettelses-PR på et fund (eller den automatiske politik) åbner én pull request pr. pakke til den laveste version, der retter alle åbne advisories. Se Sikkerhedsrettelser.
  • Opdateringer af afhængigheder: Renovates egne varsler om sårbarheder for organisationer, der er tilmeldt Opdateringer af afhængigheder. Hver tilmeldt organisations repositorier køres hver nat, og Kør nu starter en kørsel uden for rækkefølgen.

Understøttede manifester

De lockfiler og manifester, der læses, og hvilke økosystemer der får pull requests med rettelser og nåbarhed, står ét sted: Understøttede økosystemer.

Scanning af container-images

Trivy scanner hvert OCI-image, der pushes til fremforges pakkeregistry. Resultaterne vises under Sikkerhed › Fund › Container-images.

Trivy kører centralt uden noget at installere: trivy fs på hver pull request (statussen fremforge/image-scan, som kun blokerer på fund, som pull requesten tilføjer), trivy config som sit eget tjek (fremforge/iac-scan), og trivy image på hvert image i dit registry og hvert image, der hentes gennem dependency proxy’en, og scannes jævnligt igen. Fund af fejlkonfiguration fra trivy config har deres egen fane, Sikkerhed › Fund › IaC; se IaC-scanning.

Hvert fund indeholder:

FeltBeskrivelse
CVE-idf.eks. CVE-2024-12345 med link til NVD
AlvorlighedCRITICAL / HIGH / MEDIUM / LOW / UNKNOWN
Berørt pakkePakkenavn og installeret version
Rettet versionDen første version, der løser CVE’en, hvis den findes
EPSS-scoreSandsynlighed ifølge Exploit Prediction Scoring System

Scanning i dit eget workflow (valgfrit)

Der er intet at slå til: scanningerne ovenfor kører uden en workflowfil. Vil du også have, at dit eget build fejler, før det pusher et image, kan du selv køre Trivy i et workflow, for eksempel:

name: Image scan
on:
  push:
    branches: [main]
  pull_request:

jobs:
  trivy:
    runs-on: fremforge
    steps:
      - uses: actions/checkout@<full-40-char-sha>   # pin by SHA, never a tag or branch
      - name: Build image
        run: docker build -t ${{ github.repository }}:${{ github.sha }} .
      - name: Scan image
        run: |
          docker run --rm \
            -v /var/run/docker.sock:/var/run/docker.sock \
            aquasec/trivy:0.74.0@sha256:<digest> \
            image --exit-code 1 --severity HIGH,CRITICAL \
            ${{ github.repository }}:${{ github.sha }}

Sæt --severity til den tærskel, buildet skal fejle ved.

Hvorfor dette eksempel fastlåser med SHA og digest

En tidligere version af denne side brugte aquasecurity/trivy-action@master og actions/checkout@v4. Begge er foranderlige referencer, og 19. marts 2026 holdt den forskel op med at være teoretisk: en angriber omskrev trivy-action-tagget v0.69.4, så det pegede på en ondsindet release. Pipelines, der refererede til actionen med tag eller branch, hentede angriberens kode ved næste kørsel, og de legitimationsoplysninger, den høstede, blev brugt til at udgive to releases med bagdør af et andet projekt på PyPI.

Et tag er en pointer, som en anden kan flytte. En commit-SHA og et image-digest er ikke.

  • Actions: referér til den fulde commit-SHA på 40 tegn, ikke @v4 og aldrig @master. Renovate foreslår stadig opgraderinger; den omskriver SHA’en og dens kommentar sammen.
  • Scannere: foretræk værktøjets container-image fastlåst med digest frem for en wrapper-action. Færre bevægelige dele, og det, du har fastlåst, er det, der kører.
  • Spejl det, du afhænger af: fremforge kontakter intet upstream-registry fra en produktionssti; alle images kommer fra vores eget registry, fastlåst med digest.

Hændelsen krævede ingen handling hos fremforge: vi har aldrig brugt trivy-action, og vores egen Trivy er et image fastlåst med digest. Det kompromitterede projekt havde installeret Trivy fra apt uden fastlåst version. Fastlåsning er uglamourøst, og det er den kontrol, der ville have stoppet det.

Generering af SBOM’er

Syft genererer CycloneDX 1.6-SBOM’er for hvert container-image, der pushes til registryet, og for hvert release-tag, med en SPDX 2.3-tvilling fra samme kørsel (efter bedste evne; se SBOM’er). Uploads accepteres som CycloneDX 1.5–1.7 eller SPDX 2.x/3.x. Generering af SBOM’er er slået til som standard for alle organisationer; der er intet at slå til.

Download

Fra pakkeregistryets brugerflade: åbn imaget → fanen Attestations → Download SBOM.

Via API’et:

curl -H "Authorization: token <your-pat>" \
  https://frem.sh/_app/api/v1/orgs/<org>/findings/attestations \
  -o sbom.json

SBOM’en er CycloneDX-JSON og indeholder alle transitive afhængigheder med deres PURL-identifikatorer, licensudtryk og versionsintervaller.

SAST

OpenGrep kører statisk analyse centralt på hver pull request og på standardbranchen. Den er slået til som standard for alle organisationer. Fund sætter statussen fremforge/sast og en kommentar på pull requesten og vises under Sikkerhed › Fund › SAST. Sprog, regler og indstillinger står på siden SAST. Egne regler understøttes ikke.

Signerede commits

fremforge understøtter to måder at signere commits på, og begge verificeres direkte af Forgejos mærke “Verified” i webbrugerfladen:

  • Signering med SSH-nøgle (anbefalet standard) genbruger den SSH-nøgle, du allerede har registreret til git push. Intet nyt nøglemateriale at administrere, ingen tredjeparts underdatabehandler, ingen afhængighed af en transparenslog og ingen transit gennem amerikansk jurisdiktion. Det er fremforges kanoniske vej. (For nye organisationer oprettet efter 2026-05-22 er SSH-transport slået fra som standard; signering med SSH-nøgle virker stadig, uanset om du bruger SSH eller HTTPS til git push.)
  • Signering med GPG, klassisk OpenPGP-nøgle. Brug den, hvis din organisation allerede har en politik for administration af GPG-nøgler (smartcard, HSM, central nøgleserver).

Nøglefri commit-signering er ikke tilgængelig endnu. fremforge kører en selvhostet Sigstore-stak, en Fulcio-CA på sign.frem.sh og en TSA på tsa.frem.sh, som begge kører på T Cloud Public i eu-de med rod-CA’en i DEW KMS, men nøglefri commit-signering med gitsign virker endnu ikke hele vejen igennem mod den. Signér commits med en SSH- eller GPG-nøgle som beskrevet ovenfor; se nøglefri commit-signering. (Bemærk: provenance for builds og releases er en separat vej: fremforges SLSA-provenance signeres med en Ed25519-nøgle, som platformen har, IKKE gennem Fulcio. Se afsnittet om SLSA nedenfor.)

Signering med SSH-nøgle, opsætning

# Tell Git to use SSH for signing (Git ≥ 2.34)
git config --global gpg.format ssh
git config --global user.signingkey ~/.ssh/id_ed25519.pub
git config --global commit.gpgsign true
git config --global tag.gpgsign true

# (Optional) point Git at your local allowedSignersFile for verify
git config --global gpg.ssh.allowedSignersFile ~/.ssh/allowed_signers

Tilføj den tilsvarende SSH-nøgle til din fremforge-brugerprofil under Indstillinger → SSH / GPG nøgler → Tilføj nøgle (Forgejo accepterer den samme nøgle til både push og signering eller en separat nøgle kun til signering).

Ved næste git commit signerer Git med din SSH-nøgle. Forgejo verificerer signaturen mod organisationens allowedSignersFile (afledt automatisk af medlemmernes registrerede signeringsnøgler) og viser mærket “Verified” i webbrugerfladen.

Verificér

git log --show-signature HEAD~5..HEAD

Hver commit viser en linje Good "git" signature for <user>@<org>. Forgejos webbrugerflade viser et grønt mærke “Verified” ved siden af commit-hashen.

Signering med GPG, opsætning

Foretrækker du GPG, virker det almindelige forløb med git config --global commit.gpgsign true + user.signingkey <gpg-key-id> uændret; upload din offentlige nøgle under Indstillinger → SSH / GPG nøgler → Tilføj nøgle. Forgejo verificerer og viser mærket “Verified”.

Kræv signerede commits (organisationspolitik)

Håndhæv signerede commits på beskyttede branches med Commit-signering under Sikkerhed › Politikker › Repository-regler (se Branch-beskyttelse), eller pr. repo under Repository → Indstillinger → Grene → <branch> → Kræv underskrevne commits. Usignerede commits afvises ved push. Både SSH-nøgle- og GPG-signaturer opfylder kravet.

SLSA-provenance

Provenance for builds og releases genereres på serversiden af fremforge: der er ingen workflowfil i dine repoer, og der bruges ingen runner-minutter. Ved hver Forgejo-hændelse release.published og package beregner fremforges api en hash af hvert udgivet asset, bygger et in-toto Statement pakket ind i en DSSE-konvolut, signerer det med platformens builder-nøgle, gemmer attesteringen i lager i EU, afgrænset til din tenant, og uploader konvolutten tilbage ved siden af assettet som <asset>.intoto.jsonl. Den vises også i konsollen under Sikkerhed › Komponenter › Build-attesteringer.

Den selvstændige workflowskabelon slsa-provenance.yaml, som kunderne tidligere skulle kalde fra deres build-pipelines, blev udfaset 2026-06-16: en gennemgang af hele flåden fandt ingen, der kaldte den, og provenance udløses nu automatisk på serversiden uden noget at sætte op hos kunden.

EU-suveræn fra starten. Signeringsnøglerne, trust root’en, certifikatudstederen og lageret ligger alle i fremforges T Cloud Public-konto (eu-de). Der er ingen offentlig Sigstore, ingen Rekor og intet opslag i tuf-repo-cdn.sigstore.dev nogen steder i verifikationsvejen.

To signaturer, begge på hver attestering. Den primære er en Ed25519-nøgle, som platformen har, og det er den, opskriften under Verificér nedenfor tjekker: almindelig curl / jq / openssl / python3, intet andet. Derudover signeres hver attestering nøglefrit mod fremforges selvhostede Sigstore: et kortlivet Fulcio-certifikat, hvis SAN er buildkildens identitet, tidsstemplet af fremforges RFC3161-TSA. Begge er beskrevet i trust root’en, der indeholder fulcio_root_ca_pem, tsa_cert_chain_pem, certificate_oidc_issuer og certificate_identity_pattern, så den nøglefri signatur også kan verificeres offline.

Det nøglefri certifikat navngiver fremforges builder-udsteder siden 2026-11-08. Fulcio udsteder det på et OIDC-token fra https://frem.sh/_app/builder/oidc, en udsteder hvis signeringsnøgler kun findes inde i fremforges api, og som intet CI-job kan få et token fra. Et build-trin kan derfor ikke skaffe sig et certifikat, der kan gå for platformens signatur. Det gælder provenance for alle organisationer. Bundter signeret før 2026-11-08 kl. 05:53:53 UTC navngiver i stedet runner-udstederen https://frem.sh/_app/runner/oidc, som kunders CI-jobs også får tokens fra. Trust root’en angiver den under keyless.previous_certificate_oidc_issuers med det tidspunkt som valid_to. Godkend den kun for et bundt, hvis RFC3161-tidsstempel ligger før valid_to, og kun med det samme certificate_identity_pattern, som afviser den workflow-sti-identitet, et kundejobs certifikat bærer.

Den nøglefri signatur registreres ikke i Rekor eller nogen anden signaturlog (trust root’ens keyless.transparency_log siger none), så den valideres i stedet mod RFC3161-tidsstemplet (cosign --use-signed-timestamps --insecure-ignore-tlog). Selve attesteringen logges: SHA-256 af hver konvolut er et blad i fremforges egen append-only transparenslog på log.frem.sh, medsigneret af ét eksternt vidne. Hvad det giver dig, og hvad det ikke giver dig, står i §Uafhængig verificerbarhed.

(Nøglefri commit-signering på den samme selvhostede CA er ikke tilgængelig endnu; se nøglefri commit-signering.)

Trust root: https://www.frem.sh/.well-known/slsa-trust-root.json, en lille JSON-fil, der lister builderens offentlige nøgler. Formatet er specifikt for fremforge:

{
  "trusted_keys": [
    {
      "kid": "fremforge-slsa-builder-v1",
      "alg": "ed25519",
      "pem": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----",
      "valid_from": "2026-05-17T00:00:00Z",
      "valid_to": "2026-09-12T00:00:00Z",
      "builder_id": "https://frem.sh/runner-controller/v1"
    },
    {
      "kid": "fremforge-slsa-builder-v2",
      "alg": "ed25519",
      "pem": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----",
      "valid_from": "2026-09-12T00:00:00Z",
      "builder_id": "https://frem.sh/runner-controller/v1"
    }
  ]
}

fremforge-slsa-builder-v2 er den aktive signeringsnøgle siden nøgleskiftet 2026-09-12. fremforge-slsa-builder-v1 signerede alt før da og bevares kun til verifikation: dens valid_to er det øjeblik, den holdt op med at signere, ikke en udløbsdato for de signaturer, den lavede. Verificér altid mod den nøgle, som keyid i den konvolut, du har, nævner, aldrig mod et fast navn.

Fastlås filen (eller en kopi af den) i din CI for at låse tilliden fast i verifikationsperioden. Nøgleskift annonceres 30 dage i forvejen efter trust-sidens §regel om varsling af underdatabehandlere; en signatur holder kun op med at kunne verificeres, hvis dens nøgle fjernes fra trusted_keys.

Konvoluttens og statementets form (DSSE-konvolut, der indpakker et in-toto Statement):

FeltVærdi
konvoluttens payloadTypeapplication/vnd.in-toto+json
konvoluttens signatures[0].keyidfremforge-slsa-builder-v2 for alt signeret siden 2026-09-12, fremforge-slsa-builder-v1 før (svarer til en trusted_keys[].kid i trust root’en)
Statement _typehttps://in-toto.io/Statement/v1
Statement predicateTypehttps://slsa.dev/provenance/v1
predicate.buildDefinition.buildTypeHvilken vej der frembragte statementet; se §Hvad hver buildType betyder. En af …/buildtypes/forgejo-action-run/v1, …/container-image/v1, …/forgejo-release/v1, …/forgejo-package/v1
predicate.buildDefinition.internalParameters.run_idDen Actions-kørsel, der frembragte artefaktet. Findes på build-provenance; mangler på et publiceringsstatement
predicate.buildDefinition.internalParameters.attestation_kindpublication, når statementet observerer udgivne bytes i stedet for et build. Mangler på build-provenance
predicate.buildDefinition.externalParameters.repository<org>/<repo>
predicate.buildDefinition.externalParameters.refGit-ref’en (f.eks. refs/tags/v1.2.3)
predicate.runDetails.builder.idhttps://frem.sh/runner-controller/v1 (styret af serveren og tvangsoverskrevet ved signering, så en kompromitteret runner ikke kan forfalske den)
subject[].name / subject[].digest.sha256Assettets filnavn og den SHA-256, fremforge har beregnet for det

Hvad det præcist er. Indtil 2026-09-11 hævdede dette afsnit SLSA Build L2. Vi udledte det igen mod v1.0-specifikationen, påstanden holdt ikke, og vi trak den tilbage. Det hul, der gjorde den usand, provenance, der ikke beskrev noget build, blev lukket 2026-09-12. Vi angiver stadig ikke et niveau, af en grund, der står sidst i afsnittet.

To forskellige statements signeres nu med den samme nøgle, og du kan skelne dem alene ud fra konvolutten.

Hvad hver buildType betyder

buildType slutter medHvad den hævderNævner en build-kørsel?
forgejo-action-run/v1fremforges kontrolplan læste kørslens uploadede artefakter fra buildplatformens egne registreringer, hentede bytes og beregnede deres hashJa, run_id
container-image/v1Et image, der er pushet af en kørsel, attesteret med kørslens identitet fra et kortlivet OIDC-token, som fremforge udstedte til det jobJa, run_id, kryptografisk bundet
forgejo-release/v1Et udgivet release-asset. Arver et builds commit, når præcis det samme digest allerede er attesteret som bygget; se nedenforKun når de er koblet
forgejo-package/v1En pakkeversion, der dukkede op i registryetNej

Build-provenance (de to første) beskriver, hvordan artefaktet blev frembragt: den nævner kørslen, workflowet og committen, og kørslens identitet kommer fra platformen, ikke fra noget, buildet har påstået om sig selv.

Publiceringsattestering (de to sidste, ukoblet) siger noget snævrere og siger det eksplicit: attestation_kind: publication. Det betyder: fremforge har observeret, at præcis dette indhold, byte for byte, blev udgivet her, og signerer den observation med en nøgle, som buildet ikke kan nå. Det er en reel egenskab, der kan tjekkes. Det er ikke et udsagn om, hvordan artefaktet blev bygget, og det foregiver ikke længere at være det: hvor ingen kildecommit kendes, er commit_sha den bogstavelige værdi no-source-commit i stedet for en værdi, der ligner en Git-commit. Ser du 40 hex-tegn der, er det en rigtig commit.

Koblingen via digest. Et release-asset, hvis sha256 allerede har en build-attestering, arver det builds commit, og statementet peger på den (source_commit_from: digest-join plus build-attesteringens id og objektnøgle). Koblingen er artefaktets digest, så “samme bytes” er en kryptografisk kendsgerning og ikke en navnekonvention: at udgive et artefakt senere ændrer ikke, hvad der frembragte det. En eksplicit target_commitish på releasen vinder altid over udledningen.

Platformens egenskaber bag alt dette:

  • Signeringsjobbet starter rent. Et job, der signerer provenance eller attesteringer, udgiver en release eller bygger eller pusher et container-image, starter altid på en ny, flygtig ECS-VM, som ikke har kørt noget andet job, med et ENI pr. VM og en runner-legitimation, der dør med jobbet, så et tidligere job ikke kan efterlade noget til det; se §Model for kerneisolering.
  • Signeringsnøglen er uden for buildets rækkevidde. Den ligger i api’et, aldrig på en runner, og builder-identiteten overskrives på serversiden ved signering, så et kompromitteret build ikke kan forfalske den.
  • Intet at sætte op hos kunden for de webhook-drevne veje. Intet at kalde fra et workflow og ingen runner-minutter brugt.

Hvorfor vi stadig ikke angiver et SLSA-niveau. De to isoleringsegenskaber er dem, SLSA v1.0 Build L3 kræver, og build-provenance beskriver nu et faktisk build. Vi vil hellere have, at du læser tabellen ovenfor og selv vurderer, hvad den er værd, end at du accepterer et tal fra den part, der bliver revideret. (Hermetiske builds, reproducerbare artefakter og transparenslogs nævnes nogle gange som krav til L3. Det er de ikke: det var begreber fra SLSA v0.1 L4, og de optræder på intet niveau i v1.0, der lister dem under fremtidige retninger.)

Gennemsigtighed er en anden akse end noget niveau. Digestet for hver attestering registreres i transparensloggen; hvad det beviser, og hvad det endnu ikke beviser, står i §Uafhængig verificerbarhed.

Verificér

Brug ikke upstreams slsa-verifier verify-artifact --trusted-root. Det værktøj har intet flag --trusted-root på verify-artifact og kan hverken læse fremforges egen trust root-JSON eller en DSSE-konvolut med en ren Ed25519-signatur; det forventer et bundt i Sigstore-stil. fremforges provenance er en almindelig DSSE-konvolut signeret med Ed25519, så du verificerer den direkte med curl / jq / openssl / python3, som alle følger med distributionerne som standard, uden fremforge-værktøjer.

Verifikationen består af tre uafhængige tjek: DSSE-signaturen er gyldig for builderens offentliggjorte nøgle, assettets SHA-256 svarer til det, der blev signeret, og statementet nævner det rigtige repo og den rigtige builder.

1. Hent trust root’en, og udtræk builderens offentlige nøgle

curl -sSfL https://www.frem.sh/.well-known/slsa-trust-root.json -o trust-root.json
jq -r '.trusted_keys[] | select(.kid=="fremforge-slsa-builder-v2") | .pem' \
  trust-root.json > builder.pub

For en attestering signeret før 2026-09-12 skal du i stedet vælge fremforge-slsa-builder-v1. jq -r '.signatures[0].keyid' <asset>.intoto.jsonl fortæller dig hvilken.

2. Verificér DSSE-signaturen, assettets digest og statementets felter

Kør fra en mappe, der indeholder det downloadede asset og dets konvolut <asset>.intoto.jsonl. Sæt ASSET til assettets filnavn:

ASSET=myapp python3 - <<'PY'
import base64, json, hashlib, os, subprocess, sys, pathlib

asset = os.environ["ASSET"]
env = json.loads(pathlib.Path(f"{asset}.intoto.jsonl").read_text().strip())

payload_type = env["payloadType"]                 # application/vnd.in-toto+json
payload      = base64.b64decode(env["payload"])

# Reconstruct the DSSE pre-authentication encoding (DSSEv1):
#   "DSSEv1 " + LEN(type) + " " + type + " " + LEN(payload) + " " + payload
# where LEN is the utf-8 byte length and separators are single ASCII spaces.
pae = (
    b"DSSEv1 "
    + str(len(payload_type.encode())).encode() + b" "
    + payload_type.encode() + b" "
    + str(len(payload)).encode() + b" "
    + payload
)
pathlib.Path("pae.bin").write_bytes(pae)
pathlib.Path("sig.bin").write_bytes(base64.b64decode(env["signatures"][0]["sig"]))

# Ed25519 ("pure" EdDSA — no pre-hash) verify with openssl. Feed the raw PAE.
r = subprocess.run(
    ["openssl", "pkeyutl", "-verify", "-pubin", "-inkey", "builder.pub",
     "-rawin", "-in", "pae.bin", "-sigfile", "sig.bin"],
    capture_output=True, text=True,
)
if r.returncode != 0 or "Signature Verified Successfully" not in r.stdout:
    print("DSSE signature FAILED:", r.stdout, r.stderr, file=sys.stderr); sys.exit(1)
print("DSSE signature: OK")

stmt = json.loads(payload)

# The signed subject digest must match the asset bytes on disk.
want = next((s["digest"]["sha256"] for s in stmt["subject"] if s["name"] == asset), None)
got  = hashlib.sha256(pathlib.Path(asset).read_bytes()).hexdigest()
if want is None:
    print(f"asset {asset} not found among signed subjects", file=sys.stderr); sys.exit(1)
if want != got:
    print(f"digest mismatch: signed={want} actual={got}", file=sys.stderr); sys.exit(1)
print(f"asset digest: OK ({got})")

# Sanity-check the builder identity and predicate type.
builder = stmt["predicate"]["runDetails"]["builder"]["id"]
if builder != "https://frem.sh/runner-controller/v1":
    print(f"unexpected builder.id: {builder}", file=sys.stderr); sys.exit(1)
if stmt["predicateType"] != "https://slsa.dev/provenance/v1":
    print(f"unexpected predicateType: {stmt['predicateType']}", file=sys.stderr); sys.exit(1)
print("builder.id + predicateType: OK")
PY

Skriver alle tre tjek OK, er assettet præcis de bytes, fremforge har attesteret, konvolutten er signeret med builderens offentliggjorte nøgle, og statementet nævner fremforges builder. Verifikationen fejler (exitkode forskellig fra nul), hvis signaturen ikke kan valideres mod builder.pub (manipuleret konvolut eller forkert eller udskiftet nøgle), hvis assettets SHA-256 ikke svarer til det signerede subject (manipuleret asset), eller hvis builder.id / predicateType ikke stemmer.

keyid i konvolutten (fremforge-slsa-builder-v2 for alt signeret siden 2026-09-12) skal svare til den kid, du valgte fra trust root’en; en konvolut, der tjekkes mod den anden nøgle, fejler med DSSE signature FAILED. Skifter fremforge signeringsnøglen, så hent trust root’en igen, og vælg den kid, konvolutten nævner.

Hvorfor ikke Sigstore ved lanceringen

Sigstores offentlige stak med Fulcio, Rekor og Trillian drives af OpenSSF (Linux Foundation), en organisation registreret i USA. At bruge den ville sende metadata om hvert build til infrastruktur hostet i USA, hvilket er uforeneligt med fremforges tilsagn om kun underdatabehandlere i EU i DPA bilag B. fremforge kører sin egen selvhostede Fulcio og TSA på sign.frem.sh / tsa.frem.sh på T Cloud Public eu-de, som siden 2026-06-21 bruges som den anden signatur på build-provenance. Nøglefri commit-signering mod dem er ikke tilgængelig endnu (se nøglefri commit-signering). Det, der bevidst mangler, er den offentlige Sigstore-installation og Rekor.

Hver attesterings SHA-256 hash-kædes også ind i platformens revisionslog, hvis ankre ligger i en OBS Object Lock i COMPLIANCE-tilstand i 3 år. Det er en nyttig intern kontrol, og den er ikke en erstatning for en transparenslog, så vi beskriver den ikke længere som tilsvarende manipulationssikring. To grunde, begge konkrete: ankeret kan ikke læses af dig, så det kan ikke indgå i din verifikation; og OBS Object Lock beskytter hver objekt-version: målt 2026-08-14 kan en nyere version skygge for en låst nøgle, og en slettemarkør skjuler den for almindelige læsninger, og begge dele er handlinger, operatøren har adgang til. Se §Uafhængig verificerbarhed for, hvad tillidsmodellen giver dig, og hvad den ikke giver dig.

Uforanderlige releases

Ejere af organisationen kan gøre alle releases frosne ved udgivelse: deres tag, mål-commit og assets kan aldrig ændres igen (titel og noter kan stadig redigeres), en slettet releases tagnavn kan aldrig genbruges, og container-tags kan også fryses (tags som v1.2.3 eller alle undtagen en liste). Hver uforanderlig release får ét signeret in-toto-release-statement, der nævner hvert asset ved SHA-256 og tagget ved commit, og som kan tjekkes med fremforge release verify. Se Uforanderlige releases og release-attestering.

Uafhængig verificerbarhed

At flytte et repo, en runner og et artefaktlager til Tyskland svarer på, hvor dataene ligger. Det svarer ikke i sig selv på, om revisionssporet kan stoles på uden at stole på den operatør, der har frembragt det. Det er forskellige egenskaber, og vi vil hellere være tydelige om, hvilken af dem vi leverer i dag.

Hvad du får uden at stole på os på verifikationstidspunktet. Attesteringen følger med artefaktet, <asset>.intoto.jsonl og ved siden af <asset>.sigstore.json, så du har begge halvdele. Builderens offentlige nøgle, Fulcio-rod-CA’en og TSA-kæden ligger alle i en statisk trust root, som du opfordres til at fastlåse en kopi af i din egen CI. Verifikationen genberegner artefaktets digest og tjekker signaturerne lokalt med curl / jq / openssl / python3. Intet fremforge-API kontaktes, og der kræves ingen fremforge-værktøjer. Når du har fastlåst roden, kan en senere ændring hos os ikke med tilbagevirkende kraft ændre, hvad din pipeline accepterer.

Hvad du ikke får, sagt ligeud. Der er nu en tilføjelseslog, en transparenslog for provenance-attesteringer på log.frem.sh, men den giver dig endnu ikke den egenskab, man som regel mener med ordet. Konkret:

  • Loggen gør det umuligt for os at omskrive historikken i stilhed: har du et inklusionsbevis, og ændrer eller fjerner vi senere din attestering, holder dit bevis op med at kunne verificeres, og du kan påvise modsigelsen. Det er reelt, og det er nyt.
  • Den er delvist modstandsdygtig over for split-view fra 16. september 2026. Ét uafhængigt vidne, witness.stagemole.eu, drevet af Mullvad VPN AB, medsignerer hvert checkpoint, så der nu er en tredjepart, der ville opdage, hvis vi signerede noget usædvanligt. Det er den egenskab, punktet altid har handlet om, og den mangler ikke længere. Ét vidne er ikke et quorum: det gør det dyrere at vise dig et andet træ end alle andre, men kan ikke opdage samarbejde mellem loggen og dens eneste vidne, og operatøren kalder instansen staging. Bemærk også, at de eneste EU-vidner i produktionskvalitet, Glasklar Teknik, Mullvad VPN og Tillitis, har samme moderselskab, Amagicom AB; flere af dem ville give tilgængelighed, ikke uafhængighed.
  • RFC3161-tidsstemplet, der delvist træder i stedet for en log, udstedes af vores TSA, og trust root’en distribueres fra vores domæne. Fastlåsning tager hånd om det sidste for alle, der fastlåser ved onboarding; det tager ikke hånd om tilliden ved første kontakt.
  • Vores interne anker for revisionskæden kan ikke læses af dig, så det kan ikke indgå i din verifikation.

Er det operatøren, du skal kunne holde ansvarlig, hvilket er det rigtige spørgsmål for forsvar og kritisk infrastruktur, så er det, der lukker hullet, en transparenslog med eksterne vidner, en uafhængig tidsstemplingsmyndighed og reproducerbare builds, som du kan genbygge og sammenligne uden vores medvirken. Den første af de tre findes nu og er beskrevet ovenfor med sine begrænsninger; tidsstemplingsmyndigheden og de reproducerbare builds findes ikke. Bemærk, at en selvhostet log ikke ville lukke det: en log, vi driver, er en log, vi kontrollerer. Uafhængig verificerbarhed kræver en ekstern part, og den ærlige afvejning er, at det at gøre det via den offentlige Sigstore-log ville offentliggøre artefakt-digests, repo-identiteter og tidspunkter for releases uden for EU.

Vi vil hellere afgrænse det ud fra et reelt krav end gætte på et. Er dette et krav i et udbud for dig, så fortæl os, hvilke af egenskaberne du har brug for og inden for hvilken tidsramme, så vender vi tilbage med en dateret plan i stedet for en påstand.

Model for kerneisolering

Job kører på flygtige ECS-virtuelle maskiner på T Cloud Public i eu-de. En VM kører ét job ad gangen, aldrig to samtidig. Efter et job kan den kun køre et senere job, hvis begge har samme isolationsnøgle: samme repository (og dermed organisation), commit, workflow-kørsel og forsøg, udløsende hændelse, tillidsklasse (en pull request fra en fork er en anden klasse end et push), udrulningsmiljø og sæt af legitimationsoplysninger. Et job, der er rettet mod et udrulningsmiljø, får en scoped secret eller en udrulningslegitimation (herunder en cloud-legitimation via workflow-OIDC-føderation), bygger eller pusher et container-image, signerer provenance eller attesteringer eller udgiver en release, får altid en ny VM, og det samme gør et job, platformen ikke kan klassificere. Genbrug er slået til som standard; organisationens ejere kan slå det fra, og så får hvert job en ny VM. Mellem job fjernes jobcontaineren, arbejdsområdet, midlertidige filer og legitimationsoplysninger, og der udstedes en ny runner-legitimation, men VM-imaget gendannes ikke, så betragt job, der deler en isolationsnøgle, som ét tillidsdomæne. Den kontraktlige forpligtelse står i databehandleraftalen bilag A.5 (version 1.76, gældende fra 2026-12-03); se Sikkerhedsmodel for hostede runners for detaljerne. Isoleringsegenskaberne:

EgenskabDetaljer
Deling af kerneIngen kerne deles mellem commits, repositorier eller organisationer. Efterfølgende job med samme isolationsnøgle kan dele en VM, ét ad gangen, så betragt dem som ét tillidsdomæne
PersistensVM’en destrueres, når der ikke kommer flere job med dens isolationsnøgle; ingen filsystemtilstand overlever til en anden commit eller en anden organisation. Tilstand kan føres videre mellem job, der deler en isolationsnøgle, fordi et job er root på VM’en via Docker-socketten, og værktøjs- og buildcaches bliver liggende. Et udrulningsjob, eller et job, der får en udrulningslegitimation, starter altid på en ny VM, så et build, der kører kode fra tredjepartsafhængigheder, ikke kan efterlade noget til det
Adgang til platformens APIVM’en har ingen IAM-agency tilknyttet; identiteten fra metadata har ingen roller, så OTC-API’et kan ikke nås indefra
NetværkSecurity Group pr. VM med en tilladelsesliste kun for udgående trafik; runners kan ikke modtage indgående forbindelser
T Cloud Public-metadataBlokeret af en udgående proxy mod SSRF; runner-kode kan ikke nå instansens metadata-endpoint med privilegeret scope

Se CI-runners for den fulde isoleringsspecifikation og registrering af egne runners.

Isolering af tenants

Hver fremforge-tenant er et navnerum med sin egen nøgle på platformen. Isoleringskæden går fra URL’en gennem middleware, databaselaget, lagerlaget og revisionskæden.

LagMekanismeHvad der forhindrer adgang på tværs af tenants
URL-routingMiddleware for /<slug>/_admin/* indlæser tenanten igen ud fra slug’en ved hver anmodningEn bruger med en session for organisation A, der indsætter organisation B’s URL, afvises ved tjekket af medlemskab, ikke ved en forældet cookie
Tjek af medlemskabOpslag i Forgejos Owners-team mod slug’en, verificeret ved hver anmodningapi’et stoler aldrig på en indgående påstand om, hvilke organisationer brugeren tilhører
DatabaseHver tabel med tenant-nøgle har en fremmednøgle tenant_id; hver læsning OG hver skrivning filtrerer på denSELECT / UPDATE / DELETE uden tenant_id er strukturelt umuligt i de revisionsmarkerede stier
Signerede tokensHver kortlivet signeret URL (magisk link til fakturering, fortrydelse af opsigelse, OIDC-state) har tenant-id’et i sin payload; verifikationen krydstjekker mod URL’ens slugEt token udstedt til tenant A afvises, hvis det genafspilles mod tenant B’s URL
Lager (OBS)SBOM’er, attesteringer og revisionslogobjekter har alle nøglen <artifact>/<tenant_id>/...; udstedelse af signerede URL’er validerer tenant.id === row.tenant_id igen før udstedelseEn direkte OBS-presigned URL bundet til tenant A kan ikke omskrives til at læse tenant B
RevisionskædeManipulationssikret hashkæde med nøgle pr. tenant; én tenants tilføjelser ændrer aldrig en andens kædehovedEt brud i tenant A’s kæde (f.eks. et forsøg på at slette med tilbagevirkende kraft) påvirker ikke integriteten af tenant B’s kæde
OperatøradgangNår medarbejdere (fremverk) ser kundedata, logges det i kundens revisionskæde som en operatørhandling; tenant-administratorer kan se operatørbesøg i deres egen revisionslogIngen skjult adgang for medarbejdere til kundedata

Forsinkelse ved fjernelse fra Owners-teamet

api’et cacher en kundes medlemskab af Forgejos Owners-team i op til 5 minutter for at holde sideindlæsninger under 50 ms (alternativet er et kald til Forgejos API ved hver anmodning, hvilket ville gøre hver side 100-200 ms langsommere). Afvejningen:

  • Når du tilføjer nogen til Owners i Forgejo, får vedkommende administratoradgang inden for 5 minutter.
  • Når du fjerner nogen fra Owners i Forgejo, mister vedkommende administratoradgang inden for 5 minutter, ikke med det samme.

For de fleste handlinger er forsinkelsen acceptabel: en tidligere ejer kan ikke oprette nye ressourcer i Forgejo (Forgejos eget tjek sker med det samme), og enhver privilegeret handling via fremforges administrationsflade registreres i tenantens revisionslog med aktørens brugernavn, så aktivitet efter fjernelsen stadig kan henføres.

Har du brug for øjeblikkelig fjernelse (f.eks. som led i håndteringen af en hændelse efter kompromitterede legitimationsoplysninger), kan operatøren på vagt efter anmodning sætte cachens TTL til nul for din tenant: opret en sag på support@frem.sh med emnepræfikset [urgent-revocation] og brugernavn samt tenant-slug. Standard-SLA: under 15 minutter i arbejdstiden, under 60 minutter uden for. Den samme virkning opnås ved at afslutte brugerens Forgejo-session (Forgejo Owner → User profile → Sign out), hvilket ugyldiggør den sessionscookie, api’et læser; der kræves ingen handling hos fremforge.

Platformens sikkerhedstilsagn

CVE-alvorlighedSLA for patch (fra upstreams rettede release)
Kritisk (CVSS ≥ 9,0)48 timer
Høj (7,0-8,9)72 timer
Middel (4,0-6,9)7 dage
LavNæste planlagte vedligeholdelsesvindue

SLA’en for patches er offentliggjort kontraktligt og citeres ordret i DPA’ens sikkerhedsbilag.

Revisionslogens integritet: manipulationssikret hashkæde forankret i T Cloud Public OBS-WORM-lager hvert 2. minut; integritetstjek med FunctionGraph hver time; brud på kæden udløser et kald til vagten.

Fejlfinding

Pushet er blokeret, men jeg kan ikke finde secretet i diff’en.

Secretet kan ligge i en fil, der er ændret, men hvis fulde indhold ikke er synligt i den almindelige diff. Kør Gitleaks lokalt for at finde den præcise placering:

pip install gitleaks   # or brew install gitleaks
gitleaks detect --source . --verbose

Ingen pull request med en rettelse for en kendt CVE.

Tjek, at pakkens økosystem og manifest får pull requests med rettelser (Understøttede økosystemer), og at advisoryen har en rettet version. Renovate kører hver nat for en tilmeldt organisation; Sikkerhed › Ret › Opdateringer af afhængigheder → Kør nu starter en kørsel uden for rækkefølgen, og Åbn rettelses-PR på fundet beder om en sikkerhedsrettelse med det samme. Se Når der ikke åbnes en pull request.

Download af SBOM giver 404.

SBOM’er genereres kun for images, der er pushet, efter generering af SBOM’er blev slået til. Images, der er pushet før, har ingen SBOM. Push et nyt tag for at generere en.

SSH-signering fejler med ssh-keygen: gpg failed to sign the data.

Sørg for, at git config gpg.format er sat til ssh (ikke standarden openpgp), og at user.signingkey peger på en fil med en offentlig nøgle. På macOS skal du også sikre dig, at ssh-keygen er på $PATH (Apples medfølgende ssh-keygen virker; har du installeret OpenSSH fra Homebrew, så sørg for, at den har forrang på den rigtige måde).

Krydshenvisninger