Organisationens administration

fremforges administration för organisationen finns på frem.sh/<your-org>/_admin. En sidomeny med 5 grupper samlar administrationssidorna, och den övre raden har en Cmd-K-palett (⌘K / Ctrl-K) som söker igenom alla sidor efter namn och nyckelord. Inga gömda undermenyer, inga överraskande dialogrutor.

Organisation: Översikt, Repon, Medlemmar, SSO, Fakturering, Offentlig dokumentation, Dataexport, Inställningar. Säkerhet: Översikt, Fynd, Komponenter, Prioritera, Åtgärda, Rapporter, Policyer, Åtkomst. Se Säkerhet nedan. Bygg och driftsätt: Miljöer, Driftsättningar, Secrets, Uppdateringar av beroenden (samma sida som Säkerhet › Åtgärda), Beroendeproxy, frembench. Integration: AI-integrationer, Programmatisk åtkomst, Webhooks, SIEM-vidarebefordran. Rapporter: DORA, Granskningslogg (kryptografisk integritet i Granskningskedjan), Åtkomstlogg för registret, Legal hold, Lagring av bevis, Juridiska meddelanden.

Om sidan du vill nå hör till en organisation som just nu är avstängd eller befinner sig i 90-dagarsfönstret efter uppsägning är administrationen skrivskyddad överallt utom under Fakturering och Dataexport. Banderollen högst upp på varje sida talar om det.

Flikraden är likadan på varje administrationssida, så du kan byta flik utan att tappa bort dig.

Vem som kommer åt administrationen

Alla med rollen Ägare i Forgejo-organisationen. Rollen sätts på Forgejos sida <org>/-/teams/owners. Kontrollen görs på servern vid varje administrationsbegäran, så om du återkallar en användares ägarroll blir hens administrationssession ogiltig direkt.

Medlemmar och externa medarbetare kommer inte åt /admin. Routen returnerar 403 med meddelandet “not an org owner”.

Flikar

Fakturering

frem.sh/<org>/_admin/billing täcker allt som har med pengar att göra.

• Aktuellt antal användare + uppskattad månadskostnad
• Status för betalningsmetoden (med en länk för att konfigurera betalning om det inte finns något mandat ännu, eller en länk för att byta betalningsmetod om det befintliga mandatet inte fungerar)
• Fakturahistorik med kvitton som går att ladda ned
• Flöde för att säga upp abonnemanget (bekräftas genom att du skriver organisationens slug)

Uppsägningsflödet sätter cancellation_scheduled med ett fönster på 30 dagar innan uppsägningen träder i kraft. Under fönstret kan kunden ångra sig i administrationsgränssnittet eller via länken i mejlet som skickas vid uppsägningen. Efter fönstret byter organisationen till cancelled (skrivskyddad lagring i ytterligare 60 dagar) och sedan till deleted (rensning enligt DPA §9).

SSO

frem.sh/<org>/_admin/sso: identitetsfederation mot din IdP.

• Verifierade domäner: bevisa att du kontrollerar en e-postdomän via DNS TXT eller en HTTP-fil under .well-known. Krävs innan en autentiseringskälla som använder domänen aktiveras.
• Autentiseringskällor: registrera OIDC-leverantörer.

När domänen är verifierad och leverantören registrerad loggar dina användare in med sin IdP på frem.sh/<org>/login. PAT:er och SSH-nycklar fortsätter att gälla i egen rätt. När Require SSO är påslaget validerar fremforge IdP-sessionen på nytt var 15:e minut vid Git-åtgärder, så en användare som inaktiveras i IdP:n förlorar Git-åtkomsten inom det fönstret även om nyckeln fortfarande finns på kontot. Se OIDC-SSO för hela tillämpningsmodellen.

Se migrering → GitHub → Steg 7: Verifiera och avveckla för att verifiera SSO-inloggning som en del av en hel migrering, eller följ stegen för autentiseringskällor direkt på SSO-fliken som beskrivs ovan.

Säkerhet

frem.sh/<org>/_admin/security/overview. Gruppen Säkerhet i sidomenyn har åtta poster, i den ordning du arbetar dig igenom ett fynd: upptäcka, prioritera, åtgärda, rapportera, plus de policyer som avgör vad som är tillåtet och vem som släpps in.

