Gå til hovedindhold

Revisionslog

Revisionsloggen registrerer hver administrativ handling på din tenant: hvem gjorde hvad, hvornår, fra hvilken IP og på hvilken ressource. Opbevaringen sker i to niveauer: et søgbart varmt niveau med hele hændelsens indhold (actor, action, fields_json) i 90 / 180 / 365 / 730 dage — som standard 90 (standardplan) eller 365 (enterprise-planer) og konfigurerbart pr. tenant under Godkendelsespolitik → Opbevaring af revisionslog — og et kryptografisk kædearkiv i 3 år i T Cloud Public OBS WORM, der bevarer kædens ankerobjekter, efter at indholdet i det varme niveau er blevet redigeret væk. Compliance-eksporter dækker det søgbare vindue.

Den kryptografiske chain of custody (ankerkæde, merkle-forpligtelser i OBS) er beskrevet i Integritet i revisionskæden.

Hvad der registreres

HændelsesklasseEksempler
IdentitetLogin, SSO step-up, nulstilling af MFA, SCIM-provisionering, rolleændring
RepositoryRepository oprettet, overført, arkiveret, slettet; branch protection ændret
SecretsSecret oprettet, roteret, slettet (kun navnet, aldrig værdien)
WebhooksDestination tilføjet, roteret, fjernet; levering afspillet igen
PolitikRegel for push-beskyttelse tilføjet eller tilsidesættelse anvendt; tilsidesættelse af malware-scanning; afvisning af SAST-fund
FaktureringPlanskift, opdateret betalingsmetode, ændret loft
DataeksportEksport sat i kø, hentet, udløbet

Bemærk, hvad der ikke er med: almindelige læsninger (clone, visning, åbning af filer). Revisionsloggen er en log over administrative handlinger, ikke en adgangslog. Undtagelsen er skrivebeskyttede revisorer, hvis læsninger af dine indstillinger registreres (se Revisorers aktivitet). Adgang til pakke- og container-registry’et (hver download, upload og sletning, med actor og klient-IP) står i den separate adgangslog for registry’et, som du kan læse via API’et, videresende til dit SIEM og få med i dataeksporten. Git clone og fetch logges endnu ikke pr. forespørgsel.

Hændelser for pakker og udgivelser

Publicering, tagging, sletning og afvisning af interne artefakter står i revisionsloggen, hashkædet som alle andre hændelser og i din SIEM-strøm. To visninger skriver dem:

  • Versionsvisningen, fra selve registry’et: en version dukkede op eller forsvandt.
  • Forespørgselsvisningen, fra upload-proxyen foran hver skrivning til registry’et: én hændelse pr. accepteret eller afvist skrivning, med jobbet bag et job-token og, for tags, hvad tagget pegede på før.
ActionHvornår
package.publishedEn pakkeversion dukkede op (dens første fil landede).
package.deletedEn pakkeversion og dens filer er væk.
package.upload.acceptedEn skrivning til registry’et lykkedes: en fil, en npm publish, endnu en fil i en eksisterende version, et container-manifest pushet via digest.
package.upload.refusedfremforge afviste en skrivning: malware, scanneren utilgængelig, for stor til at blive scannet, en gate for container-lag.
package.delete.acceptedEn sletning lykkedes (en fil, en version, et container-manifest via digest).
package.delete.refusedEn sletning blev afvist (bortset fra en registry-robots, nedenfor).
package.tag.createdEt container-tag eller npm dist-tag, der ikke fandtes, peger nu på en digest.
package.tag.movedEt container-tag peger nu på en anden digest. previous_digest er den, det pegede på før.
package.tag.setEt tag blev skrevet, og fremforge kunne ikke se, hvad det pegede på før, eller det pegede på den samme digest (unchanged: true). npm dist-tags er altid set.
package.tag.deletedEt tag blev slettet; digest er det, tagget pegede på.
package.immutable.refusedEn overskrivning af en publiceret version blev afvist (uforanderlige udgivelser); begge sha256-værdier.
registry_robot.delete_refusedEn registry-robot forsøgte at slette; robotter publicerer, men sletter aldrig.
package.files.recorded, package.files.removedEn versions filer med deres sha256 (organisationer med pakkepolitikker).
forgejo.release.*, forgejo.ref.create, forgejo.ref.deleteEn udgivelse publiceret, redigeret eller slettet (med dens id, mål, flag for kladde og pre-release samt assets); et git-tag eller en branch oprettet (med sin commit) eller slettet.

