Files

Kenzo 761ab5d5b5 Refactor content structure and add basic authentication utilities

- Moved event and gallery data to JSON files for cleaner content management.
- Added session management utilities with CSRF protection.
- Integrated OAuth-based login and logout APIs.
- Updated dependencies, including Astro and introduced dotenv-cli.
- Enhanced package.json with local environment support.

2025-11-08 17:02:51 +01:00

2.6 KiB

Raw Blame History

Gallus Pub Website – Admin mit Gitea OAuth und Git-Commits

Dieses Projekt stellt eine Astro‑Seite bereit und enthält eine Admin‑Oberfläche unter /admin, mit der Inhalte (Events, Galerie und Bilder) ohne Datenbank gepflegt werden können. Änderungen werden als Commits direkt in das Gitea‑Repository geschrieben. Woodpecker baut daraufhin und Fly.io deployt.

Inhalte (Headless, Git‑basiert)

Editierbare Dateien im Repo:
- src/content/events.json
- src/content/gallery.json
Bilder: public/images/*
Die Startseite importiert diese Dateien und rendert sie.

Admin & Auth

Admin‑Seite: https://<domain>/admin (kein Link im UI, nur direkter Pfad)
Login via Gitea OAuth:
- /api/auth/login → Gitea → /api/auth/callback
- Session als HttpOnly‑Cookie, CSRF‑Cookie für POSTs
Speichern: /api/save validiert und committet die Dateien via Gitea‑API

Lokale Entwicklung

.env.example nach .env.local kopieren und ausfüllen (Gitea OAuth‑App mit Redirect http://localhost:4321/api/auth/callback).
Installieren und starten:

npm install
npm run dev:local

Browser öffnen: http://localhost:4321/admin → Mit Gitea anmelden → Inhalte bearbeiten → Speichern.

Hinweis: Für lokales HTTP sind Cookies ohne Secure gesetzt. In Produktion werden Cookies automatisch als Secure markiert.

Produktion (Fly.io)

Dockerfile baut Astro als SSR und startet node dist/server/entry.mjs auf Port 3000.
Secrets auf Fly.io setzen (Beispiele, Werte anpassen):

flyctl secrets set \
  OAUTH_PROVIDER=gitea \
  OAUTH_CLIENT_ID=... \
  OAUTH_CLIENT_SECRET=... \
  OAUTH_AUTHORIZE_URL=https://git.bookageek.ch/login/oauth/authorize \
  OAUTH_TOKEN_URL=https://git.bookageek.ch/login/oauth/access_token \
  OAUTH_USERINFO_URL=https://git.bookageek.ch/api/v1/user \
  GITEA_BASE=https://git.bookageek.ch \
  GITEA_OWNER=OWNER \
  GITEA_REPO=REPO \
  GITEA_TOKEN=PAT \
  GIT_BRANCH=main \
  SESSION_SECRET=RANDOM \
  CSRF_SECRET=RANDOM

Optional: PUBLIC_BASE_URL=https://gallus-pub.ch setzen.

Wichtige Pfad‑Konvention

Statische Assets immer unter public/ ablegen (z. B. public/images/...).
Die Admin‑Uploads schreiben automatisch nach public/images/*.

Befehle

npm install – Abhängigkeiten
npm run dev – Standard Dev
npm run dev:local – Dev mit .env.local (OAuth/Gitea)
npm run build – Produktion builden
npm run preview – Build lokal testen

Sicherheit

Kein PAT im Browser – nur serverseitig in Secrets
CSRF‑Schutz und Pfad‑Allowlist
Optional nutzerbasierte Zulassung: OAUTH_ALLOWED_USERS (Komma‑Liste)

2.6 KiB Raw Blame History Unescape Escape