Alla äldre adresser till de här sidorna, till exempel _admin/security/policies/edge, _admin/code-security/…, _admin/compliance-evidence eller _admin/attestations, omdirigeras till sin nya flik. “Edge policies” finns inte längre: dess inställningar ligger under Prioritera (Åtgärdsfrist (SLA), Pull request-kontroller), Åtkomst (IP-tillåtelselista, Supportåtkomst, AI-anslutningar och informationen om tvåfaktorsautentisering under Autentiseringspolicy) och Rapporter › Aviseringar (säkerhetssammanfattningen).

Push-skydd

frem.sh/<org>/_admin/security/policies/push-protection. Hemlighetsskanning vid varje push är alltid påslagen. Den här fliken innehåller undantagslistan och skannerns beteende vid fel.

• Senaste avvisningar: varje push som blockerades för att gitleaks matchade ett hemlighetsmönster med hög tillförlitlighet. Klicka på Godkänn för att göra den till ett engångsundantag eller ett undantag avgränsat till ett mönster.
• Aktiva undantag: din tillåtelselista. Varje undantag har en motivering (loggas i granskningsloggen) och kan avgränsas till regel, sökvägsmönster, commit eller repo. Du kan återkalla ett undantag när som helst.

Om ett fynd är en verklig hemlighet roterar du den först hos tjänsten som utfärdade den, tar sedan bort den ur historiken med git filter-repo och pushar därefter. Om det är ett falskt positivt fynd (testdata, en avsiktligt publik autentiseringsuppgift) lägger du till ett undantag avgränsat till sökvägen. Se Push-skydd.

Fynd

frem.sh/<org>/_admin/security/findings/sast. En flik per skanner: SAST, Beroenden, Licenser, Container-images, Hemlighetsskanning, Skadlig kod (skanningen av uppladdningar efter skadlig kod), plus Undantag. Varje flik visar sina fynd först, med en rad som talar om ifall skannern är påslagen och vid vilken allvarlighetsgrad dess pull request-kontroll fallerar. Själva inställningarna finns under Säkerhet › Policyer › Skannrar. De regler som ett fynd bedöms efter, till exempel licenslistorna och spärren för hämtning av images, finns under Säkerhet › Policyer (se Säkerhetspolicyer).

Uppdateringar av beroenden

frem.sh/<org>/_admin/dependency-updates, under Säkerhet › Åtgärda (Bygg och driftsätt har en länk till samma sida). En sida med två spår: Säkerhetsfixar, en pull request per sårbart paket utifrån dina fynd, och Versionsuppdateringar från hostat Renovate. Sidan listar också de repon som deltar och den senaste aktiviteten.

• Aktivera: skapar en botanvändare för organisationen och startar en nattlig körning för organisationens repon.
• Senaste körningar: de 10 senaste Renovate-körningarna med antal PR:er och eventuella fel.
• Kör nu: startar en körning utanför schemat (högst 1 per timme).
• Inaktivera: återkallar botens token direkt och tar bort den från organisationen. PR:er som boten redan har öppnat förblir öppna.

Konfigurationen per repo görs med renovate.json i repots rot. Se Uppdateringar av beroenden för båda spåren, Versionsuppdateringar för Renovate-referensen och Säkerhetsfixar för fix-PR:er som drivs av fynd.

Secrets

frem.sh/<org>/_admin/secrets: hemligheter för Actions på organisationsnivå, som injiceras i varje CI-jobb i organisationen som miljövariabler. Forgejo är lagringslagret (krypterat i vila); fremforges administration vidarebefordrar CRUD-åtgärderna och skickar granskningshändelser med hemlighetens namn, aktör och tidsstämpel (värdet sparas aldrig i fremforges databas eller granskningslogg).

• Ny hemlighet / skriv över: namn (UPPER_SNAKE_CASE; får inte börja med FORGEJO_ eller GITHUB_) och värde. Om du skickar ett befintligt namn skrivs det över; samma formulär är flödet för rotation.
• Aktiva hemligheter: lista över namn + tidpunkt för skapande. Värden går bara att skriva: fremforge läser eller visar aldrig ett värde efter att det har skapats.
• Ta bort: bekräftas via en confirm()-dialog i JS. Arbetsflöden som refererar till hemligheten misslyckas tills den skapas igen.