Hver pakkehændelse har:

FeltBetydning
org, package_type, package_name, package_version, fileHvad der blev skrevet. En forespørgsel nævner det, dens sti nævner; versionsvisningen nævner versionen.
digestsha256:<hex>: et container-manifests digest eller sha256 af en rå upload-body (filens egen sha256 for alle typer undtagen npm og Cargo, hvis upload-bodies pakker filen ind).
actor_kindhuman, robot (en registry-robot), job (et job-token fra Forgejo Actions), bot (en systembot i fremforge), system eller anonymous.
actor_login, actor_idHvem registry’et autentificerede.
job_repo, job_run_id, job_run_number, job_idFor et job-token: repositoryet og kørslen (/<owner>/<repo>/actions/runs/<job_run_number>).
decision, reasonVed en afvisning, eller en skrivning, som en gate i observationstilstand lod passere.
access_event_idDen tilsvarende række i registry’ets adgangslog, som også rummer klient-IP’en.

Hændelser fra forespørgselsvisningen findes fra 2026-10-08. Promovering mellem repositories er ikke et registry-begreb i fremforge, så der er ingen promoveringshændelse.

Adgang til pakker

Adgang pr. pakke og beskyttede navne skriver:

ActionHvornår
package_access.settings.updatedOrganisationens standard blev ændret (default_mode fra og til).
package_access.package.updatedEn pakkes adgangsindstilling blev oprettet eller ændret (mode, inherit_repo, changed).
package_access.package.removedEn pakkes indstilling og tildelinger blev fjernet (grants_removed).
package_access.grant.setEn tildeling til et team eller Actions blev tilføjet eller ændret (grantee_kind, grantee_name, permission, previous_permission).
package_access.grant.removedEn tildeling blev fjernet.
package_protection.rule.created, .updated, .deletedEn regel for beskyttede navne blev ændret (package_type, name_pattern, push, delete).
package_access.deniedEn forespørgsel blev afvist af adgang pr. pakke eller et beskyttet navn (access, needed, permission, reason og actor-felterne ovenfor). Højst én gang i timen for samme actor, pakke og adgang.
package_access.would_denyDet samme, mens fremforge kørte tjekket i observationstilstand og leverede forespørgslen.

Modelscanning

Modelscanning skriver:

ActionHvornår
security_policy.model_scan.updatedOrganisationens modelpolitik blev ændret (changed og diff med hver indstillings from og to).
security_policy.model_scan.dismissedEt fund blev afvist for én fil, eller afvisningen blev fornyet (sha256, verdict, reason, expires_at, replaced).
security_policy.model_scan.dismissal_revokedEn afvisning blev tilbagekaldt (sha256).

Et pull, som modelpolitikken afviser, er en registry.pull.blocked-hændelse med gate: model, se nedenfor.

Gates for container-pulls

Registry’ets image-gates skriver deres afgørelser i revisionsloggen, så de når dit SIEM som alle andre hændelser:

ActionHvornår
registry.pull.blockedEt container-pull blev afvist
registry.pull.would_blockEt pull blev leveret, som en gate ville have afvist: din blokeringshandling for image-scanning er warn, eller gaten kører i observationstilstand

Actor er system:registry-pull-gate. Felterne i fields er:

