Sveltia CMS – OAuth2 einrichten

Sveltia CMS verwendet OAuth2 über Forgejo für die Authentifizierung. Pro Kundenprojekt wird eine eigene OAuth2-App angelegt.

OAuth2-App in Forgejo erstellen

Als Admin oder als der Benutzer/die Organisation, dem das Repo gehört:

https://forge.repair.nrw/user/settings/applications

→ „OAuth2-Anwendungen verwalten" → „Neue OAuth2-Anwendung erstellen"

Feld	Wert
Name	Sveltia CMS – stadtname
Redirect-URI	https://www.musterstadt.de/admin/
Vertraulich	Deaktivieren – PKCE benötigt kein Secret

Nach dem Speichern: Client-ID kopieren (sieht aus wie 907e264e-b6cf-499f-b80a-...).

Redirect-URI

Die Redirect-URI muss exakt mit der öffentlichen Domain übereinstimmen, inklusive /admin/ am Ende. Bei einer Subdomain z. B. https://musterstadt.repair.nrw/admin/.

app_id in der config.yml eintragen

cd stadtname-website
# Datei öffnen:
code public/admin/config.yml

Folgende Felder prüfen und setzen:

backend:
  name: gitea
  base_url: https://forge.repair.nrw
  api_root: https://forge.repair.nrw/api/v1
  repo: 2TAP2B/stadtname-website        # ← owner/reponame
  branch: main
  app_id: 907e264e-xxxx-xxxx-xxxx-xxxxxxxxxxxx   # ← Client-ID eintragen

site_url: https://www.musterstadt.de
display_url: https://www.musterstadt.de

Änderung committen und pushen

git add public/admin/config.yml
git commit -m "chore: set Sveltia CMS OAuth2 app_id"
git push

Das CMS ist jetzt unter https://www.musterstadt.de/admin/ erreichbar und kann sich per Forgejo-Login authentifizieren.