Organisationens hemligheter ärvs av alla repon i organisationen. För hemligheter per repo sätter du hemligheten under Repot → Inställningar → Actions → Hemligheter i Forgejos eget gränssnitt. För hemligheter per miljö sätter du den under Organisationens administration → Miljöer → <env> → Miljösecrets (frem.sh/<org>/_admin/environments). Den mest specifika nivån vinner: en miljöhemlighet med samma namn som en organisationshemlighet skuggar organisationshemligheten för jobb i den miljön.

Se Secrets för hela referensen, inklusive API-sökvägen och rutinen för rotation.

Standardinställningar för repon

frem.sh/<org>/_admin/repo-defaults omdirigerar till Säkerhet › Policyer › Repo-regler (_admin/security/policies/repository-rules#org-baseline): standardinställningarna för branch-skydd i organisationens repon, till exempel krav på godkännanden, granskning enligt CODEOWNERS och signerade commits. Se Branch-skydd.

Webhooks

frem.sh/<org>/_admin/webhooks: leveranshistorik och omleverans för webhooks för händelser i hela organisationen. Skapandet av webhooks (vilka händelser som prenumereras på, mål-URL, signeringshemlighet) konfigureras i Forgejos eget gränssnitt på /<org>/-/settings/hooks (organisationsnivå) eller /<org>/<repo>/settings/hooks (reponivå). fremforge äger översikten över leveranshistoriken under administration → Webhooks; Forgejo äger registreringen.

• Senaste leveranser: granska enskilda leveransförsök, svarskoder och payloads.
• Leverera igen: skicka om en händelse från historikvyn. Användbart för att felsöka buggar hos mottagaren efter en rättning.

Organisationens webhooks utlöses med samma händelseformat som webhooks per repo. Se webhooks för hela referensen över händelsetyper och payloadschemat.

Miljöer

frem.sh/<org>/_admin/environments: driftsättningsmiljöer i GitHub-stil för CI/CD-jobb. Varje miljö har ett namn (som refereras från arbetsflödets YAML som jobs.<id>.environment: <name>), skyddsmönster för brancher och taggar, avgränsade hemligheter och avgränsade variabler.

• Brancher och taggar för driftsättning: glob-mönster (main, release/*, v[0-9]*) som begränsar vilka referenser som får driftsätta till miljön. Referenser som inte matchar avvisas innan runnern ens hämtar arbetsflödet.
• Miljöhemligheter: krypterade hemligheter som injiceras i jobb som körs med environment: <name>. De skuggar hemligheter på organisationsnivå med samma nyckel. Användbart för autentiseringsuppgifter som bara gäller produktion.
• Miljövariabler: miljövariabler som inte är hemliga (region, driftsättnings-URL med mera) och som är bundna till miljön.
• OIDC-federation: varje körning av ett arbetsflöde har en OIDC-token vars sub-claim innehåller miljöns namn (repo:owner/repo:environment:prod). Lita på den i ditt molns IdP för att ge kortlivade autentiseringsuppgifter för driftsättning utan långlivade hemligheter.

Se hemligheter för driftsättning för en fullständig genomgång av OIDC-federation, inklusive förtroendepolicyer för AWS, Azure, GCP och T Cloud Public.

Lagring av byggartefakter

frem.sh/<org>/_admin/artifact-retention: organisationens lagringsinställning för artefakter från Forgejo Actions (byggresultat, testrapporter, felsökningspaket), i dagar från 1 till 90. Standard är 30 dagar för nya organisationer, och organisationer som aldrig ändrade värdet gick från 90 till 30 den 2026-10-21. Ett värde som du själv har satt behålls.

Vad som faktiskt tar bort en artefakt i dag. Forgejo låter en artefakt löpa ut efter den retention-days som angavs när den laddades upp, eller efter plattformens tak på 90 dagar (Forgejo-instansens [actions].ARTIFACT_RETENTION_DAYS), beroende på vilket som är kortast. Organisationsinställningen ovan tar ännu inte bort något: det nattliga jobb som ska tillämpa ett kortare värde behöver ett artefakt-API som den här Forgejo-versionen saknar. För att behålla artefakter kortare än 90 dagar sätter du retention-days vid uppladdningen:

- uses: actions/upload-artifact@v3
  with:
    name: test-report
    path: report/
    retention-days: 7

Artefakter som har löpt ut räknas inte längre mot organisationens artefaktkvot.

SIEM-vidarebefordran

frem.sh/<org>/_admin/siem: strömma organisationens granskningslogg till din SIEM i nära realtid. Stöder Splunk HEC, Sentinel HTTP Data Collector, Elastic Cloud och en generisk webhook med HMAC-SHA256-signering. Splunk och Sentinel kräver en tunn proxy som översätter HMAC (se SIEM-vidarebefordran); Elastic Filebeat och den generiska webhooken är direkta. Varje mottagare kan testas med en syntetisk händelse innan den tas i drift; mottagare som inte fungerar backar och visar felen i operatörsportalen.

Leverantörsintyg och kontrollbevis

Båda finns under Säkerhet › Rapporter: Leverantörsintyg (_admin/security/reports/vendor-attestation) är ett dokument om fremforge som din leverantör, och Kontrollbevis (_admin/security/reports/control-evidence) mappar organisationens granskningshändelser till kontroller i SOC 2 och ISO 27001. SLSA-byggproveniens finns under Säkerhet › Komponenter › Byggattesteringar; se SLSA-proveniens.

Livscykel för organisationer och repon

Några åtgärder ligger utanför flikarna eftersom de görs en gång snarare än är löpande konfiguration. De finns där de naturligt hör hemma (repots inställningssida eller sidan för att byta namn på organisationen), men vi pekar ut dem här så att de inte är osynliga.

Byta namn på en organisation

frem.sh/<org>/_admin/settings: ändra organisationens slug. Befintliga repo-URL:er, klon-URL:er, API-anrop och referenser i webhook-payloads som använder den gamla slugen fortsätter att omdirigeras i 90 dagar efter namnbytet. Efter 90 dagar kan den gamla slugen registreras igen, så planera övergången, uppdatera integrationerna under omdirigeringsfönstret och vänta inte för länge.

Namnbytet är en åtgärd för organisationens ägare, loggas i granskningsloggen och bekräftas genom att du skriver den gamla slugen.

Flytta ett repo till en annan organisation

frem.sh/<org>/<repo>/settings → Transfer ownership. Ett repo kan flyttas till en annan organisation som du äger (eller till en annan användares konto; användaren måste acceptera). Vid flytten:

• Alla brancher, taggar, historik, issues, PR:er, releaser, paket, webhooks och körningar av CI-arbetsflöden följer med repot.
• Forkar av repot på fremforge stannar där de var; de uppdaterar automatiskt sin upstream-pekare till den nya platsen.
• Befintliga URL:er för git clone, git fetch och HTTP-API:t mot den gamla sökvägen <org>/<repo> omdirigeras i 90 dagar, samma fönster som vid namnbyte på en organisation. Uppdatera remotes när det passar; omdirigeringen är ett operativt andrum, inte en permanent garanti.

Flytten styrs av målorganisationens policy: om målorganisationen kräver SSO, signerade commits och så vidare ärver det flyttade repot den policyn vid ankomsten. Befintliga regler för branch-skydd i repot bevaras, såvida inte målorganisationens standardinställningar är striktare.

Säga upp ett abonnemang

En åtgärd för ägaren, som bekräftas genom att du skriver organisationens slug. Se fliken Fakturering ovan för uppsägningsflödet och sidan Fakturering för livscykelns tillstånd (uppsägning schemalagd → uppsagd → borttagen).

Ta bort ett personligt konto

Ligger utanför organisationens administration. Borttagning av personliga konton (rätten till radering enligt GDPR) finns under Användarinställningar → Konto. Se Ditt fremforge-konto för hela flödet, inklusive vad som bevaras som historiskt författarskap.

Branch-skydd, begreppsreferens

Branch-skydd följer en hierarki i tre nivåer: plattformens golv (satt av fremforge, går inte att konfigurera) → organisationens standard (satt av organisationens ägare, gäller alla repon) → regler per repo (kan skärpa organisationens standard men inte lätta på den under organisationens golv).

Organisationens standardskydd: Säkerhet › Policyer › Repo-regler, standardinställningar för branch-skydd. Sätt regler som gäller alla nyskapade repon och alla befintliga repon där det inte finns någon striktare regel på reponivå.

Skydd per repo: Repot → Inställningar → Grenar → Lägg till ny regel. Ange ett mönster för branchnamnet (till exempel main, release/*). Tillgängliga skydd:

Plattformens golv: Plattformen tillämpar följande: signerade commits är tillåtna (inte tvingande) på plattformsnivå; hemlighetsskanning körs oavsett inställningarna för branch-skydd; granskningsloggen registrerar alla force push-händelser även om force push inte är blockerat.

Arv av policyer: Om organisationens standard kräver 1 PR-granskning och en regel i repot kräver 2 vinner den striktare regeln (2). Regler i repot kan bara skärpa, inte lätta på.

Dataexport

frem.sh/<org>/_admin/data-export: fullständig export på egen hand.

• Starta en ny export: sätter ihop en enda signerad .tar.gz med en git bundle per repo, varje repos issues, pull requests, kommentarer, etiketter, milstolpar och releaser, paketinventeringen och ett utdrag ur granskningsloggen för 90 dagar. Se Dataexport för exakt vad som ingår.
• Senaste jobb: de 20 senaste exportjobben med nedladdningslänkar (giltiga i 7 dagar efter att de blev klara) och status.

Begränsat till en export per organisation och 24 timmar. Paket över 50 GB hanteras med en annan rutin. Kontakta supporten.

Se dataexport för paketets struktur, recept för verifiering och API-endpoints.

Inställningar

frem.sh/<org>/_admin/settings: organisationens grundläggande metadata: synlighet (publik / begränsad / privat), visningsnamn, beskrivning, webbplats, plats. Ändringar här vidarebefordras till Forgejo via PATCH /api/v1/orgs/{org} och skickar granskningshändelsen tenant.org.settings.updated.

Inställningar som hanteras på andra ställen:

• Organisationens namn (slug): att byta slug är en Forgejo-åtgärd med ett omdirigeringsfönster på 90 dagar; hantera det i Forgejos eget gränssnitt under /<org>/-/settings.
• Avatar / profilbild: Forgejos eget gränssnitt under /<org>/-/settings.
• Fakturering, SSO, säkerhetspolicy, push-skydd: se de särskilda flikarna ovan.

Gränsen: fremforges administration äger organisationens namn (visning), synlighet, webbplats, beskrivning och plats, tillsammans med de särskilda flikarna för abonnemang, policyer, säkerhet och granskning. Forgejos eget gränssnitt på /<org>/-/settings äger avatar / profilbild, byte av slug, Forgejos interna standardinställningar för nya repon och djupare konfiguration som bara finns i Forgejo. Båda går att nå från ägarkonton; välj den yta som passar ändringen du gör.

Granskningslogg

frem.sh/<org>/_admin/audit-log: varje tillståndsändrande administrativ åtgärd mot din organisation, bläddringsbar i realtid.

• Aktörsfilter: begränsa till en viss Forgejo-användare, till operatörsåtgärder (med prefixet operator:<email>) eller till en agent. Filtret matchar aktören, den person som en agent agerade för och själva agenten, så ett filter på en användare tar med det som agenter gjorde för hens räkning.
• Märket via agent: en åtgärd som en agent utförde för en persons räkning anger personen som aktör och märks via agent; agentens id finns i händelsens fält agent.
• Åtgärdsfilter: begränsa till en namnrymd (till exempel push-protection eller billing.cancel).
• Tidsfilter: begränsat till ett datumintervall.
• Operatörsmärke: åtgärder som fremverks personal utför för din organisations räkning markeras i orange och är aldrig tysta. Samma data hamnar i granskningsutdraget i ditt dataexportpaket.

Äldre händelser kapas efter 200 rader på skärmen. För fullständiga historiska uttag använder du Dataexport. Granskningsutdraget i paketet är obegränsat.

Lagringstid. Enligt DPA bilaga A.7 ligger säkerhetsrelevanta händelser (autentisering, auktorisering, administrativa åtgärder) i en sökbar het nivå med en lagringstid per organisation som du sätter under Säkerhet → Autentiseringspolicy → Lagringstid för granskningslogg: förvalen är 90 / 180 / 365 / 730 dagar, med 90 som standard (standardplanen) eller 365 (enterprise-planer). Driftloggar (HTTP, runners, infrastruktur) hålls heta i 30 dagar (går inte att konfigurera). Båda nivåerna skrivs till ett oföränderligt WORM-arkiv i T Cloud Public OBS i 3 år, med förankring av hashkedjan varannan minut som bevis mot manipulation. Efter gränsen för den heta nivån maskeras innehållet (actor, fields_json), men SHA-256-hasharna i kedjan behålls i hela 3 år. Vyn på skärmen och granskningsutdraget i dataexportpaketet täcker båda det konfigurerade fönstret för den heta nivån. Kontakta support@frem.sh för att hämta äldre händelser ur WORM-arkivet.

Motsvarighet i API:t

Varje administrativ åtgärd är också en dokumenterad REST-endpoint. Administrationsgränssnittet är självt en klient till samma API som en AI-agent skulle använda. Se publikt REST-API för OpenAPI-specifikationen.

Två namnrymder, en bas-värd. Routes under /api/v1/... är Forgejos egna (samma form som Forgejos upstream-API, utan fremforge-prefix; används för CRUD på organisationer, repon, användare, issues och PR:er som Forgejo redan täcker). Routes under /_app/api/v1/... är fremforges tillägg (de tillägg i kontrollplanet som vi lägger ovanpå: fakturering, push-skydd, dataexport, hostat Renovate, SSO-policy, attesteringar). Anropet PATCH /api/v1/orgs/{org} som nämns under §Inställningar ovan är Forgejos egen form; samma nätverksvärd betjänar båda prefixen via plattformens routing. Välj prefixet som hör till den dokumenterade endpointen och blanda inte.

Det betyder att allt du gör i administrationsgränssnittet kan du också göra programmatiskt:

• POST /_app/api/v1/orgs/<org>/dependency-updates/enrol, samma sak som att klicka på Slå på hostat Renovate (fremforge-tillägg)
• POST /_app/api/v1/orgs/<org>/exports, samma sak som att klicka på Starta en ny export (fremforge-tillägg)
• GET /_app/api/v1/orgs/<org>/push-protection/overrides, listar aktiva undantag från push-skyddet (fremforge-tillägg)
• PATCH /api/v1/orgs/<org>, uppdaterar visningsnamn / webbplats / plats / synlighet (Forgejos eget)
• …och så vidare.

Autentisering med token: en PAT som utfärdas från dina användarinställningar i Forgejo. OAuth 2.0 client credentials planeras tillsammans med flödet för agentidentitet.

Granskningsspår

Varje administrativ åtgärd skickar en strukturerad loggrad till fremforges granskningsström med fälten actor, action, tenant_id plus fält som är specifika för åtgärden. Granskningsloggen ingår i paketet från dataexporten, avgränsad till din organisation.

Det här ser du i ditt granskningsutdrag:

• Alla POST- och DELETE-åtgärder i administrationsgränssnittet (allt som ändrar tillstånd)
• Alla API-anrop som autentiserats som en medlem i din organisation
• Alla operatörsåtgärder som fremverks personal utför för din organisations räkning (de markeras med actor=operator:<email> och är aldrig tysta)

Det här ser du inte (av integritetsskäl och rättsliga skäl):

• Interna infrastrukturhändelser hos fremverk (de går till en separat granskningsström)
• Korrelationsidentifierare mellan organisationer (maskeras före export)

Korsreferenser

• Priser: vad som ingår i planen för 30 € per användare
• Förtroende: underbiträden, certifieringar, hållning i suveränitetsfrågor
• Publikt REST-API: programmatiska motsvarigheter till varje administrativ åtgärd
• Migreringsguider: steg-för-steg-konfiguration från GitHub / GitLab / Azure DevOps