FeltBetydning
gateimage_scan (sårbarhedsfund på eller over din blokeringstærskel), image_malware (ondsindede pakker), registry_scan (et lag i imaget, som ClamAV fandt inficeret eller ikke kunne scanne), registry_blob (det samme for et lag, der hentes direkte via digest), signature (image-signaturer: reason er unsigned, untrusted eller invalid) eller model (modelscanning: reason er model-malicious, model-suspicious eller model-unscannable)
image, ref, digestImaget, det tag eller den digest, der blev bedt om, og den digest, der blev leveret
reasonHvad gaten fandt, for eksempel layer-infected eller image-malware
modeenforce, warn (din blokeringshandling) eller shadow (observationstilstand)
block_severity, finding_countKun image_scan: tærsklen og antallet af åbne fund på eller over den
window_startDen time, hændelsen dækker
previous_window_start, previous_window_countDen seneste tidligere time med en hændelse for samme nøgle, og hvor mange afgørelser den havde i alt; null for den første

Én hændelse pr. time. Et CI-job, der henter et blokeret image i en løkke, ville ellers fylde loggen. Derfor er der én hændelse pr. image-digest, gate og afgørelse pr. UTC-time, skrevet ved timens første afgørelse. Yderligere afgørelser i samme time tælles, og antallet rapporteres på den næste hændelse for samme nøgle som previous_window_count. En times antal når altså dit SIEM med den næste hændelse for den digest, ikke ved timens udløb; antallet for den sidste time med pulls bliver ikke sendt. En blocked og en would_block for samme digest, eller to forskellige gates, er separate nøgler.

En registry.pull.blocked-hændelse udløser også din alarm-webhook for security.pull.blocked, hvis du har abonneret på en. Hvert pull, tilladt eller ej, står i registry’ets adgangslog.

Et pull, hvis sårbarhedsvurdering en liste over patchede base-images har udskudt til det image, der bygges ud fra det, er ikke en afgørelse fra en image-gate. Det er hændelsen image_cve.deferred_patch_input; se Bekræft, at det virkede.

Revisorers aktivitet

Medlemmer af din organisations Auditors-team kan læse organisationens indstillinger uden at ændre dem. Deres læsninger registreres, så du kan se, hvad en revisor har kigget på:

ActionHvornår
tenant.auditor.readEn revisor åbnede en administrationsside eller kaldte et læse-endpoint i API’et. Højst én hændelse pr. revisor og rute hvert 10. minut
tenant.auditor.write_refusedEn revisor sendte en forespørgsel, der ville ændre noget, og den blev afvist. Hvert forsøg
tenant.auditor.read_refusedEn revisor bad om en side eller et endpoint, der er lukket for revisorer, for eksempel dataeksporten, og det blev afvist. Hvert forsøg
compliance.evidence.fetchedNogen, revisor eller ej, hentede den signerede pakke med compliance-dokumentation via API’et. Hver hentning

På de tre tenant.auditor.*-hændelser er actor revisorens brugernavn, og felterne i fields er route (rutens mønster, for eksempel /:slug/_admin/members, aldrig query-strengen), method, status på tenant.auditor.read, via (portal, oauth eller token) og, for et API-token, dets token_id.

Sådan læser du loggen

Administrationen → Rapporter → Revisionslog. Filtrér på actor (<username> eller en agent som mcp-client:<client id>; filteret finder også den person, en agent handlede på vegne af), action (secret.created, role.changed, …), tidsrum eller berørt ressource. Standardvisningen er de seneste 7 dage.

Klik på en række for at folde JSON-indholdet ud. Følsomme felter (secret-værdier, OIDC-tokens, vedhæftninger med personoplysninger) redigeres væk, allerede når de skrives, så en udfoldet række viser aldrig en værdi, du ikke ville vise en kundes revisor.

CSV-eksport

Klik på Eksportér CSV i en filtreret visning for at få et øjebliksbillede. CSV-filen indeholder de rækker, der aktuelt er filtreret, dog højst 50.000 rækker pr. eksport. Til større tidsrum kan du sætte en fuld dataeksport i kø fra Rapporter → Dataeksport.

Via REST API

Revisionsloggen er tilgængelig i det offentlige API. Brug det, når du streamer hændelser ind i din egen analysepipeline, bygger et compliance-dashboard eller kører revisionsforespørgsler fra et script.

  • Forespørg loggen GET /_app/api/v1/orgs/:slug/audit (filtrér med ?actor_kind= og ?since=)
  • Verificér kædens integritet GET /_app/api/v1/orgs/:slug/audit/integrity
  • Skift opbevaringsvindue PATCH /_app/api/v1/orgs/:slug/auth-policy body: { "audit_full_payload_retention_days": 365 }

