# Besluiten

Tim heeft deze punten beantwoord. Wat hieronder staat is de huidige regel, niet meer een open vraag.

## Besloten

1. **`is_admin` van auth.timfalken.com maakt niemand BlueGit-beheerder.** Alleen de eerste aangemelde gebruiker wordt installatiebeheerder. `is_admin` wordt wel opgeslagen (`users.auth_admin`), maar geeft geen rechten.
2. **Er komt geen API voor SSH-sleutels op de auth-server.** BlueGit houdt zijn eigen sleutels, geplakt op de accountpagina. Sleutels op de auth-server blijven alleen voor aanmelden dáár.
3. **De standaardbranch is `master`.** Nieuwe repositories en `git.default_branch` gebruiken die naam. De pipeline van BlueGit zelf houdt een regel voor `main` aan, zodat een oude branch nog kan uitrollen.
4. **Het afzenderadres van een merge is `{naam}@users.git.timfalken.com`.** De auth-server geeft geen e-mailadres.
5. **De installatiebeheerder krijgt geen automatische toegang tot de repositories, groepen en geheimen van anderen.** Die vlag is alleen voor instance-beheer. Het enige scherm dat erbij hoort is `/setup`, voor het pad van de datadisk.
6. **Buiten de mini-PC loopt alles via een ingress op een andere machine.** Die doet TLS en stuurt SSH door. BlueGit zelf spreekt plain HTTP op `listen`, vertrouwt `X-Forwarded-For` en `X-Real-IP` alleen van `trusted_proxies`, en zet clone-URL's in elkaar uit `base_url` plus `ssh.public_host` en `ssh.public_port`. `ssh.listen` blijft de poort waarop dit proces bindt en blijft configureerbaar. Het voorbeeld staat in [INGRESS.md](INGRESS.md).
7. **Webhooks blokkeren privébestemmingen.** Dat zijn RFC1918, loopback, link-local (inclusief de metadata-adressen `169.254.169.254` en `169.254.170.2`), CGNAT `100.64.0.0/10`, ULA `fc00::/7` (inclusief `fd00:ec2::254`), IPv6-link-local en het oude site-local, plus multicast, unspecified en gereserveerd. Een letterlijk privé-IP in de URL wordt geweigerd. Een naam wordt bij het verbinden opgelost; wijst één van de adressen naar zo'n bereik, dan gaat de webhook niet uit en wordt dat IP vastgezet zodat DNS-rebinding niet alsnog een ander adres kiest. Hetzelfde geldt voor elke redirect. Een naam die via publieke DNS naar een publiek IP wijst mag, ook als de router dat verkeer daarna terug naar het thuisnet stuurt. 6to4 en NAT64 worden beoordeeld op het ingebedde IPv4-adres.
8. **De licentie is MIT.**
9. **Er is geen standaardpad voor de datadisk.** Database, `secret.key` en de SSH-hostkey staan in de state-map: `state_path`, standaard `/var/lib/bluegit` (systemd `StateDirectory`). De installatiebeheerder kiest het pad van de repositories bij de eerste aanmelding, in het setup-scherm. Het pad moet absoluut zijn, bestaan, beschrijfbaar zijn en minstens 1 GiB vrij hebben; de vrije ruimte wordt getoond. Tot die tijd antwoorden git en CI met een melding en doen ze niets. Het pad later wijzigen mag in hetzelfde scherm, met de waarschuwing dat data niet vanzelf verhuist. Zodra het bestand `storage_path` in de state-map staat, wint dat van `storage_path` in de configuratie.