Kræver et Personal Access Token (PAT) med scopet audit:read (eller policy:write for at ændre opbevaringsvinduet):

curl -H "Authorization: Bearer ${FREMFORGE_PAT}" \
  "https://frem.sh/_app/api/v1/orgs/acme/audit?actor_kind=human&since=2026-01-01T00:00:00Z"

Se referencen for det offentlige REST API for den fulde OpenAPI-specifikation.

SIEM-videresendelse

Hver hændelse i revisionsloggen sendes også til et HTTPS-endpoint pr. tenant, hvis du opsætter SIEM-videresendelse. Endpointet modtager hændelserne i realtid (inden for få sekunder efter handlingen) i et kompakt JSON-format; formatet er stabilt og versioneret.

Opbevaring

Revisionsposter opbevares i to niveauer:

  1. Niveauet med søgbart indhold — actor-navnet og fields_json-indholdet for hver hændelse kan søges i administrationen / CSV-eksporten / SIEM-strømmen i det opbevaringsvindue, der er angivet nedenfor.
  2. Det manipulationssikre kædeniveau — hver hændelses kryptografiske hash og kædeled bevares i 3 år (WORM-forankret med object lock i OBS). Det er det, der gør kæden beviseligt urørt, når der skal dokumenteres over for en revision; den forbliver intakt, også efter at redigeringen i indholdsniveauet har stemplet en række.

Opbevaring af søgbart indhold

PlanStandardForudindstillinger, du kan vælge
fremforge / starter90 dage90 / 180 / 365 / 730
enterprise / enterprise_trial365 dage90 / 180 / 365 / 730

Loftet på 730 dage (≈2 år) holder den aktive tabel audit_events afgrænset. Alt derudover er WORM-niveauets opgave; har du brug for søgbar historik ud over 730 dage, så sæt en dataeksport i kø hvert kvartal, og arkivér den i dit SIEM.

Grænsen gælder kolonnerne for actor og fields_json: rækker, der er ældre end vinduet, beholder deres hash, tidsstempel og action-navn (så SOC 2- og DORA-rapportering stadig virker), men actor pseudonymiseres til redacted, og indholdet erstattes med {}. Den kryptografiske kæde brydes ikke af dette; redigeringen er en pseudonymisering på stedet, ikke en sletning.

Det søgbare vindue er klassen audit_payload under opbevaring af dokumentation, hvor de andre dokumentationsklasser også sættes. Et legal hold sætter redigeringen i bero.

Skift det søgbare vindue

Administrationen → Sikkerhed → Godkendelsespolitik → kortet Opbevaring af revisionslog. Vælg 90 / 180 / 365 / 730 dage. Bemærk:

  • Forlængelse af vinduet (f.eks. 90 → 365): nye rækker kan søges i længere tid. Rækker, der allerede er redigeret under det tidligere vindue, forbliver redigerede — fremforge gendanner dem ikke.
  • Afkortning af vinduet (f.eks. 365 → 90): den næste daglige redigeringskørsel redigerer hver række, der er ældre end det nye vindue. Redigeringen kan ikke fortrydes, når den først er udført; WORM-kæden påvirkes ikke.

Den action, der registreres i revisionsloggen for denne indstilling: tenant.auth_policy.audit_retention.updated (med antallet af dage før og efter i previous og next).

Compliance-forpligtelser

DPA bilag A.7 forpligter til grundniveauet på 90 dage + 3 års WORM. Enterprise-SLA’en forpligter til 365 dages søgbarhed + 3 års WORM. Du kan godt gå under planens standard i brugerfladen, men det ville bryde DPA’en — fremforge håndhæver ikke gulvet i kolonnen, det gør kontrakten. Hvis selve den daglige redigeringskørsel fejler (uafhængigt af at en kunde ændrer opbevaringen), overvåges og alarmeres det løbende.