BlueGit

timfa bluegit

fix: installatiebeheerder ziet andermans gegevens niet

Tims antwoorden: is_admin wordt geen BlueGit-beheerder, SSH-sleutels
blijven lokaal, de standaardbranch is master, en de installatiebeheerder
krijgt geen toegang tot repositories, groepen of geheimen van anderen.
Achter de ingress luistert BlueGit plain HTTP, vertrouwt
X-Forwarded-For alleen van trusted_proxies, en zet clone-URL's in elkaar
uit base_url plus ssh.public_host en ssh.public_port.

Co-authored-by: tim <tim@timfalken.com>

timfa project_87923614_bot_3aff574f6f98414b945a8799374f9092 · pushed by timfa

Authored 2026-10-21 · 3 weeks ago

Hash
77270b74aa0586661ef0cd8ddc2d002ba087faf8
Parent
151aa352
24 files changed +639 −130
README.md +13 −18
@@ -12,9 +12,9 @@ Die keuze houdt de mini-PC klein. Er is geen Postgres, geen Redis en geen aparte
12 12
13 13 ## Wat deze basis al doet
14 14
15 - Aanmelden met de authorization-code-flow van auth.timfalken.com. De eerste ingelogde gebruiker wordt installatiebeheerder.
16 - Repositories van een gebruiker of een groep, met de rollen alleen-lezen, ontwikkelaar en beheerder.
17 - Git over HTTPS (smart HTTP). SSH staat in de code en achter `ssh.enabled`, op poort 2222.
15 - Aanmelden met de authorization-code-flow van auth.timfalken.com. De eerste ingelogde gebruiker wordt installatiebeheerder. `is_admin` van de auth-server geeft die rol niet, en de vlag geeft geen toegang tot andermans repositories, groepen of geheimen.
16 - Repositories van een gebruiker of een groep, met de rollen alleen-lezen, ontwikkelaar en beheerder. De standaardbranch is `master`.
17 - Git over HTTPS (smart HTTP) en SSH. Achter de ingress is HTTP plain, en de clone-URL gebruikt `ssh.public_host` en `ssh.public_port`. `ssh.listen` is de poort op de mini-PC.
18 18 - Webinterface: bestanden, commits, branches, merge requests, pipelines, releases, leden, geheimen en webhooks.
19 19 - `blue-ci-cd.yml`: stages, jobs, `needs`, `rules`, artifacts. Elke job in een eigen container.
20 20 - Geheimen als omgevingsvariabelen. Beschermde geheimen alleen op een beschermde branch.
@@ -22,7 +22,7 @@ Die keuze houdt de mini-PC klein. Er is geen Postgres, geen Redis en geen aparte
22 22 - Webhooks op repository en groep, met presets voor Discord, Grok Bot en een generieke JSON-webhook.
23 23 - Een PKGBUILD, een systemd-unit en `packaging/install.sh`.
24 24
25 Wat nog niet af is, staat in [docs/ROADMAP.md](docs/ROADMAP.md). De vorm van het systeem staat in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). De auth-koppeling staat in [docs/AUTH.md](docs/AUTH.md).
25 Wat nog niet af is, staat in [docs/ROADMAP.md](docs/ROADMAP.md). De vorm van het systeem staat in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). De auth-koppeling staat in [docs/AUTH.md](docs/AUTH.md). De ingress staat in [docs/INGRESS.md](docs/INGRESS.md). Besloten en nog open vragen staan in [docs/VRAGEN.md](docs/VRAGEN.md).
26 26
27 27 ## Lokaal proberen
28 28
@@ -64,22 +64,15 @@ cd packaging/arch && makepkg -si
64 64
65 65 Daarna:
66 66
67 1. Mount de 4 TB-schijf, bijvoorbeeld op `/mnt/storage`, en maak `/mnt/storage/bluegit` aan als de gebruiker `bluegit`.
68 2. Zet `storage_path` in `/etc/bluegit/config.yml` op die map.
69 3. Kopieer `/usr/share/bluegit/storage.conf.example` naar `/etc/systemd/system/bluegit.service.d/storage.conf`. Zonder die drop-in blokkeert `ProtectSystem` schrijven buiten `/var/lib/bluegit`.
67 1. Mount de 4 TB-schijf. Het mountpoint is nog niet gekozen. Maak de map voor BlueGit aan als de gebruiker `bluegit`.
68 2. Zet `storage_path` in `/etc/bluegit/config.yml` op die map. `/mnt/storage/bluegit` in het voorbeeld is geen besluit.
69 3. Kopieer `/usr/share/bluegit/storage.conf.example` naar `/etc/systemd/system/bluegit.service.d/storage.conf` en pas het pad aan. Zonder die drop-in blokkeert `ProtectSystem` schrijven buiten `/var/lib/bluegit`. De drop-in wordt niet geïnstalleerd, omdat een pad dat niet bestaat de dienst zou tegenhouden.
70 70 4. Registreer bij https://auth.timfalken.com/admin het domein `git.timfalken.com` met callback-pad `/auth/callback`. Het client_id is het domein. Het geheim verschijnt één keer.
71 71 5. Zet het geheim in `/etc/bluegit/client_secret` (mode `0600`) of in `BLUEGIT_AUTH_CLIENT_SECRET` via `/etc/bluegit/secret.env`.
72 6. Zet een reverse proxy voor HTTPS. Caddy is genoeg:
73
74 ```caddy
75 git.timfalken.com {
76 reverse_proxy 127.0.0.1:8080
77 }
78 ```
79
72 6. Zet de ingress op de andere machine. BlueGit zelf blijft plain HTTP. `trusted_proxies` is het adres van die ingress, `base_url` is `https://git.timfalken.com`, en `ssh.public_port` is de poort die gebruikers zien. Het voorbeeld staat in [docs/INGRESS.md](docs/INGRESS.md).
80 73 7. `systemctl enable --now bluegit`. De eerste aanmelding wordt installatiebeheerder.
81 74
82 SSH voor git luistert op `0.0.0.0:2222`, naast de SSH van het besturingssysteem. De hostkey komt de eerste keer in de opslagmap.
75 SSH voor git luistert op `ssh.listen` (in het voorbeeld `0.0.0.0:2222`), naast de SSH van het besturingssysteem. De hostkey komt de eerste keer in de opslagmap. De clone-URL gebruikt `ssh.public_host` en `ssh.public_port`, niet de bindpoort.
83 76
84 77 ## Rollen
85 78
@@ -91,7 +84,9 @@ Een repository hoort bij een gebruiker (die is beheerder) of bij een groep. Iema
91 84 | Ontwikkelaar | ja | ja | nee | nee |
92 85 | Beheerder | ja | ja | ja | ja |
93 86
94 Een ontwikkelaar ziet geheimen niet terug. Een job krijgt ze wel als omgevingsvariabele, anders kan CI er niets mee. Wie een pipeline mag starten, kan een onbeschermd geheim dus uitlezen via `blue-ci-cd.yml`. Markeer een geheim als beschermd als het alleen op een beschermde branch mee mag, en bescherm `main`.
87 Een ontwikkelaar ziet geheimen niet terug. Een job krijgt ze wel als omgevingsvariabele, anders kan CI er niets mee. Wie een pipeline mag starten, kan een onbeschermd geheim dus uitlezen via `blue-ci-cd.yml`. Markeer een geheim als beschermd als het alleen op een beschermde branch mee mag, en bescherm `master`.
88
89 De installatiebeheerder is geen beheerder van andermans repository. Geheimen, groepen en privérepositories blijven bij de leden.
95 90
96 91 ## CI, releases, webhooks
97 92
@@ -115,4 +110,4 @@ De kern zit in `internal/access` (rollen en beschermde branches), `internal/ci`
115 110
116 111 ## Licentie
117 112
118 MIT. Dat is een keuze voor deze basis; zeg het als het anders moet.
113 MIT. Zie [LICENSE](LICENSE).
@@ -12,9 +12,9 @@ Die keuze houdt de mini-PC klein. Er is geen Postgres, geen Redis en geen aparte
12
12
13## Wat deze basis al doet
13## Wat deze basis al doet
14
14
15- Aanmelden met de authorization-code-flow van auth.timfalken.com. De eerste ingelogde gebruiker wordt installatiebeheerder.
15- Aanmelden met de authorization-code-flow van auth.timfalken.com. De eerste ingelogde gebruiker wordt installatiebeheerder. `is_admin` van de auth-server geeft die rol niet, en de vlag geeft geen toegang tot andermans repositories, groepen of geheimen.
16- Repositories van een gebruiker of een groep, met de rollen alleen-lezen, ontwikkelaar en beheerder.
16- Repositories van een gebruiker of een groep, met de rollen alleen-lezen, ontwikkelaar en beheerder. De standaardbranch is `master`.
17- Git over HTTPS (smart HTTP). SSH staat in de code en achter `ssh.enabled`, op poort 2222.
17- Git over HTTPS (smart HTTP) en SSH. Achter de ingress is HTTP plain, en de clone-URL gebruikt `ssh.public_host` en `ssh.public_port`. `ssh.listen` is de poort op de mini-PC.
18- Webinterface: bestanden, commits, branches, merge requests, pipelines, releases, leden, geheimen en webhooks.
18- Webinterface: bestanden, commits, branches, merge requests, pipelines, releases, leden, geheimen en webhooks.
19- `blue-ci-cd.yml`: stages, jobs, `needs`, `rules`, artifacts. Elke job in een eigen container.
19- `blue-ci-cd.yml`: stages, jobs, `needs`, `rules`, artifacts. Elke job in een eigen container.
20- Geheimen als omgevingsvariabelen. Beschermde geheimen alleen op een beschermde branch.
20- Geheimen als omgevingsvariabelen. Beschermde geheimen alleen op een beschermde branch.
@@ -22,7 +22,7 @@ Die keuze houdt de mini-PC klein. Er is geen Postgres, geen Redis en geen aparte
22- Webhooks op repository en groep, met presets voor Discord, Grok Bot en een generieke JSON-webhook.
22- Webhooks op repository en groep, met presets voor Discord, Grok Bot en een generieke JSON-webhook.
23- Een PKGBUILD, een systemd-unit en `packaging/install.sh`.
23- Een PKGBUILD, een systemd-unit en `packaging/install.sh`.
24
24
25Wat nog niet af is, staat in [docs/ROADMAP.md](docs/ROADMAP.md). De vorm van het systeem staat in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). De auth-koppeling staat in [docs/AUTH.md](docs/AUTH.md).
25Wat nog niet af is, staat in [docs/ROADMAP.md](docs/ROADMAP.md). De vorm van het systeem staat in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). De auth-koppeling staat in [docs/AUTH.md](docs/AUTH.md). De ingress staat in [docs/INGRESS.md](docs/INGRESS.md). Besloten en nog open vragen staan in [docs/VRAGEN.md](docs/VRAGEN.md).
26
26
27## Lokaal proberen
27## Lokaal proberen
28
28
@@ -64,22 +64,15 @@ cd packaging/arch && makepkg -si
64
64
65Daarna:
65Daarna:
66
66
671. Mount de 4 TB-schijf, bijvoorbeeld op `/mnt/storage`, en maak `/mnt/storage/bluegit` aan als de gebruiker `bluegit`.
671. Mount de 4 TB-schijf. Het mountpoint is nog niet gekozen. Maak de map voor BlueGit aan als de gebruiker `bluegit`.
682. Zet `storage_path` in `/etc/bluegit/config.yml` op die map.
682. Zet `storage_path` in `/etc/bluegit/config.yml` op die map. `/mnt/storage/bluegit` in het voorbeeld is geen besluit.
693. Kopieer `/usr/share/bluegit/storage.conf.example` naar `/etc/systemd/system/bluegit.service.d/storage.conf`. Zonder die drop-in blokkeert `ProtectSystem` schrijven buiten `/var/lib/bluegit`.
693. Kopieer `/usr/share/bluegit/storage.conf.example` naar `/etc/systemd/system/bluegit.service.d/storage.conf` en pas het pad aan. Zonder die drop-in blokkeert `ProtectSystem` schrijven buiten `/var/lib/bluegit`. De drop-in wordt niet geïnstalleerd, omdat een pad dat niet bestaat de dienst zou tegenhouden.
704. Registreer bij https://auth.timfalken.com/admin het domein `git.timfalken.com` met callback-pad `/auth/callback`. Het client_id is het domein. Het geheim verschijnt één keer.
704. Registreer bij https://auth.timfalken.com/admin het domein `git.timfalken.com` met callback-pad `/auth/callback`. Het client_id is het domein. Het geheim verschijnt één keer.
715. Zet het geheim in `/etc/bluegit/client_secret` (mode `0600`) of in `BLUEGIT_AUTH_CLIENT_SECRET` via `/etc/bluegit/secret.env`.
715. Zet het geheim in `/etc/bluegit/client_secret` (mode `0600`) of in `BLUEGIT_AUTH_CLIENT_SECRET` via `/etc/bluegit/secret.env`.
726. Zet een reverse proxy voor HTTPS. Caddy is genoeg:
726. Zet de ingress op de andere machine. BlueGit zelf blijft plain HTTP. `trusted_proxies` is het adres van die ingress, `base_url` is `https://git.timfalken.com`, en `ssh.public_port` is de poort die gebruikers zien. Het voorbeeld staat in [docs/INGRESS.md](docs/INGRESS.md).
73
74```caddy
75git.timfalken.com {
76 reverse_proxy 127.0.0.1:8080
77}
78```
79
807. `systemctl enable --now bluegit`. De eerste aanmelding wordt installatiebeheerder.
737. `systemctl enable --now bluegit`. De eerste aanmelding wordt installatiebeheerder.
81
74
82SSH voor git luistert op `0.0.0.0:2222`, naast de SSH van het besturingssysteem. De hostkey komt de eerste keer in de opslagmap.
75SSH voor git luistert op `ssh.listen` (in het voorbeeld `0.0.0.0:2222`), naast de SSH van het besturingssysteem. De hostkey komt de eerste keer in de opslagmap. De clone-URL gebruikt `ssh.public_host` en `ssh.public_port`, niet de bindpoort.
83
76
84## Rollen
77## Rollen
85
78
@@ -91,7 +84,9 @@ Een repository hoort bij een gebruiker (die is beheerder) of bij een groep. Iema
91| Ontwikkelaar | ja | ja | nee | nee |
84| Ontwikkelaar | ja | ja | nee | nee |
92| Beheerder | ja | ja | ja | ja |
85| Beheerder | ja | ja | ja | ja |
93
86
94Een ontwikkelaar ziet geheimen niet terug. Een job krijgt ze wel als omgevingsvariabele, anders kan CI er niets mee. Wie een pipeline mag starten, kan een onbeschermd geheim dus uitlezen via `blue-ci-cd.yml`. Markeer een geheim als beschermd als het alleen op een beschermde branch mee mag, en bescherm `main`.
87Een ontwikkelaar ziet geheimen niet terug. Een job krijgt ze wel als omgevingsvariabele, anders kan CI er niets mee. Wie een pipeline mag starten, kan een onbeschermd geheim dus uitlezen via `blue-ci-cd.yml`. Markeer een geheim als beschermd als het alleen op een beschermde branch mee mag, en bescherm `master`.
88
89De installatiebeheerder is geen beheerder van andermans repository. Geheimen, groepen en privérepositories blijven bij de leden.
95
90
96## CI, releases, webhooks
91## CI, releases, webhooks
97
92
@@ -115,4 +110,4 @@ De kern zit in `internal/access` (rollen en beschermde branches), `internal/ci`
115
110
116## Licentie
111## Licentie
117
112
118MIT. Dat is een keuze voor deze basis; zeg het als het anders moet.
113MIT. Zie [LICENSE](LICENSE).
blue-ci-cd.yml +3 −2
@@ -2,8 +2,9 @@
2 2 # Geen speciale behandeling: dezelfde jobs als elke andere repository.
3 3 # Zet op de repository de geheimen DEPLOY_HOST, DEPLOY_USER, DEPLOY_PORT,
4 4 # DEPLOY_PATH en DEPLOY_SSH_KEY. Markeer ze als beschermd, en bescherm de
5 # branch main (en master zolang die de standaard is). Dan komen die
6 # geheimen alleen mee op een beschermde branch.
5 # branch master. Een regel voor main blijft staan, zodat een oude
6 # branch nog kan uitrollen. Dan komen die geheimen alleen mee op een
7 # beschermde branch.
7 8
8 9 stages: [test, build, release, deploy]
9 10
@@ -2,8 +2,9 @@
2# Geen speciale behandeling: dezelfde jobs als elke andere repository.
2# Geen speciale behandeling: dezelfde jobs als elke andere repository.
3# Zet op de repository de geheimen DEPLOY_HOST, DEPLOY_USER, DEPLOY_PORT,
3# Zet op de repository de geheimen DEPLOY_HOST, DEPLOY_USER, DEPLOY_PORT,
4# DEPLOY_PATH en DEPLOY_SSH_KEY. Markeer ze als beschermd, en bescherm de
4# DEPLOY_PATH en DEPLOY_SSH_KEY. Markeer ze als beschermd, en bescherm de
5# branch main (en master zolang die de standaard is). Dan komen die
5# branch master. Een regel voor main blijft staan, zodat een oude
6# geheimen alleen mee op een beschermde branch.
6# branch nog kan uitrollen. Dan komen die geheimen alleen mee op een
7# beschermde branch.
7
8
8stages: [test, build, release, deploy]
9stages: [test, build, release, deploy]
9
10
docs/ARCHITECTURE.md +9 −7
@@ -3,15 +3,17 @@
3 3 BlueGit is één proces. Het bedient de website, de git-HTTP-server, de API en (als het aanstaat) de SSH-listener. Een tweede goroutine plant CI-jobs. Metadata staat in SQLite. Git-objecten staan in bare repositories op de datadisk.
4 4
5 5 ```text
6 browser ──HTTPS──▶ Caddy ──▶ bluegit (web + smart HTTP + API)
7 git ──HTTPS──▶ Caddy ──▶ bluegit ──▶ git http-backend ──▶ pre-receive hook
8 git ──SSH:2222─────────▶ bluegit ──▶ git-receive-pack ──▶ dezelfde hook
6 browser ──HTTPS──▶ ingress ──HTTP──▶ bluegit (web + smart HTTP + API)
7 git ──HTTPS──▶ ingress ──HTTP──▶ bluegit ──▶ git http-backend ──▶ pre-receive hook
8 git ──SSH:22─▶ ingress ──TCP:2222──▶ bluegit ──▶ git-receive-pack ──▶ dezelfde hook
9 9 bluegit ──bearer──▶ auth.timfalken.com
10 10 bluegit ──docker run──▶ jobcontainer
11 11 jobcontainer ──CI_JOB_TOKEN──▶ API van bluegit (release)
12 12 jobcontainer ──SSH-geheim──▶ de host (deploy, gewone SSH)
13 13 ```
14 14
15 De ingress staat op een andere machine en doet TLS en SSH-forwarding. BlueGit luistert plain HTTP op `listen`. Clone-URL's komen uit `base_url` en uit `ssh.public_host` / `ssh.public_port`, niet uit de binnenkomende request. `X-Forwarded-For` en `X-Real-IP` gelden alleen als de directe verbinding van een adres in `trusted_proxies` komt. Het voorbeeld staat in [INGRESS.md](INGRESS.md).
16
15 17 ## Waarom deze vorm
16 18
17 19 De mini-PC moet één ding draaien dat je kunt vervangen door een nieuwe binary. Go levert die binary zonder runtime ernaast. SQLite hoeft geen tweede dienst. De git-binary is toch al nodig voor hooks en merges; smart HTTP gaat daarom via `git http-backend` in plaats van een eigen implementatie van het pack-protocol.
@@ -20,7 +22,7 @@ Docker is alleen de jobgrens die de eis stelt. BlueGit mount de Docker-socket ni
20 22
21 23 ## Schijf
22 24
23 `storage_path` is de wortel, in de voorbeeldconfig `/mnt/storage/bluegit`.
25 `storage_path` is de wortel. Het mountpoint van de 4 TB-schijf is nog niet gekozen. `/mnt/storage/bluegit` in de voorbeeldconfiguratie is alleen een voorbeeld; het echte pad komt in de configuratie en in de systemd-drop-in.
24 26
25 27 ```text
26 28 bluegit.db metadata, mode via het proces van gebruiker bluegit
@@ -46,9 +48,9 @@ Details en de eisen van de auth-server staan in [AUTH.md](AUTH.md).
46 48
47 49 ## Rechten
48 50
49 `internal/access` is bewust los van HTTP en SQL. `Resolve` kiest de hoogste rol uit: installatiebeheerder, persoonlijke eigenaar, groepslid, rechtstreeks lid. `AuthorizeUpdate` keurt een pre-receive-regel goed. De hook is die functie, aangeroepen als `bluegit hook pre-receive`, met de rol en de patronen in de omgeving. Zonder die omgeving weigert de hook, zodat een push om de server heen niet slaagt.
51 `internal/access` is bewust los van HTTP en SQL. `Resolve` kiest de hoogste rol uit persoonlijke eigenaar, groepslid en rechtstreeks lid. `AuthorizeUpdate` keurt een pre-receive-regel goed. De hook is die functie, aangeroepen als `bluegit hook pre-receive`, met de rol en de patronen in de omgeving. Zonder die omgeving weigert de hook, zodat een push om de server heen niet slaagt.
50 52
51 De installatiebeheerder is overal beheerder. Dat is handig op een machine van één persoon, en ruim als er later meer mensen op zitten. Zie de open vragen.
53 De eerste aangemelde gebruiker is installatiebeheerder. `is_admin` van de auth-server wordt opgeslagen en geeft die vlag niet. Installatiebeheer geeft geen lidmaatschap van andermans repositories of groepen en geen inzage in hun geheimen. De vlag is er voor instance-beheer; een scherm daarvoor is er nog niet.
52 54
53 55 ## Web
54 56
@@ -81,4 +83,4 @@ Het branchfilter geldt alleen voor `push`. Andere gebeurtenissen negeren het. Ee
81 83
82 84 De systeemgebruiker `bluegit` kan alles lezen wat op de schijf staat, inclusief geheimen (hij heeft `secret.key`). Mensen op de website kunnen dat niet, behalve een beheerder via het JSON-export dat de auth-server verplicht stelt. CI-jobs zien de geheimen die de regel van beschermde branches toelaat. Ze zien de Docker-socket niet.
83 85
84 Webhooks mogen naar elk http(s)-adres, ook naar iets op het lokale netwerk. Dat is nodig voor een bot naast de mini-PC. Het is ook een manier om een intern adres te raken. Een allowlist staat op de roadmap.
86 Webhooks mogen naar elk http(s)-adres, ook naar iets op het lokale netwerk. Redirects worden niet gevolgd. Of dat zo blijft, is nog open: Tim denkt erover na. Een allowlist staat op de roadmap en wordt niet vastgezet zolang dat open is.
@@ -3,15 +3,17 @@
3BlueGit is één proces. Het bedient de website, de git-HTTP-server, de API en (als het aanstaat) de SSH-listener. Een tweede goroutine plant CI-jobs. Metadata staat in SQLite. Git-objecten staan in bare repositories op de datadisk.
3BlueGit is één proces. Het bedient de website, de git-HTTP-server, de API en (als het aanstaat) de SSH-listener. Een tweede goroutine plant CI-jobs. Metadata staat in SQLite. Git-objecten staan in bare repositories op de datadisk.
4
4
5```text
5```text
6browser ──HTTPS──▶ Caddy ──▶ bluegit (web + smart HTTP + API)
6browser ──HTTPS──▶ ingress ──HTTP──▶ bluegit (web + smart HTTP + API)
7git ──HTTPS──▶ Caddy ──▶ bluegit ──▶ git http-backend ──▶ pre-receive hook
7git ──HTTPS──▶ ingress ──HTTP──▶ bluegit ──▶ git http-backend ──▶ pre-receive hook
8git ──SSH:2222─────────▶ bluegit ──▶ git-receive-pack ──▶ dezelfde hook
8git ──SSH:22─▶ ingress ──TCP:2222──▶ bluegit ──▶ git-receive-pack ──▶ dezelfde hook
9bluegit ──bearer──▶ auth.timfalken.com
9bluegit ──bearer──▶ auth.timfalken.com
10bluegit ──docker run──▶ jobcontainer
10bluegit ──docker run──▶ jobcontainer
11jobcontainer ──CI_JOB_TOKEN──▶ API van bluegit (release)
11jobcontainer ──CI_JOB_TOKEN──▶ API van bluegit (release)
12jobcontainer ──SSH-geheim──▶ de host (deploy, gewone SSH)
12jobcontainer ──SSH-geheim──▶ de host (deploy, gewone SSH)
13```
13```
14
14
15De ingress staat op een andere machine en doet TLS en SSH-forwarding. BlueGit luistert plain HTTP op `listen`. Clone-URL's komen uit `base_url` en uit `ssh.public_host` / `ssh.public_port`, niet uit de binnenkomende request. `X-Forwarded-For` en `X-Real-IP` gelden alleen als de directe verbinding van een adres in `trusted_proxies` komt. Het voorbeeld staat in [INGRESS.md](INGRESS.md).
16
15## Waarom deze vorm
17## Waarom deze vorm
16
18
17De mini-PC moet één ding draaien dat je kunt vervangen door een nieuwe binary. Go levert die binary zonder runtime ernaast. SQLite hoeft geen tweede dienst. De git-binary is toch al nodig voor hooks en merges; smart HTTP gaat daarom via `git http-backend` in plaats van een eigen implementatie van het pack-protocol.
19De mini-PC moet één ding draaien dat je kunt vervangen door een nieuwe binary. Go levert die binary zonder runtime ernaast. SQLite hoeft geen tweede dienst. De git-binary is toch al nodig voor hooks en merges; smart HTTP gaat daarom via `git http-backend` in plaats van een eigen implementatie van het pack-protocol.
@@ -20,7 +22,7 @@ Docker is alleen de jobgrens die de eis stelt. BlueGit mount de Docker-socket ni
20
22
21## Schijf
23## Schijf
22
24
23`storage_path` is de wortel, in de voorbeeldconfig `/mnt/storage/bluegit`.
25`storage_path` is de wortel. Het mountpoint van de 4 TB-schijf is nog niet gekozen. `/mnt/storage/bluegit` in de voorbeeldconfiguratie is alleen een voorbeeld; het echte pad komt in de configuratie en in de systemd-drop-in.
24
26
25```text
27```text
26bluegit.db metadata, mode via het proces van gebruiker bluegit
28bluegit.db metadata, mode via het proces van gebruiker bluegit
@@ -46,9 +48,9 @@ Details en de eisen van de auth-server staan in [AUTH.md](AUTH.md).
46
48
47## Rechten
49## Rechten
48
50
49`internal/access` is bewust los van HTTP en SQL. `Resolve` kiest de hoogste rol uit: installatiebeheerder, persoonlijke eigenaar, groepslid, rechtstreeks lid. `AuthorizeUpdate` keurt een pre-receive-regel goed. De hook is die functie, aangeroepen als `bluegit hook pre-receive`, met de rol en de patronen in de omgeving. Zonder die omgeving weigert de hook, zodat een push om de server heen niet slaagt.
51`internal/access` is bewust los van HTTP en SQL. `Resolve` kiest de hoogste rol uit persoonlijke eigenaar, groepslid en rechtstreeks lid. `AuthorizeUpdate` keurt een pre-receive-regel goed. De hook is die functie, aangeroepen als `bluegit hook pre-receive`, met de rol en de patronen in de omgeving. Zonder die omgeving weigert de hook, zodat een push om de server heen niet slaagt.
50
52
51De installatiebeheerder is overal beheerder. Dat is handig op een machine van één persoon, en ruim als er later meer mensen op zitten. Zie de open vragen.
53De eerste aangemelde gebruiker is installatiebeheerder. `is_admin` van de auth-server wordt opgeslagen en geeft die vlag niet. Installatiebeheer geeft geen lidmaatschap van andermans repositories of groepen en geen inzage in hun geheimen. De vlag is er voor instance-beheer; een scherm daarvoor is er nog niet.
52
54
53## Web
55## Web
54
56
@@ -81,4 +83,4 @@ Het branchfilter geldt alleen voor `push`. Andere gebeurtenissen negeren het. Ee
81
83
82De systeemgebruiker `bluegit` kan alles lezen wat op de schijf staat, inclusief geheimen (hij heeft `secret.key`). Mensen op de website kunnen dat niet, behalve een beheerder via het JSON-export dat de auth-server verplicht stelt. CI-jobs zien de geheimen die de regel van beschermde branches toelaat. Ze zien de Docker-socket niet.
84De systeemgebruiker `bluegit` kan alles lezen wat op de schijf staat, inclusief geheimen (hij heeft `secret.key`). Mensen op de website kunnen dat niet, behalve een beheerder via het JSON-export dat de auth-server verplicht stelt. CI-jobs zien de geheimen die de regel van beschermde branches toelaat. Ze zien de Docker-socket niet.
83
85
84Webhooks mogen naar elk http(s)-adres, ook naar iets op het lokale netwerk. Dat is nodig voor een bot naast de mini-PC. Het is ook een manier om een intern adres te raken. Een allowlist staat op de roadmap.
86Webhooks mogen naar elk http(s)-adres, ook naar iets op het lokale netwerk. Redirects worden niet gevolgd. Of dat zo blijft, is nog open: Tim denkt erover na. Een allowlist staat op de roadmap en wordt niet vastgezet zolang dat open is.
docs/AUTH.md +3 −3
@@ -19,7 +19,7 @@ grant_type=authorization_code&code=…&redirect_uri=…&client_id=…&client_sec
19 19 ```
20 20
21 21 5. Het antwoord bevat `access_token`, `expires_in` (86400) en `user` met `id`, `username` en `avatar_url`. Geen e-mailadres.
22 6. `GET /api/me` met `Authorization: Bearer` vult `is_admin`, `email_verified` en `passkey_only` aan. `is_admin` is beheerder van de auth-server, niet van BlueGit.
22 6. `GET /api/me` met `Authorization: Bearer` vult `is_admin`, `email_verified` en `passkey_only` aan. `is_admin` is beheerder van de auth-server. Dat wordt geen BlueGit-beheerder. Alleen de eerste aangemelde gebruiker van deze installatie is dat, en die vlag geeft geen toegang tot andermans repositories, groepen of geheimen.
23 23 7. `POST /api/session/extend` schuift de 24 uur op. `POST /api/logout` trekt het token in.
24 24 8. Elke verbonden site moet een knop hebben waarmee de ingelogde gebruiker meteen zijn gegevens als JSON krijgt. Dat is `Account → Gegevens downloaden` (`GET /settings/export`).
25 25
@@ -27,9 +27,9 @@ BlueGit stuurt op elk server-naar-server-verzoek `User-Agent: BlueGitAccountClie
27 27
28 28 ## Wat BlueGit bewaart
29 29
30 Van het account: het numerieke id, de gebruikersnaam in kleine letters, de avatar-URL, en of die persoon op de auth-server beheerder is. Geen e-mail. Het bearer-token blijft in de sessietabel tot afmelden of verlopen.
30 Van het account: het numerieke id, de gebruikersnaam in kleine letters, de avatar-URL, en of die persoon op de auth-server beheerder is. Geen e-mail. Een merge vanaf de website gebruikt daarom `{naam}@users.git.timfalken.com` als afzender. Het bearer-token blijft in de sessietabel tot afmelden of verlopen.
31 31
32 SSH-sleutels op de auth-server zijn er voor aanmelden dáár (`POST /api/ssh-login/challenge` en `/verify`, namespace `timfalken-account`). Er is geen API waarmee een verbonden site die sleutels mag ophalen. BlueGit houdt daarom eigen sleutels bij voor git-over-SSH. Ze worden geplakt op de accountpagina.
32 SSH-sleutels op de auth-server zijn er voor aanmelden dáár (`POST /api/ssh-login/challenge` en `/verify`, namespace `timfalken-account`). Er komt geen API waarmee een verbonden site die sleutels ophaalt. BlueGit houdt eigen sleutels bij voor git-over-SSH. Ze worden geplakt op de accountpagina.
33 33
34 34 ## Configuratie
35 35
@@ -19,7 +19,7 @@ grant_type=authorization_code&code=…&redirect_uri=…&client_id=…&client_sec
19```
19```
20
20
215. Het antwoord bevat `access_token`, `expires_in` (86400) en `user` met `id`, `username` en `avatar_url`. Geen e-mailadres.
215. Het antwoord bevat `access_token`, `expires_in` (86400) en `user` met `id`, `username` en `avatar_url`. Geen e-mailadres.
226. `GET /api/me` met `Authorization: Bearer` vult `is_admin`, `email_verified` en `passkey_only` aan. `is_admin` is beheerder van de auth-server, niet van BlueGit.
226. `GET /api/me` met `Authorization: Bearer` vult `is_admin`, `email_verified` en `passkey_only` aan. `is_admin` is beheerder van de auth-server. Dat wordt geen BlueGit-beheerder. Alleen de eerste aangemelde gebruiker van deze installatie is dat, en die vlag geeft geen toegang tot andermans repositories, groepen of geheimen.
237. `POST /api/session/extend` schuift de 24 uur op. `POST /api/logout` trekt het token in.
237. `POST /api/session/extend` schuift de 24 uur op. `POST /api/logout` trekt het token in.
248. Elke verbonden site moet een knop hebben waarmee de ingelogde gebruiker meteen zijn gegevens als JSON krijgt. Dat is `Account → Gegevens downloaden` (`GET /settings/export`).
248. Elke verbonden site moet een knop hebben waarmee de ingelogde gebruiker meteen zijn gegevens als JSON krijgt. Dat is `Account → Gegevens downloaden` (`GET /settings/export`).
25
25
@@ -27,9 +27,9 @@ BlueGit stuurt op elk server-naar-server-verzoek `User-Agent: BlueGitAccountClie
27
27
28## Wat BlueGit bewaart
28## Wat BlueGit bewaart
29
29
30Van het account: het numerieke id, de gebruikersnaam in kleine letters, de avatar-URL, en of die persoon op de auth-server beheerder is. Geen e-mail. Het bearer-token blijft in de sessietabel tot afmelden of verlopen.
30Van het account: het numerieke id, de gebruikersnaam in kleine letters, de avatar-URL, en of die persoon op de auth-server beheerder is. Geen e-mail. Een merge vanaf de website gebruikt daarom `{naam}@users.git.timfalken.com` als afzender. Het bearer-token blijft in de sessietabel tot afmelden of verlopen.
31
31
32SSH-sleutels op de auth-server zijn er voor aanmelden dáár (`POST /api/ssh-login/challenge` en `/verify`, namespace `timfalken-account`). Er is geen API waarmee een verbonden site die sleutels mag ophalen. BlueGit houdt daarom eigen sleutels bij voor git-over-SSH. Ze worden geplakt op de accountpagina.
32SSH-sleutels op de auth-server zijn er voor aanmelden dáár (`POST /api/ssh-login/challenge` en `/verify`, namespace `timfalken-account`). Er komt geen API waarmee een verbonden site die sleutels ophaalt. BlueGit houdt eigen sleutels bij voor git-over-SSH. Ze worden geplakt op de accountpagina.
33
33
34## Configuratie
34## Configuratie
35
35
docs/CI.md +1 −1
@@ -14,7 +14,7 @@ jobs:
14 14 script:
15 15 - go test ./...
16 16 rules:
17 - if: $CI_COMMIT_BRANCH == "main"
17 - if: $CI_COMMIT_BRANCH == "master"
18 18 - if: $CI_COMMIT_BRANCH =~ /^release\/.*/
19 19 build:
20 20 stage: build
@@ -14,7 +14,7 @@ jobs:
14 script:
14 script:
15 - go test ./...
15 - go test ./...
16 rules:
16 rules:
17 - if: $CI_COMMIT_BRANCH == "main"
17 - if: $CI_COMMIT_BRANCH == "master"
18 - if: $CI_COMMIT_BRANCH =~ /^release\/.*/
18 - if: $CI_COMMIT_BRANCH =~ /^release\/.*/
19 build:
19 build:
20 stage: build
20 stage: build
docs/INGRESS.md added +64 −0
@@ -0,0 +1,64 @@
1 # Ingress
2
3 BlueGit staat op de mini-PC en spreekt plain HTTP. TLS, certificaten en de publieke SSH-poort horen bij een ingress op een andere machine. Die machine is de enige die vanaf internet bij de mini-PC mag.
4
5 BlueGit bouwt URL's niet uit de binnenkomende `Host`-kop. De externe website is `base_url`. De SSH-clone-URL is `ssh.public_host` en `ssh.public_port`. `listen` en `ssh.listen` zijn alleen de adressen waarop dit proces bindt.
6
7 ## BlueGit
8
9 ```yaml
10 base_url: https://git.timfalken.com
11 listen: 0.0.0.0:8080
12 trusted_proxies:
13 - 10.0.0.2
14 ssh:
15 enabled: true
16 listen: 0.0.0.0:2222
17 public_host: git.timfalken.com
18 public_port: 22
19 ```
20
21 `10.0.0.2` is het adres waarvan de mini-PC de verbinding van de ingress ziet. Een verkeerd adres betekent dat `X-Forwarded-For` genegeerd wordt. Een te ruime lijst, zoals `0.0.0.0/0`, laat elke client zijn adres vervalsen. `behind_proxy: true` uit een oudere configuratie wordt geweigerd.
22
23 In `X-Forwarded-For` telt de rechtse hop die zelf niet op de lijst staat. Een client die `6.6.6.6` vooraan zet, wint daarmee niet van het adres dat de ingress erachter plakt. Ontbreekt die kop, dan geldt `X-Real-IP`, maar alleen vanaf een vertrouwde proxy. `X-Forwarded-Proto` wordt niet gebruikt: de cookie en de OAuth-redirect volgen `base_url`.
24
25 Beperk met de firewall op de mini-PC poort 8080 en 2222 tot de ingress. `listen` op `0.0.0.0` is bereikbaar voor iedereen die tot het netwerk van de mini-PC kan.
26
27 ## Voorbeeld op de ingress
28
29 Caddy doet HTTPS en stuurt door naar de mini-PC. Vervang `10.0.0.5` door het adres van de mini-PC.
30
31 ```caddyfile
32 git.timfalken.com {
33 reverse_proxy 10.0.0.5:8080
34 }
35 ```
36
37 Caddy zet `X-Forwarded-For` en `X-Forwarded-Proto`. Het certificaat komt van Caddy; BlueGit ziet geen TLS.
38
39 SSH is geen HTTP. De ingress stuurt de TCP-stroom door, zodat de hostkey van BlueGit is wat de client controleert. Met de Caddy-module `caddy-l4`:
40
41 ```caddyfile
42 {
43 layer4 {
44 :22 {
45 route {
46 proxy 10.0.0.5:2222
47 }
48 }
49 }
50 }
51 ```
52
53 Zonder die module kan nginx hetzelfde op de stream-laag:
54
55 ```nginx
56 stream {
57 server {
58 listen 22;
59 proxy_pass 10.0.0.5:2222;
60 }
61 }
62 ```
63
64 De clone-URL op de website is dan `ssh://git@git.timfalken.com:22/eigenaar/naam.git`. Op de mini-PC blijft git-SSH op poort 2222 luisteren, naast de SSH van Arch.
@@ -0,0 +1,64 @@
1# Ingress
2
3BlueGit staat op de mini-PC en spreekt plain HTTP. TLS, certificaten en de publieke SSH-poort horen bij een ingress op een andere machine. Die machine is de enige die vanaf internet bij de mini-PC mag.
4
5BlueGit bouwt URL's niet uit de binnenkomende `Host`-kop. De externe website is `base_url`. De SSH-clone-URL is `ssh.public_host` en `ssh.public_port`. `listen` en `ssh.listen` zijn alleen de adressen waarop dit proces bindt.
6
7## BlueGit
8
9```yaml
10base_url: https://git.timfalken.com
11listen: 0.0.0.0:8080
12trusted_proxies:
13 - 10.0.0.2
14ssh:
15 enabled: true
16 listen: 0.0.0.0:2222
17 public_host: git.timfalken.com
18 public_port: 22
19```
20
21`10.0.0.2` is het adres waarvan de mini-PC de verbinding van de ingress ziet. Een verkeerd adres betekent dat `X-Forwarded-For` genegeerd wordt. Een te ruime lijst, zoals `0.0.0.0/0`, laat elke client zijn adres vervalsen. `behind_proxy: true` uit een oudere configuratie wordt geweigerd.
22
23In `X-Forwarded-For` telt de rechtse hop die zelf niet op de lijst staat. Een client die `6.6.6.6` vooraan zet, wint daarmee niet van het adres dat de ingress erachter plakt. Ontbreekt die kop, dan geldt `X-Real-IP`, maar alleen vanaf een vertrouwde proxy. `X-Forwarded-Proto` wordt niet gebruikt: de cookie en de OAuth-redirect volgen `base_url`.
24
25Beperk met de firewall op de mini-PC poort 8080 en 2222 tot de ingress. `listen` op `0.0.0.0` is bereikbaar voor iedereen die tot het netwerk van de mini-PC kan.
26
27## Voorbeeld op de ingress
28
29Caddy doet HTTPS en stuurt door naar de mini-PC. Vervang `10.0.0.5` door het adres van de mini-PC.
30
31```caddyfile
32git.timfalken.com {
33 reverse_proxy 10.0.0.5:8080
34}
35```
36
37Caddy zet `X-Forwarded-For` en `X-Forwarded-Proto`. Het certificaat komt van Caddy; BlueGit ziet geen TLS.
38
39SSH is geen HTTP. De ingress stuurt de TCP-stroom door, zodat de hostkey van BlueGit is wat de client controleert. Met de Caddy-module `caddy-l4`:
40
41```caddyfile
42{
43 layer4 {
44 :22 {
45 route {
46 proxy 10.0.0.5:2222
47 }
48 }
49 }
50}
51```
52
53Zonder die module kan nginx hetzelfde op de stream-laag:
54
55```nginx
56stream {
57 server {
58 listen 22;
59 proxy_pass 10.0.0.5:2222;
60 }
61}
62```
63
64De clone-URL op de website is dan `ssh://git@git.timfalken.com:22/eigenaar/naam.git`. Op de mini-PC blijft git-SSH op poort 2222 luisteren, naast de SSH van Arch.
docs/ROADMAP.md +3 −3
@@ -14,11 +14,11 @@ Deze basis is genoeg om repositories te bewaren, te klonen, een pipeline te draa
14 14
15 15 ## Daarna, in deze volgorde
16 16
17 1. **Productie aanzetten.** Domein registreren, schijf mounten, Caddy, eerste aanmelding, `main` beschermen, deploy-geheimen zetten, één keer met de hand deployen, daarna de pipeline.
18 2. **SSH in de praktijk.** Hostkey publiceren, `known_hosts`, en beslissen of poort 22 van de mini-PC vrij is. Foutmeldingen van de hook doorzetten naar de git-client zijn er al via stderr; de UX van een geweigerde push kan scherper.
17 1. **Productie aanzetten.** Domein registreren, de schijf mounten op het pad dat dan gekozen is, de ingress uit [INGRESS.md](INGRESS.md) zetten, eerste aanmelding, `master` beschermen, deploy-geheimen zetten, één keer met de hand deployen, daarna de pipeline.
18 2. **SSH in de praktijk.** Hostkey publiceren en `known_hosts` vullen. De publieke poort is `ssh.public_port` op de ingress; op de mini-PC blijft `ssh.listen` configureerbaar. Foutmeldingen van de hook gaan al via stderr naar de git-client; de UX van een geweigerde push kan scherper.
19 19 3. **Merge requests verder.** Opmerkingen, een echte diff in plaats van `git log --oneline`, en een pipeline die groen moet zijn voor het samenvoegen.
20 20 4. **CI.** Services naast een job (een database voor tests), een cache, live logs in plaats van het log na afloop, en opruimen van verlopen artifacts. Een tweede runner op een andere machine als de mini-PC het niet trekt.
21 5. **Webhooks.** Een allowlist of een vlag "ook privé-adressen", een opnieuw-proberen, en een knop die een testgebeurtenis stuurt.
21 5. **Webhooks.** Tim beslist nog of privé-adressen dicht mogen. Daarna pas een allowlist of een vlag "ook privé-adressen". Verder: opnieuw proberen, en een knop die een testgebeurtenis stuurt.
22 22 6. **Git.** LFS als de 4 TB-schijf grote bestanden moet dragen, signed commits, en mirrors. Force-push op een beschermde branch is nu toegestaan voor een beheerder; een aparte schakelaar hoort daarbij.
23 23 7. **Account.** Uitnodigen voordat iemand ooit is aangemeld werkt al op gebruikersnaam. Een zoekfunctie ontbreekt, omdat de auth-server geen lijst van alle gebruikers aan een site geeft. E-mail naar een gebruiker kan later via `POST /api/email` van de auth-server, zonder het adres te zien.
24 24 8. **Huiswerk van de server.** Versleutelde sessietokens, back-ups van `storage_path` (database én repositories), en een limiet op webhookverkeer.
@@ -14,11 +14,11 @@ Deze basis is genoeg om repositories te bewaren, te klonen, een pipeline te draa
14
14
15## Daarna, in deze volgorde
15## Daarna, in deze volgorde
16
16
171. **Productie aanzetten.** Domein registreren, schijf mounten, Caddy, eerste aanmelding, `main` beschermen, deploy-geheimen zetten, één keer met de hand deployen, daarna de pipeline.
171. **Productie aanzetten.** Domein registreren, de schijf mounten op het pad dat dan gekozen is, de ingress uit [INGRESS.md](INGRESS.md) zetten, eerste aanmelding, `master` beschermen, deploy-geheimen zetten, één keer met de hand deployen, daarna de pipeline.
182. **SSH in de praktijk.** Hostkey publiceren, `known_hosts`, en beslissen of poort 22 van de mini-PC vrij is. Foutmeldingen van de hook doorzetten naar de git-client zijn er al via stderr; de UX van een geweigerde push kan scherper.
182. **SSH in de praktijk.** Hostkey publiceren en `known_hosts` vullen. De publieke poort is `ssh.public_port` op de ingress; op de mini-PC blijft `ssh.listen` configureerbaar. Foutmeldingen van de hook gaan al via stderr naar de git-client; de UX van een geweigerde push kan scherper.
193. **Merge requests verder.** Opmerkingen, een echte diff in plaats van `git log --oneline`, en een pipeline die groen moet zijn voor het samenvoegen.
193. **Merge requests verder.** Opmerkingen, een echte diff in plaats van `git log --oneline`, en een pipeline die groen moet zijn voor het samenvoegen.
204. **CI.** Services naast een job (een database voor tests), een cache, live logs in plaats van het log na afloop, en opruimen van verlopen artifacts. Een tweede runner op een andere machine als de mini-PC het niet trekt.
204. **CI.** Services naast een job (een database voor tests), een cache, live logs in plaats van het log na afloop, en opruimen van verlopen artifacts. Een tweede runner op een andere machine als de mini-PC het niet trekt.
215. **Webhooks.** Een allowlist of een vlag "ook privé-adressen", een opnieuw-proberen, en een knop die een testgebeurtenis stuurt.
215. **Webhooks.** Tim beslist nog of privé-adressen dicht mogen. Daarna pas een allowlist of een vlag "ook privé-adressen". Verder: opnieuw proberen, en een knop die een testgebeurtenis stuurt.
226. **Git.** LFS als de 4 TB-schijf grote bestanden moet dragen, signed commits, en mirrors. Force-push op een beschermde branch is nu toegestaan voor een beheerder; een aparte schakelaar hoort daarbij.
226. **Git.** LFS als de 4 TB-schijf grote bestanden moet dragen, signed commits, en mirrors. Force-push op een beschermde branch is nu toegestaan voor een beheerder; een aparte schakelaar hoort daarbij.
237. **Account.** Uitnodigen voordat iemand ooit is aangemeld werkt al op gebruikersnaam. Een zoekfunctie ontbreekt, omdat de auth-server geen lijst van alle gebruikers aan een site geeft. E-mail naar een gebruiker kan later via `POST /api/email` van de auth-server, zonder het adres te zien.
237. **Account.** Uitnodigen voordat iemand ooit is aangemeld werkt al op gebruikersnaam. Een zoekfunctie ontbreekt, omdat de auth-server geen lijst van alle gebruikers aan een site geeft. E-mail naar een gebruiker kan later via `POST /api/email` van de auth-server, zonder het adres te zien.
248. **Huiswerk van de server.** Versleutelde sessietokens, back-ups van `storage_path` (database én repositories), en een limiet op webhookverkeer.
248. **Huiswerk van de server.** Versleutelde sessietokens, back-ups van `storage_path` (database én repositories), en een limiet op webhookverkeer.
docs/VRAGEN.md +18 −13
@@ -1,13 +1,18 @@
1 # Open vragen
2
3 Dit zijn de punten waar de basis een keuze maakte omdat het antwoord niet vaststond. Ze staan ook in het verslag bij de merge request.
4
5 1. Moet `is_admin` van auth.timfalken.com automatisch installatiebeheerder van BlueGit zijn? Nu wordt alleen de eerste aangemelde gebruiker dat. `is_admin` wordt wel opgeslagen, maar geeft geen rechten.
6 2. De auth-server deelt SSH-sleutels niet met een verbonden site. BlueGit heeft daarom eigen sleutels. Is een API op de auth-server wenselijk, zodat één sleutel overal werkt?
7 3. Standaardbranch van een nieuwe repository is `main`. De GitLab-repository van BlueGit zelf heet `master`. Moet de standaard `master` zijn, of houden we `main` en een regel voor beide in de pipeline?
8 4. Git-commits vanuit de website (een merge) gebruiken `{naam}@users.git.timfalken.com`, omdat we geen e-mailadres krijgen. Is dat het afzenderadres dat je wilt?
9 5. Moet de installatiebeheerder overal beheerder blijven, inclusief geheimen, als er later andere mensen op de server komen?
10 6. SSH voor git staat op poort 2222, zodat de SSH van Arch vrij blijft. Mag het poort 22 worden als er niets anders luistert?
11 7. Webhooks mogen elk http(s)-adres aanroepen, ook op het lokale netwerk. Wil je dat dichtzetten, met een uitzondering voor de Grok-bot?
12 8. De licentie in deze basis is MIT. Klopt dat?
13 9. De schijf in het voorbeeld is `/mnt/storage/bluegit`. Hoe heet het mountpoint op de mini-PC echt?
1 # Besluiten
2
3 Tim heeft deze punten beantwoord. Wat hieronder staat is de huidige regel, niet meer een open vraag.
4
5 ## Besloten
6
7 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.
8 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.
9 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.
10 4. **Het afzenderadres van een merge is `{naam}@users.git.timfalken.com`.** De auth-server geeft geen e-mailadres.
11 5. **De installatiebeheerder krijgt geen automatische toegang tot de repositories, groepen en geheimen van anderen.** Die vlag is alleen voor instance-beheer. Er is nog geen apart scherm daarvoor; de vlag geeft nu dus geen extra pagina's en geen extra data.
12 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).
13 8. **De licentie is MIT.**
14 9. **Het mountpoint van de 4 TB-schijf is nog niet gekozen.** `storage_path` blijft configureerbaar. `/mnt/storage/bluegit` in de voorbeeldconfiguratie en in `packaging/storage.conf` is alleen een voorbeeld; pas het aan het echte pad aan. De systemd-drop-in wordt niet automatisch geactiveerd, omdat een pad dat niet bestaat de dienst zou blokkeren.
15
16 ## Nog open
17
18 7. **Webhooks mogen elk http(s)-adres aanroepen, ook op een privénetwerk.** Tim denkt hier nog over na. Het gedrag blijft zoals het is: redirects worden niet gevolgd, en een URL met gebruikersnaam of wachtwoord erin wordt geweigerd. Een allowlist staat op de roadmap en wordt niet vastgezet zolang dit open is.
@@ -1,13 +1,18 @@
1# Open vragen
1# Besluiten
2
2
3Dit zijn de punten waar de basis een keuze maakte omdat het antwoord niet vaststond. Ze staan ook in het verslag bij de merge request.
3Tim heeft deze punten beantwoord. Wat hieronder staat is de huidige regel, niet meer een open vraag.
4
4
51. Moet `is_admin` van auth.timfalken.com automatisch installatiebeheerder van BlueGit zijn? Nu wordt alleen de eerste aangemelde gebruiker dat. `is_admin` wordt wel opgeslagen, maar geeft geen rechten.
5## Besloten
62. De auth-server deelt SSH-sleutels niet met een verbonden site. BlueGit heeft daarom eigen sleutels. Is een API op de auth-server wenselijk, zodat één sleutel overal werkt?
6
73. Standaardbranch van een nieuwe repository is `main`. De GitLab-repository van BlueGit zelf heet `master`. Moet de standaard `master` zijn, of houden we `main` en een regel voor beide in de pipeline?
71. **`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.
84. Git-commits vanuit de website (een merge) gebruiken `{naam}@users.git.timfalken.com`, omdat we geen e-mailadres krijgen. Is dat het afzenderadres dat je wilt?
82. **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.
95. Moet de installatiebeheerder overal beheerder blijven, inclusief geheimen, als er later andere mensen op de server komen?
93. **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.
106. SSH voor git staat op poort 2222, zodat de SSH van Arch vrij blijft. Mag het poort 22 worden als er niets anders luistert?
104. **Het afzenderadres van een merge is `{naam}@users.git.timfalken.com`.** De auth-server geeft geen e-mailadres.
117. Webhooks mogen elk http(s)-adres aanroepen, ook op het lokale netwerk. Wil je dat dichtzetten, met een uitzondering voor de Grok-bot?
115. **De installatiebeheerder krijgt geen automatische toegang tot de repositories, groepen en geheimen van anderen.** Die vlag is alleen voor instance-beheer. Er is nog geen apart scherm daarvoor; de vlag geeft nu dus geen extra pagina's en geen extra data.
128. De licentie in deze basis is MIT. Klopt dat?
126. **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).
139. De schijf in het voorbeeld is `/mnt/storage/bluegit`. Hoe heet het mountpoint op de mini-PC echt?
138. **De licentie is MIT.**
149. **Het mountpoint van de 4 TB-schijf is nog niet gekozen.** `storage_path` blijft configureerbaar. `/mnt/storage/bluegit` in de voorbeeldconfiguratie en in `packaging/storage.conf` is alleen een voorbeeld; pas het aan het echte pad aan. De systemd-drop-in wordt niet automatisch geactiveerd, omdat een pad dat niet bestaat de dienst zou blokkeren.
15
16## Nog open
17
187. **Webhooks mogen elk http(s)-adres aanroepen, ook op een privénetwerk.** Tim denkt hier nog over na. Het gedrag blijft zoals het is: redirects worden niet gevolgd, en een URL met gebruikersnaam of wachtwoord erin wordt geweigerd. Een allowlist staat op de roadmap en wordt niet vastgezet zolang dit open is.
internal/access/access.go +6 −5
@@ -2,6 +2,8 @@
2 2 // Een repository hoort bij een gebruiker of een groep. Leden hebben
3 3 // Readonly, Developer of Maintainer. De effectieve rol is de hoogste
4 4 // van groepslidmaatschap, rechtstreeks repolidmaatschap en eigenaarschap.
5 // Installatiebeheer is hier geen rol: dat geeft geen toegang tot
6 // repositories, groepen of geheimen van anderen.
5 7 package access
6 8
7 9 import (
@@ -105,9 +107,8 @@ func (r Role) CanMerge(targetProtected bool) bool {
105 107 }
106 108
107 109 // Input is alles wat meespeelt bij de effectieve rol op één repository.
110 // Installatiebeheer zit hier bewust niet in.
108 111 type Input struct {
109 // InstanceAdmin is beheerder van deze BlueGit-installatie.
110 InstanceAdmin bool
111 112 // UserOwner is waar als de repository van deze gebruiker zelf is.
112 113 UserOwner bool
113 114 // GroupRole is de rol in de groep die de repository bezit. Leeg als
@@ -118,10 +119,10 @@ type Input struct {
118 119 }
119 120
120 121 // Resolve kiest de effectieve rol.
121 // De installatiebeheerder en de persoonlijke eigenaar zijn beheerder.
122 // Anders geldt de hoogste van groepsrol en repositoryrol.
122 // De persoonlijke eigenaar is beheerder. Anders geldt de hoogste van
123 // groepsrol en repositoryrol.
123 124 func Resolve(in Input) Role {
124 if in.InstanceAdmin || in.UserOwner {
125 if in.UserOwner {
125 126 return RoleMaintainer
126 127 }
127 128 return Max(in.GroupRole, in.RepoRole)
@@ -2,6 +2,8 @@
2// Een repository hoort bij een gebruiker of een groep. Leden hebben
2// Een repository hoort bij een gebruiker of een groep. Leden hebben
3// Readonly, Developer of Maintainer. De effectieve rol is de hoogste
3// Readonly, Developer of Maintainer. De effectieve rol is de hoogste
4// van groepslidmaatschap, rechtstreeks repolidmaatschap en eigenaarschap.
4// van groepslidmaatschap, rechtstreeks repolidmaatschap en eigenaarschap.
5// Installatiebeheer is hier geen rol: dat geeft geen toegang tot
6// repositories, groepen of geheimen van anderen.
5package access
7package access
6
8
7import (
9import (
@@ -105,9 +107,8 @@ func (r Role) CanMerge(targetProtected bool) bool {
105}
107}
106
108
107// Input is alles wat meespeelt bij de effectieve rol op één repository.
109// Input is alles wat meespeelt bij de effectieve rol op één repository.
110// Installatiebeheer zit hier bewust niet in.
108type Input struct {
111type Input struct {
109 // InstanceAdmin is beheerder van deze BlueGit-installatie.
110 InstanceAdmin bool
111 // UserOwner is waar als de repository van deze gebruiker zelf is.
112 // UserOwner is waar als de repository van deze gebruiker zelf is.
112 UserOwner bool
113 UserOwner bool
113 // GroupRole is de rol in de groep die de repository bezit. Leeg als
114 // GroupRole is de rol in de groep die de repository bezit. Leeg als
@@ -118,10 +119,10 @@ type Input struct {
118}
119}
119
120
120// Resolve kiest de effectieve rol.
121// Resolve kiest de effectieve rol.
121// De installatiebeheerder en de persoonlijke eigenaar zijn beheerder.
122// De persoonlijke eigenaar is beheerder. Anders geldt de hoogste van
122// Anders geldt de hoogste van groepsrol en repositoryrol.
123// groepsrol en repositoryrol.
123func Resolve(in Input) Role {
124func Resolve(in Input) Role {
124 if in.InstanceAdmin || in.UserOwner {
125 if in.UserOwner {
125 return RoleMaintainer
126 return RoleMaintainer
126 }
127 }
127 return Max(in.GroupRole, in.RepoRole)
128 return Max(in.GroupRole, in.RepoRole)
internal/access/access_test.go +0 −3
@@ -36,9 +36,6 @@ func TestResolve(t *testing.T) {
36 36 if Resolve(Input{UserOwner: true}) != RoleMaintainer {
37 37 t.Fatal("eigenaar is beheerder")
38 38 }
39 if Resolve(Input{InstanceAdmin: true}) != RoleMaintainer {
40 t.Fatal("installatiebeheerder is beheerder")
41 }
42 39 got := Resolve(Input{GroupRole: RoleReadonly, RepoRole: RoleDeveloper})
43 40 if got != RoleDeveloper {
44 41 t.Fatalf("hoogste rol, kreeg %s", got)
@@ -36,9 +36,6 @@ func TestResolve(t *testing.T) {
36 if Resolve(Input{UserOwner: true}) != RoleMaintainer {
36 if Resolve(Input{UserOwner: true}) != RoleMaintainer {
37 t.Fatal("eigenaar is beheerder")
37 t.Fatal("eigenaar is beheerder")
38 }
38 }
39 if Resolve(Input{InstanceAdmin: true}) != RoleMaintainer {
40 t.Fatal("installatiebeheerder is beheerder")
41 }
42 got := Resolve(Input{GroupRole: RoleReadonly, RepoRole: RoleDeveloper})
39 got := Resolve(Input{GroupRole: RoleReadonly, RepoRole: RoleDeveloper})
43 if got != RoleDeveloper {
40 if got != RoleDeveloper {
44 t.Fatalf("hoogste rol, kreeg %s", got)
41 t.Fatalf("hoogste rol, kreeg %s", got)
internal/config/config.go +103 −17
@@ -3,23 +3,31 @@ package config
3 3
4 4 import (
5 5 "fmt"
6 "net"
6 7 "net/url"
7 8 "os"
9 "strconv"
8 10 "strings"
9 11
12 "gitlab.com/Timfa/bluegit/internal/realip"
10 13 "gopkg.in/yaml.v3"
11 14 )
12 15
13 16 // Config is de installatie op de mini-PC.
14 17 type Config struct {
15 BaseURL string `yaml:"base_url"`
16 Listen string `yaml:"listen"`
17 StoragePath string `yaml:"storage_path"`
18 BehindProxy bool `yaml:"behind_proxy"`
19 Auth Auth `yaml:"auth"`
20 Git Git `yaml:"git"`
21 SSH SSH `yaml:"ssh"`
22 CI CI `yaml:"ci"`
18 BaseURL string `yaml:"base_url"`
19 Listen string `yaml:"listen"`
20 StoragePath string `yaml:"storage_path"`
21 TrustedProxies []string `yaml:"trusted_proxies"`
22 // BehindProxy is het oude veld. Het wordt geweigerd: één boolean
23 // vertrouwt ofwel iedereen, ofwel niemand. De lijst hierboven beslist.
24 BehindProxy bool `yaml:"behind_proxy"`
25 Auth Auth `yaml:"auth"`
26 Git Git `yaml:"git"`
27 SSH SSH `yaml:"ssh"`
28 CI CI `yaml:"ci"`
29
30 proxies *realip.Set
23 31 }
24 32
25 33 // Auth wijst naar auth.timfalken.com of naar de lokale ontwikkelmodus.
@@ -42,10 +50,14 @@ type Git struct {
42 50 HookBinary string `yaml:"hook_binary"`
43 51 }
44 52
45 // SSH is de git-over-SSH-listener.
53 // SSH is de git-over-SSH-listener en het adres dat in clone-URL's staat.
54 // Listen is waar dit proces bindt. PublicHost en PublicPort zijn wat
55 // een gebruiker ziet; de ingress kan daar een andere poort voor gebruiken.
46 56 type SSH struct {
47 Enabled bool `yaml:"enabled"`
48 Listen string `yaml:"listen"`
57 Enabled bool `yaml:"enabled"`
58 Listen string `yaml:"listen"`
59 PublicHost string `yaml:"public_host"`
60 PublicPort int `yaml:"public_port"`
49 61 }
50 62
51 63 // CI stuurt de Docker-runner.
@@ -116,7 +128,7 @@ func (c *Config) applyDefaults() {
116 128 c.Git.Binary = "git"
117 129 }
118 130 if c.Git.DefaultBranch == "" {
119 c.Git.DefaultBranch = "main"
131 c.Git.DefaultBranch = "master"
120 132 }
121 133 if c.SSH.Listen == "" {
122 134 c.SSH.Listen = "0.0.0.0:2222"
@@ -138,7 +150,7 @@ func (c *Config) applyDefaults() {
138 150 }
139 151
140 152 // Validate keurt een configuratie goed of af.
141 func (c Config) Validate() error {
153 func (c *Config) Validate() error {
142 154 if c.BaseURL == "" {
143 155 return fmt.Errorf("base_url ontbreekt")
144 156 }
@@ -167,9 +179,74 @@ func (c Config) Validate() error {
167 179 default:
168 180 return fmt.Errorf("auth.mode moet oauth of dev zijn")
169 181 }
182 if c.BehindProxy {
183 return fmt.Errorf("behind_proxy doet niets meer; zet trusted_proxies op het IP of CIDR van de ingress en haal behind_proxy weg")
184 }
185 set, err := realip.Parse(c.TrustedProxies)
186 if err != nil {
187 return err
188 }
189 c.proxies = set
190 if c.SSH.PublicPort < 0 || c.SSH.PublicPort > 65535 {
191 return fmt.Errorf("ssh.public_port moet tussen 0 en 65535 liggen")
192 }
193 if h := strings.TrimSpace(c.SSH.PublicHost); h != "" {
194 if strings.Contains(h, "://") || strings.ContainsAny(h, " /") || (strings.Contains(h, ":") && net.ParseIP(h) == nil) {
195 return fmt.Errorf("ssh.public_host moet een hostnaam of IP zijn, zonder schema of poort")
196 }
197 }
198 if _, _, err := net.SplitHostPort(c.SSH.Listen); err != nil {
199 return fmt.Errorf("ssh.listen moet host:poort zijn")
200 }
170 201 return nil
171 202 }
172 203
204 // ProxySet is de geparsede trusted_proxies-lijst. Nil betekent dat
205 // niemand vertrouwd wordt.
206 func (c Config) ProxySet() *realip.Set { return c.proxies }
207
208 // SSHPublicHost is de host in een SSH-clone-URL.
209 // Leeg in de config: de host van base_url.
210 func (c Config) SSHPublicHost() string {
211 if h := strings.TrimSpace(c.SSH.PublicHost); h != "" {
212 return h
213 }
214 u, err := url.Parse(c.BaseURL)
215 if err != nil {
216 return ""
217 }
218 return u.Hostname()
219 }
220
221 // SSHPublicPort is de poort in een SSH-clone-URL.
222 // 0 in de config: de poort van ssh.listen.
223 func (c Config) SSHPublicPort() int {
224 if c.SSH.PublicPort > 0 {
225 return c.SSH.PublicPort
226 }
227 _, port, err := net.SplitHostPort(c.SSH.Listen)
228 if err != nil {
229 return 22
230 }
231 n, err := strconv.Atoi(port)
232 if err != nil || n <= 0 {
233 return 22
234 }
235 return n
236 }
237
238 // CloneSSH is de URL die een gebruiker kloont. Leeg als SSH uit staat.
239 func (c Config) CloneSSH(repoPath string) string {
240 if !c.SSH.Enabled {
241 return ""
242 }
243 host := c.SSHPublicHost()
244 if strings.Contains(host, ":") && !strings.HasPrefix(host, "[") {
245 host = "[" + host + "]"
246 }
247 return fmt.Sprintf("ssh://git@%s:%d/%s.git", host, c.SSHPublicPort(), repoPath)
248 }
249
173 250 // RedirectURI is de callback die bij de auth-server geregistreerd moet staan.
174 251 func (c Config) RedirectURI() string {
175 252 return c.BaseURL + c.Auth.RedirectPath
@@ -178,11 +255,16 @@ func (c Config) RedirectURI() string {
178 255 // Example is een startconfiguratie voor de mini-PC.
179 256 func Example() string {
180 257 return `# BlueGit op de mini-PC. Kopieer naar /etc/bluegit/config.yml.
258 # Plain HTTP. TLS en de publieke SSH-poort doet de ingress, zie docs/INGRESS.md.
181 259 base_url: https://git.timfalken.com
182 listen: 127.0.0.1:8080
183 # De 4 TB-schijf. De database, repositories, artifacts en releases staan hier.
260 listen: 0.0.0.0:8080
261 # De 4 TB-schijf. Het mountpoint is nog niet gekozen; dit pad is een voorbeeld.
262 # Database, repositories, artifacts en releases staan hier.
184 263 storage_path: /mnt/storage/bluegit
185 behind_proxy: true
264 # Alleen deze adressen mogen X-Forwarded-For en X-Real-IP zetten.
265 # Zet hier het IP van de ingress, zoals de mini-PC die verbinding ziet.
266 trusted_proxies:
267 - 10.0.0.2
186 268
187 269 auth:
188 270 mode: oauth
@@ -197,11 +279,15 @@ auth:
197 279
198 280 git:
199 281 binary: git
200 default_branch: main
282 default_branch: master
201 283
202 284 ssh:
203 285 enabled: true
286 # Waar dit proces git-SSH aanneemt. De SSH van het besturingssysteem blijft vrij.
204 287 listen: 0.0.0.0:2222
288 # Wat gebruikers in de clone-URL zien. De ingress stuurt poort 22 hiernaartoe.
289 public_host: git.timfalken.com
290 public_port: 22
205 291
206 292 ci:
207 293 enabled: true
@@ -3,23 +3,31 @@ package config
3
3
4import (
4import (
5 "fmt"
5 "fmt"
6 "net"
6 "net/url"
7 "net/url"
7 "os"
8 "os"
9 "strconv"
8 "strings"
10 "strings"
9
11
12 "gitlab.com/Timfa/bluegit/internal/realip"
10 "gopkg.in/yaml.v3"
13 "gopkg.in/yaml.v3"
11)
14)
12
15
13// Config is de installatie op de mini-PC.
16// Config is de installatie op de mini-PC.
14type Config struct {
17type Config struct {
15 BaseURL string `yaml:"base_url"`
18 BaseURL string `yaml:"base_url"`
16 Listen string `yaml:"listen"`
19 Listen string `yaml:"listen"`
17 StoragePath string `yaml:"storage_path"`
20 StoragePath string `yaml:"storage_path"`
18 BehindProxy bool `yaml:"behind_proxy"`
21 TrustedProxies []string `yaml:"trusted_proxies"`
19 Auth Auth `yaml:"auth"`
22 // BehindProxy is het oude veld. Het wordt geweigerd: één boolean
20 Git Git `yaml:"git"`
23 // vertrouwt ofwel iedereen, ofwel niemand. De lijst hierboven beslist.
21 SSH SSH `yaml:"ssh"`
24 BehindProxy bool `yaml:"behind_proxy"`
22 CI CI `yaml:"ci"`
25 Auth Auth `yaml:"auth"`
26 Git Git `yaml:"git"`
27 SSH SSH `yaml:"ssh"`
28 CI CI `yaml:"ci"`
29
30 proxies *realip.Set
23}
31}
24
32
25// Auth wijst naar auth.timfalken.com of naar de lokale ontwikkelmodus.
33// Auth wijst naar auth.timfalken.com of naar de lokale ontwikkelmodus.
@@ -42,10 +50,14 @@ type Git struct {
42 HookBinary string `yaml:"hook_binary"`
50 HookBinary string `yaml:"hook_binary"`
43}
51}
44
52
45// SSH is de git-over-SSH-listener.
53// SSH is de git-over-SSH-listener en het adres dat in clone-URL's staat.
54// Listen is waar dit proces bindt. PublicHost en PublicPort zijn wat
55// een gebruiker ziet; de ingress kan daar een andere poort voor gebruiken.
46type SSH struct {
56type SSH struct {
47 Enabled bool `yaml:"enabled"`
57 Enabled bool `yaml:"enabled"`
48 Listen string `yaml:"listen"`
58 Listen string `yaml:"listen"`
59 PublicHost string `yaml:"public_host"`
60 PublicPort int `yaml:"public_port"`
49}
61}
50
62
51// CI stuurt de Docker-runner.
63// CI stuurt de Docker-runner.
@@ -116,7 +128,7 @@ func (c *Config) applyDefaults() {
116 c.Git.Binary = "git"
128 c.Git.Binary = "git"
117 }
129 }
118 if c.Git.DefaultBranch == "" {
130 if c.Git.DefaultBranch == "" {
119 c.Git.DefaultBranch = "main"
131 c.Git.DefaultBranch = "master"
120 }
132 }
121 if c.SSH.Listen == "" {
133 if c.SSH.Listen == "" {
122 c.SSH.Listen = "0.0.0.0:2222"
134 c.SSH.Listen = "0.0.0.0:2222"
@@ -138,7 +150,7 @@ func (c *Config) applyDefaults() {
138}
150}
139
151
140// Validate keurt een configuratie goed of af.
152// Validate keurt een configuratie goed of af.
141func (c Config) Validate() error {
153func (c *Config) Validate() error {
142 if c.BaseURL == "" {
154 if c.BaseURL == "" {
143 return fmt.Errorf("base_url ontbreekt")
155 return fmt.Errorf("base_url ontbreekt")
144 }
156 }
@@ -167,9 +179,74 @@ func (c Config) Validate() error {
167 default:
179 default:
168 return fmt.Errorf("auth.mode moet oauth of dev zijn")
180 return fmt.Errorf("auth.mode moet oauth of dev zijn")
169 }
181 }
182 if c.BehindProxy {
183 return fmt.Errorf("behind_proxy doet niets meer; zet trusted_proxies op het IP of CIDR van de ingress en haal behind_proxy weg")
184 }
185 set, err := realip.Parse(c.TrustedProxies)
186 if err != nil {
187 return err
188 }
189 c.proxies = set
190 if c.SSH.PublicPort < 0 || c.SSH.PublicPort > 65535 {
191 return fmt.Errorf("ssh.public_port moet tussen 0 en 65535 liggen")
192 }
193 if h := strings.TrimSpace(c.SSH.PublicHost); h != "" {
194 if strings.Contains(h, "://") || strings.ContainsAny(h, " /") || (strings.Contains(h, ":") && net.ParseIP(h) == nil) {
195 return fmt.Errorf("ssh.public_host moet een hostnaam of IP zijn, zonder schema of poort")
196 }
197 }
198 if _, _, err := net.SplitHostPort(c.SSH.Listen); err != nil {
199 return fmt.Errorf("ssh.listen moet host:poort zijn")
200 }
170 return nil
201 return nil
171}
202}
172
203
204// ProxySet is de geparsede trusted_proxies-lijst. Nil betekent dat
205// niemand vertrouwd wordt.
206func (c Config) ProxySet() *realip.Set { return c.proxies }
207
208// SSHPublicHost is de host in een SSH-clone-URL.
209// Leeg in de config: de host van base_url.
210func (c Config) SSHPublicHost() string {
211 if h := strings.TrimSpace(c.SSH.PublicHost); h != "" {
212 return h
213 }
214 u, err := url.Parse(c.BaseURL)
215 if err != nil {
216 return ""
217 }
218 return u.Hostname()
219}
220
221// SSHPublicPort is de poort in een SSH-clone-URL.
222// 0 in de config: de poort van ssh.listen.
223func (c Config) SSHPublicPort() int {
224 if c.SSH.PublicPort > 0 {
225 return c.SSH.PublicPort
226 }
227 _, port, err := net.SplitHostPort(c.SSH.Listen)
228 if err != nil {
229 return 22
230 }
231 n, err := strconv.Atoi(port)
232 if err != nil || n <= 0 {
233 return 22
234 }
235 return n
236}
237
238// CloneSSH is de URL die een gebruiker kloont. Leeg als SSH uit staat.
239func (c Config) CloneSSH(repoPath string) string {
240 if !c.SSH.Enabled {
241 return ""
242 }
243 host := c.SSHPublicHost()
244 if strings.Contains(host, ":") && !strings.HasPrefix(host, "[") {
245 host = "[" + host + "]"
246 }
247 return fmt.Sprintf("ssh://git@%s:%d/%s.git", host, c.SSHPublicPort(), repoPath)
248}
249
173// RedirectURI is de callback die bij de auth-server geregistreerd moet staan.
250// RedirectURI is de callback die bij de auth-server geregistreerd moet staan.
174func (c Config) RedirectURI() string {
251func (c Config) RedirectURI() string {
175 return c.BaseURL + c.Auth.RedirectPath
252 return c.BaseURL + c.Auth.RedirectPath
@@ -178,11 +255,16 @@ func (c Config) RedirectURI() string {
178// Example is een startconfiguratie voor de mini-PC.
255// Example is een startconfiguratie voor de mini-PC.
179func Example() string {
256func Example() string {
180 return `# BlueGit op de mini-PC. Kopieer naar /etc/bluegit/config.yml.
257 return `# BlueGit op de mini-PC. Kopieer naar /etc/bluegit/config.yml.
258# Plain HTTP. TLS en de publieke SSH-poort doet de ingress, zie docs/INGRESS.md.
181base_url: https://git.timfalken.com
259base_url: https://git.timfalken.com
182listen: 127.0.0.1:8080
260listen: 0.0.0.0:8080
183# De 4 TB-schijf. De database, repositories, artifacts en releases staan hier.
261# De 4 TB-schijf. Het mountpoint is nog niet gekozen; dit pad is een voorbeeld.
262# Database, repositories, artifacts en releases staan hier.
184storage_path: /mnt/storage/bluegit
263storage_path: /mnt/storage/bluegit
185behind_proxy: true
264# Alleen deze adressen mogen X-Forwarded-For en X-Real-IP zetten.
265# Zet hier het IP van de ingress, zoals de mini-PC die verbinding ziet.
266trusted_proxies:
267 - 10.0.0.2
186
268
187auth:
269auth:
188 mode: oauth
270 mode: oauth
@@ -197,11 +279,15 @@ auth:
197
279
198git:
280git:
199 binary: git
281 binary: git
200 default_branch: main
282 default_branch: master
201
283
202ssh:
284ssh:
203 enabled: true
285 enabled: true
286 # Waar dit proces git-SSH aanneemt. De SSH van het besturingssysteem blijft vrij.
204 listen: 0.0.0.0:2222
287 listen: 0.0.0.0:2222
288 # Wat gebruikers in de clone-URL zien. De ingress stuurt poort 22 hiernaartoe.
289 public_host: git.timfalken.com
290 public_port: 22
205
291
206ci:
292ci:
207 enabled: true
293 enabled: true
internal/config/config_test.go +77 −2
@@ -32,10 +32,85 @@ func TestSecretFromEnv(t *testing.T) {
32 32 if err != nil {
33 33 t.Fatal(err)
34 34 }
35 if cfg.Auth.ClientSecret != "uit-de-omgeving" || cfg.Git.DefaultBranch != "main" {
36 t.Fatalf("%+v", cfg.Auth)
35 if cfg.Auth.ClientSecret != "uit-de-omgeving" || cfg.Git.DefaultBranch != "master" {
36 t.Fatalf("branch %s geheim %s", cfg.Git.DefaultBranch, cfg.Auth.ClientSecret)
37 37 }
38 38 if cfg.RedirectURI() != "https://git.example.test/auth/callback" {
39 39 t.Fatal(cfg.RedirectURI())
40 40 }
41 if cfg.SSHPublicHost() != "git.example.test" || cfg.SSHPublicPort() != 2222 {
42 t.Fatalf("ssh %s:%d", cfg.SSHPublicHost(), cfg.SSHPublicPort())
43 }
44 if cfg.CloneSSH("tim/demo") != "" {
45 t.Fatal("ssh staat uit, dus geen clone-URL")
46 }
47 }
48
49 func TestPublicSSHAndTrustedProxy(t *testing.T) {
50 dir := t.TempDir()
51 path := filepath.Join(dir, "config.yml")
52 body := []byte(`base_url: https://git.timfalken.com
53 storage_path: ` + dir + `
54 listen: 0.0.0.0:8080
55 trusted_proxies: ["10.0.0.2", "192.168.0.0/16"]
56 auth:
57 mode: oauth
58 client_id: git.timfalken.com
59 ssh:
60 enabled: true
61 listen: 0.0.0.0:2222
62 public_host: git.timfalken.com
63 public_port: 22
64 `)
65 if err := os.WriteFile(path, body, 0o600); err != nil {
66 t.Fatal(err)
67 }
68 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
69 cfg, err := Load(path)
70 if err != nil {
71 t.Fatal(err)
72 }
73 if cfg.CloneSSH("tim/demo") != "ssh://git@git.timfalken.com:22/tim/demo.git" {
74 t.Fatal(cfg.CloneSSH("tim/demo"))
75 }
76 if cfg.ProxySet() == nil || cfg.Listen != "0.0.0.0:8080" {
77 t.Fatalf("%+v", cfg)
78 }
79 }
80
81 func TestBehindProxyFlagRejected(t *testing.T) {
82 dir := t.TempDir()
83 path := filepath.Join(dir, "config.yml")
84 body := []byte("base_url: https://git.example.test\nstorage_path: " + dir + "\nbehind_proxy: true\nauth:\n mode: oauth\n client_id: git.example.test\n")
85 if err := os.WriteFile(path, body, 0o600); err != nil {
86 t.Fatal(err)
87 }
88 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
89 _, err := Load(path)
90 if err == nil || !strings.Contains(err.Error(), "trusted_proxies") {
91 t.Fatalf("verwacht weigering van behind_proxy, kreeg %v", err)
92 }
93 }
94
95 func TestBadProxyRejected(t *testing.T) {
96 dir := t.TempDir()
97 path := filepath.Join(dir, "config.yml")
98 body := []byte("base_url: https://git.example.test\nstorage_path: " + dir + "\ntrusted_proxies: [ingress.local]\nauth:\n mode: oauth\n client_id: git.example.test\n")
99 if err := os.WriteFile(path, body, 0o600); err != nil {
100 t.Fatal(err)
101 }
102 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
103 _, err := Load(path)
104 if err == nil || !strings.Contains(err.Error(), "trusted_proxies") {
105 t.Fatalf("verwacht weigering, kreeg %v", err)
106 }
107 body = []byte("base_url: https://git.example.test\nstorage_path: " + dir + "\nauth:\n mode: oauth\n client_id: git.example.test\nssh:\n enabled: true\n public_host: git.example.test:22\n")
108 path = filepath.Join(dir, "port.yml")
109 if err := os.WriteFile(path, body, 0o600); err != nil {
110 t.Fatal(err)
111 }
112 _, err = Load(path)
113 if err == nil || !strings.Contains(err.Error(), "public_host") {
114 t.Fatalf("verwacht weigering van een poort in de host, kreeg %v", err)
115 }
41 116 }
@@ -32,10 +32,85 @@ func TestSecretFromEnv(t *testing.T) {
32 if err != nil {
32 if err != nil {
33 t.Fatal(err)
33 t.Fatal(err)
34 }
34 }
35 if cfg.Auth.ClientSecret != "uit-de-omgeving" || cfg.Git.DefaultBranch != "main" {
35 if cfg.Auth.ClientSecret != "uit-de-omgeving" || cfg.Git.DefaultBranch != "master" {
36 t.Fatalf("%+v", cfg.Auth)
36 t.Fatalf("branch %s geheim %s", cfg.Git.DefaultBranch, cfg.Auth.ClientSecret)
37 }
37 }
38 if cfg.RedirectURI() != "https://git.example.test/auth/callback" {
38 if cfg.RedirectURI() != "https://git.example.test/auth/callback" {
39 t.Fatal(cfg.RedirectURI())
39 t.Fatal(cfg.RedirectURI())
40 }
40 }
41 if cfg.SSHPublicHost() != "git.example.test" || cfg.SSHPublicPort() != 2222 {
42 t.Fatalf("ssh %s:%d", cfg.SSHPublicHost(), cfg.SSHPublicPort())
43 }
44 if cfg.CloneSSH("tim/demo") != "" {
45 t.Fatal("ssh staat uit, dus geen clone-URL")
46 }
47}
48
49func TestPublicSSHAndTrustedProxy(t *testing.T) {
50 dir := t.TempDir()
51 path := filepath.Join(dir, "config.yml")
52 body := []byte(`base_url: https://git.timfalken.com
53storage_path: ` + dir + `
54listen: 0.0.0.0:8080
55trusted_proxies: ["10.0.0.2", "192.168.0.0/16"]
56auth:
57 mode: oauth
58 client_id: git.timfalken.com
59ssh:
60 enabled: true
61 listen: 0.0.0.0:2222
62 public_host: git.timfalken.com
63 public_port: 22
64`)
65 if err := os.WriteFile(path, body, 0o600); err != nil {
66 t.Fatal(err)
67 }
68 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
69 cfg, err := Load(path)
70 if err != nil {
71 t.Fatal(err)
72 }
73 if cfg.CloneSSH("tim/demo") != "ssh://git@git.timfalken.com:22/tim/demo.git" {
74 t.Fatal(cfg.CloneSSH("tim/demo"))
75 }
76 if cfg.ProxySet() == nil || cfg.Listen != "0.0.0.0:8080" {
77 t.Fatalf("%+v", cfg)
78 }
79}
80
81func TestBehindProxyFlagRejected(t *testing.T) {
82 dir := t.TempDir()
83 path := filepath.Join(dir, "config.yml")
84 body := []byte("base_url: https://git.example.test\nstorage_path: " + dir + "\nbehind_proxy: true\nauth:\n mode: oauth\n client_id: git.example.test\n")
85 if err := os.WriteFile(path, body, 0o600); err != nil {
86 t.Fatal(err)
87 }
88 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
89 _, err := Load(path)
90 if err == nil || !strings.Contains(err.Error(), "trusted_proxies") {
91 t.Fatalf("verwacht weigering van behind_proxy, kreeg %v", err)
92 }
93}
94
95func TestBadProxyRejected(t *testing.T) {
96 dir := t.TempDir()
97 path := filepath.Join(dir, "config.yml")
98 body := []byte("base_url: https://git.example.test\nstorage_path: " + dir + "\ntrusted_proxies: [ingress.local]\nauth:\n mode: oauth\n client_id: git.example.test\n")
99 if err := os.WriteFile(path, body, 0o600); err != nil {
100 t.Fatal(err)
101 }
102 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
103 _, err := Load(path)
104 if err == nil || !strings.Contains(err.Error(), "trusted_proxies") {
105 t.Fatalf("verwacht weigering, kreeg %v", err)
106 }
107 body = []byte("base_url: https://git.example.test\nstorage_path: " + dir + "\nauth:\n mode: oauth\n client_id: git.example.test\nssh:\n enabled: true\n public_host: git.example.test:22\n")
108 path = filepath.Join(dir, "port.yml")
109 if err := os.WriteFile(path, body, 0o600); err != nil {
110 t.Fatal(err)
111 }
112 _, err = Load(path)
113 if err == nil || !strings.Contains(err.Error(), "public_host") {
114 t.Fatalf("verwacht weigering van een poort in de host, kreeg %v", err)
115 }
41}
116}
internal/realip/realip.go added +133 −0
@@ -0,0 +1,133 @@
1 // Package realip haalt het adres van de client achter een reverse proxy vandaan.
2 // X-Forwarded-For en X-Real-IP tellen alleen als de directe verbinding
3 // van een adres op de vertrouwenslijst komt. Een client die zelf een
4 // kop meestuurt, kan zijn adres daarmee niet vervalsen.
5 package realip
6
7 import (
8 "fmt"
9 "net"
10 "net/http"
11 "strings"
12 )
13
14 // Set is een lijst IP-adressen en CIDR-blokken.
15 type Set struct {
16 nets []*net.IPNet
17 }
18
19 // Parse leest IP-adressen en CIDR-blokken. Een lege lijst vertrouwt niemand.
20 func Parse(entries []string) (*Set, error) {
21 s := &Set{}
22 for _, e := range entries {
23 e = strings.TrimSpace(e)
24 if e == "" {
25 continue
26 }
27 if strings.Contains(e, "/") {
28 _, n, err := net.ParseCIDR(e)
29 if err != nil {
30 return nil, fmt.Errorf("trusted_proxies: %q is geen CIDR", e)
31 }
32 s.nets = append(s.nets, n)
33 continue
34 }
35 ip := net.ParseIP(e)
36 if ip == nil {
37 return nil, fmt.Errorf("trusted_proxies: %q is geen IP-adres of CIDR", e)
38 }
39 bits := 32
40 if ip.To4() == nil {
41 bits = 128
42 }
43 s.nets = append(s.nets, &net.IPNet{IP: ip, Mask: net.CIDRMask(bits, bits)})
44 }
45 return s, nil
46 }
47
48 // Contains meldt of ip op de lijst staat.
49 func (s *Set) Contains(ip net.IP) bool {
50 if s == nil || ip == nil {
51 return false
52 }
53 for _, n := range s.nets {
54 if n.Contains(ip) {
55 return true
56 }
57 }
58 return false
59 }
60
61 // ClientIP kiest het clientadres.
62 // remoteAddr is host:poort van de TCP-verbinding. xff is X-Forwarded-For,
63 // xReal is X-Real-IP. In de keten is het clientadres de rechtse hop die
64 // zelf geen vertrouwde proxy is. Zijn alle hops vertrouwd, dan blijft
65 // het adres van de directe verbinding staan.
66 func ClientIP(remoteAddr, xff, xReal string, trusted *Set) string {
67 peer, _, err := net.SplitHostPort(remoteAddr)
68 if err != nil {
69 peer = remoteAddr
70 }
71 peerIP := net.ParseIP(peer)
72 if trusted == nil || peerIP == nil || !trusted.Contains(peerIP) {
73 return peer
74 }
75 if ip := rightmostUntrusted(xff, trusted); ip != nil {
76 return ip.String()
77 }
78 if ip := parseToken(xReal); ip != nil && !trusted.Contains(ip) {
79 return ip.String()
80 }
81 return peer
82 }
83
84 func rightmostUntrusted(xff string, trusted *Set) net.IP {
85 if strings.TrimSpace(xff) == "" {
86 return nil
87 }
88 parts := strings.Split(xff, ",")
89 for i := len(parts) - 1; i >= 0; i-- {
90 ip := parseToken(parts[i])
91 if ip == nil {
92 continue
93 }
94 if !trusted.Contains(ip) {
95 return ip
96 }
97 }
98 return nil
99 }
100
101 func parseToken(s string) net.IP {
102 s = strings.TrimSpace(s)
103 s = strings.Trim(s, `"`)
104 if s == "" {
105 return nil
106 }
107 if h, _, err := net.SplitHostPort(s); err == nil {
108 s = h
109 }
110 s = strings.Trim(s, "[]")
111 return net.ParseIP(s)
112 }
113
114 // FromRequest leest de koppen van r.
115 func FromRequest(r *http.Request, trusted *Set) string {
116 xff := strings.Join(r.Header.Values("X-Forwarded-For"), ", ")
117 return ClientIP(r.RemoteAddr, xff, r.Header.Get("X-Real-IP"), trusted)
118 }
119
120 // Apply zet r.RemoteAddr op het clientadres. De poort blijft alleen staan
121 // als het adres niet uit een proxykop komt; die poort is anders van de proxy.
122 func Apply(r *http.Request, trusted *Set) {
123 ip := FromRequest(r, trusted)
124 host, port, err := net.SplitHostPort(r.RemoteAddr)
125 if err != nil || port == "" {
126 r.RemoteAddr = net.JoinHostPort(ip, "0")
127 return
128 }
129 if parsed, got := net.ParseIP(host), net.ParseIP(ip); parsed == nil || got == nil || !parsed.Equal(got) {
130 port = "0"
131 }
132 r.RemoteAddr = net.JoinHostPort(ip, port)
133 }
@@ -0,0 +1,133 @@
1// Package realip haalt het adres van de client achter een reverse proxy vandaan.
2// X-Forwarded-For en X-Real-IP tellen alleen als de directe verbinding
3// van een adres op de vertrouwenslijst komt. Een client die zelf een
4// kop meestuurt, kan zijn adres daarmee niet vervalsen.
5package realip
6
7import (
8 "fmt"
9 "net"
10 "net/http"
11 "strings"
12)
13
14// Set is een lijst IP-adressen en CIDR-blokken.
15type Set struct {
16 nets []*net.IPNet
17}
18
19// Parse leest IP-adressen en CIDR-blokken. Een lege lijst vertrouwt niemand.
20func Parse(entries []string) (*Set, error) {
21 s := &Set{}
22 for _, e := range entries {
23 e = strings.TrimSpace(e)
24 if e == "" {
25 continue
26 }
27 if strings.Contains(e, "/") {
28 _, n, err := net.ParseCIDR(e)
29 if err != nil {
30 return nil, fmt.Errorf("trusted_proxies: %q is geen CIDR", e)
31 }
32 s.nets = append(s.nets, n)
33 continue
34 }
35 ip := net.ParseIP(e)
36 if ip == nil {
37 return nil, fmt.Errorf("trusted_proxies: %q is geen IP-adres of CIDR", e)
38 }
39 bits := 32
40 if ip.To4() == nil {
41 bits = 128
42 }
43 s.nets = append(s.nets, &net.IPNet{IP: ip, Mask: net.CIDRMask(bits, bits)})
44 }
45 return s, nil
46}
47
48// Contains meldt of ip op de lijst staat.
49func (s *Set) Contains(ip net.IP) bool {
50 if s == nil || ip == nil {
51 return false
52 }
53 for _, n := range s.nets {
54 if n.Contains(ip) {
55 return true
56 }
57 }
58 return false
59}
60
61// ClientIP kiest het clientadres.
62// remoteAddr is host:poort van de TCP-verbinding. xff is X-Forwarded-For,
63// xReal is X-Real-IP. In de keten is het clientadres de rechtse hop die
64// zelf geen vertrouwde proxy is. Zijn alle hops vertrouwd, dan blijft
65// het adres van de directe verbinding staan.
66func ClientIP(remoteAddr, xff, xReal string, trusted *Set) string {
67 peer, _, err := net.SplitHostPort(remoteAddr)
68 if err != nil {
69 peer = remoteAddr
70 }
71 peerIP := net.ParseIP(peer)
72 if trusted == nil || peerIP == nil || !trusted.Contains(peerIP) {
73 return peer
74 }
75 if ip := rightmostUntrusted(xff, trusted); ip != nil {
76 return ip.String()
77 }
78 if ip := parseToken(xReal); ip != nil && !trusted.Contains(ip) {
79 return ip.String()
80 }
81 return peer
82}
83
84func rightmostUntrusted(xff string, trusted *Set) net.IP {
85 if strings.TrimSpace(xff) == "" {
86 return nil
87 }
88 parts := strings.Split(xff, ",")
89 for i := len(parts) - 1; i >= 0; i-- {
90 ip := parseToken(parts[i])
91 if ip == nil {
92 continue
93 }
94 if !trusted.Contains(ip) {
95 return ip
96 }
97 }
98 return nil
99}
100
101func parseToken(s string) net.IP {
102 s = strings.TrimSpace(s)
103 s = strings.Trim(s, `"`)
104 if s == "" {
105 return nil
106 }
107 if h, _, err := net.SplitHostPort(s); err == nil {
108 s = h
109 }
110 s = strings.Trim(s, "[]")
111 return net.ParseIP(s)
112}
113
114// FromRequest leest de koppen van r.
115func FromRequest(r *http.Request, trusted *Set) string {
116 xff := strings.Join(r.Header.Values("X-Forwarded-For"), ", ")
117 return ClientIP(r.RemoteAddr, xff, r.Header.Get("X-Real-IP"), trusted)
118}
119
120// Apply zet r.RemoteAddr op het clientadres. De poort blijft alleen staan
121// als het adres niet uit een proxykop komt; die poort is anders van de proxy.
122func Apply(r *http.Request, trusted *Set) {
123 ip := FromRequest(r, trusted)
124 host, port, err := net.SplitHostPort(r.RemoteAddr)
125 if err != nil || port == "" {
126 r.RemoteAddr = net.JoinHostPort(ip, "0")
127 return
128 }
129 if parsed, got := net.ParseIP(host), net.ParseIP(ip); parsed == nil || got == nil || !parsed.Equal(got) {
130 port = "0"
131 }
132 r.RemoteAddr = net.JoinHostPort(ip, port)
133}
internal/realip/realip_test.go added +85 −0
@@ -0,0 +1,85 @@
1 package realip
2
3 import (
4 "net/http"
5 "testing"
6 )
7
8 func TestUntrustedPeerIgnoresForwardedHeaders(t *testing.T) {
9 set, err := Parse([]string{"10.0.0.2"})
10 if err != nil {
11 t.Fatal(err)
12 }
13 got := ClientIP("203.0.113.9:4321", "1.2.3.4", "8.8.8.8", set)
14 if got != "203.0.113.9" {
15 t.Fatalf("onvertrouwde client werd %s", got)
16 }
17 got = ClientIP("203.0.113.9:4321", "1.2.3.4", "8.8.8.8", nil)
18 if got != "203.0.113.9" {
19 t.Fatalf("lege lijst werd %s", got)
20 }
21 }
22
23 func TestRightmostUntrustedHop(t *testing.T) {
24 set, err := Parse([]string{"10.0.0.0/8"})
25 if err != nil {
26 t.Fatal(err)
27 }
28 // De aanvaller zette 6.6.6.6 vooraan. De ingress plakte het echte adres erachter.
29 got := ClientIP("10.0.0.2:443", "6.6.6.6, 198.51.100.20", "", set)
30 if got != "198.51.100.20" {
31 t.Fatalf("kreeg %s", got)
32 }
33 got = ClientIP("10.0.0.2:443", "198.51.100.20", "", set)
34 if got != "198.51.100.20" {
35 t.Fatalf("enkele hop werd %s", got)
36 }
37 }
38
39 func TestRealIPWhenForwardedForMissing(t *testing.T) {
40 set, err := Parse([]string{"10.0.0.2"})
41 if err != nil {
42 t.Fatal(err)
43 }
44 got := ClientIP("10.0.0.2:443", "", "198.51.100.8", set)
45 if got != "198.51.100.8" {
46 t.Fatalf("X-Real-IP werd %s", got)
47 }
48 got = ClientIP("10.0.0.2:443", "", "10.0.0.2", set)
49 if got != "10.0.0.2" {
50 t.Fatalf("alleen proxies, kreeg %s", got)
51 }
52 }
53
54 func TestApplyRewritesRemoteAddr(t *testing.T) {
55 set, err := Parse([]string{"10.0.0.2"})
56 if err != nil {
57 t.Fatal(err)
58 }
59 r, err := http.NewRequest(http.MethodGet, "http://git.timfalken.com/", nil)
60 if err != nil {
61 t.Fatal(err)
62 }
63 r.RemoteAddr = "10.0.0.2:51234"
64 r.Header.Set("X-Forwarded-For", "203.0.113.4")
65 Apply(r, set)
66 if r.RemoteAddr != "203.0.113.4:0" {
67 t.Fatalf("RemoteAddr %s", r.RemoteAddr)
68 }
69
70 r.RemoteAddr = "203.0.113.9:51234"
71 r.Header.Set("X-Forwarded-For", "1.1.1.1")
72 Apply(r, set)
73 if r.RemoteAddr != "203.0.113.9:51234" {
74 t.Fatalf("onvertrouwd bleef niet staan: %s", r.RemoteAddr)
75 }
76 }
77
78 func TestParseRejectsNames(t *testing.T) {
79 if _, err := Parse([]string{"ingress.local"}); err == nil {
80 t.Fatal("een hostnaam hoort geen proxy te zijn")
81 }
82 if _, err := Parse([]string{"10.0.0.0/33"}); err == nil {
83 t.Fatal("ongeldig CIDR")
84 }
85 }
@@ -0,0 +1,85 @@
1package realip
2
3import (
4 "net/http"
5 "testing"
6)
7
8func TestUntrustedPeerIgnoresForwardedHeaders(t *testing.T) {
9 set, err := Parse([]string{"10.0.0.2"})
10 if err != nil {
11 t.Fatal(err)
12 }
13 got := ClientIP("203.0.113.9:4321", "1.2.3.4", "8.8.8.8", set)
14 if got != "203.0.113.9" {
15 t.Fatalf("onvertrouwde client werd %s", got)
16 }
17 got = ClientIP("203.0.113.9:4321", "1.2.3.4", "8.8.8.8", nil)
18 if got != "203.0.113.9" {
19 t.Fatalf("lege lijst werd %s", got)
20 }
21}
22
23func TestRightmostUntrustedHop(t *testing.T) {
24 set, err := Parse([]string{"10.0.0.0/8"})
25 if err != nil {
26 t.Fatal(err)
27 }
28 // De aanvaller zette 6.6.6.6 vooraan. De ingress plakte het echte adres erachter.
29 got := ClientIP("10.0.0.2:443", "6.6.6.6, 198.51.100.20", "", set)
30 if got != "198.51.100.20" {
31 t.Fatalf("kreeg %s", got)
32 }
33 got = ClientIP("10.0.0.2:443", "198.51.100.20", "", set)
34 if got != "198.51.100.20" {
35 t.Fatalf("enkele hop werd %s", got)
36 }
37}
38
39func TestRealIPWhenForwardedForMissing(t *testing.T) {
40 set, err := Parse([]string{"10.0.0.2"})
41 if err != nil {
42 t.Fatal(err)
43 }
44 got := ClientIP("10.0.0.2:443", "", "198.51.100.8", set)
45 if got != "198.51.100.8" {
46 t.Fatalf("X-Real-IP werd %s", got)
47 }
48 got = ClientIP("10.0.0.2:443", "", "10.0.0.2", set)
49 if got != "10.0.0.2" {
50 t.Fatalf("alleen proxies, kreeg %s", got)
51 }
52}
53
54func TestApplyRewritesRemoteAddr(t *testing.T) {
55 set, err := Parse([]string{"10.0.0.2"})
56 if err != nil {
57 t.Fatal(err)
58 }
59 r, err := http.NewRequest(http.MethodGet, "http://git.timfalken.com/", nil)
60 if err != nil {
61 t.Fatal(err)
62 }
63 r.RemoteAddr = "10.0.0.2:51234"
64 r.Header.Set("X-Forwarded-For", "203.0.113.4")
65 Apply(r, set)
66 if r.RemoteAddr != "203.0.113.4:0" {
67 t.Fatalf("RemoteAddr %s", r.RemoteAddr)
68 }
69
70 r.RemoteAddr = "203.0.113.9:51234"
71 r.Header.Set("X-Forwarded-For", "1.1.1.1")
72 Apply(r, set)
73 if r.RemoteAddr != "203.0.113.9:51234" {
74 t.Fatalf("onvertrouwd bleef niet staan: %s", r.RemoteAddr)
75 }
76}
77
78func TestParseRejectsNames(t *testing.T) {
79 if _, err := Parse([]string{"ingress.local"}); err == nil {
80 t.Fatal("een hostnaam hoort geen proxy te zijn")
81 }
82 if _, err := Parse([]string{"10.0.0.0/33"}); err == nil {
83 t.Fatal("ongeldig CIDR")
84 }
85}
internal/server/auth_handlers.go +6 −6
@@ -96,7 +96,7 @@ func (s *Server) logout(w http.ResponseWriter, r *http.Request) {
96 96 func (s *Server) home(w http.ResponseWriter, r *http.Request) {
97 97 v := s.view(w, r, "BlueGit")
98 98 if v.User != nil {
99 ids, err := s.Store.ListRepoIDs(r.Context(), v.User.ID, v.User.InstanceAdmin)
99 ids, err := s.Store.ListRepoIDs(r.Context(), v.User.ID)
100 100 if err != nil {
101 101 http.Error(w, "overzicht", http.StatusInternalServerError)
102 102 return
@@ -107,7 +107,7 @@ func (s *Server) home(w http.ResponseWriter, r *http.Request) {
107 107 return
108 108 }
109 109 v.Repos = repos
110 groups, err := s.Store.ListGroups(r.Context(), v.User.ID, v.User.InstanceAdmin)
110 groups, err := s.Store.ListGroups(r.Context(), v.User.ID)
111 111 if err != nil {
112 112 http.Error(w, "overzicht", http.StatusInternalServerError)
113 113 return
@@ -116,7 +116,7 @@ func (s *Server) home(w http.ResponseWriter, r *http.Request) {
116 116 s.render(w, "dashboard", v)
117 117 return
118 118 }
119 ids, err := s.Store.ListRepoIDs(r.Context(), 0, false)
119 ids, err := s.Store.ListRepoIDs(r.Context(), 0)
120 120 if err == nil {
121 121 v.Repos, _ = s.Store.ReposByIDs(r.Context(), ids)
122 122 }
@@ -128,7 +128,7 @@ func (s *Server) newPage(w http.ResponseWriter, r *http.Request) {
128 128 return
129 129 }
130 130 v := s.view(w, r, "Nieuw")
131 v.Groups, _ = s.Store.ListGroups(r.Context(), v.User.ID, false)
131 v.Groups, _ = s.Store.ListGroups(r.Context(), v.User.ID)
132 132 s.render(w, "new", v)
133 133 }
134 134
@@ -221,7 +221,7 @@ func (s *Server) export(w http.ResponseWriter, r *http.Request) {
221 221 Value string `json:"value"`
222 222 }
223 223 var secrets []secretRow
224 ids, _ := s.Store.ListRepoIDs(r.Context(), u.ID, false)
224 ids, _ := s.Store.ListRepoIDs(r.Context(), u.ID)
225 225 for _, id := range ids {
226 226 role, err := s.Store.EffectiveRole(r.Context(), u.ID, id)
227 227 if err != nil || !role.CanManageSecrets() {
@@ -239,7 +239,7 @@ func (s *Server) export(w http.ResponseWriter, r *http.Request) {
239 239 secrets = append(secrets, secretRow{Scope: "repo:" + repo.FullPath(), Name: name, Value: value})
240 240 }
241 241 }
242 groups, _ := s.Store.ListGroups(r.Context(), u.ID, false)
242 groups, _ := s.Store.ListGroups(r.Context(), u.ID)
243 243 for _, g := range groups {
244 244 role, err := s.Store.GroupRole(r.Context(), g.ID, u.ID)
245 245 if err != nil || !role.AtLeast(access.RoleMaintainer) {
@@ -96,7 +96,7 @@ func (s *Server) logout(w http.ResponseWriter, r *http.Request) {
96func (s *Server) home(w http.ResponseWriter, r *http.Request) {
96func (s *Server) home(w http.ResponseWriter, r *http.Request) {
97 v := s.view(w, r, "BlueGit")
97 v := s.view(w, r, "BlueGit")
98 if v.User != nil {
98 if v.User != nil {
99 ids, err := s.Store.ListRepoIDs(r.Context(), v.User.ID, v.User.InstanceAdmin)
99 ids, err := s.Store.ListRepoIDs(r.Context(), v.User.ID)
100 if err != nil {
100 if err != nil {
101 http.Error(w, "overzicht", http.StatusInternalServerError)
101 http.Error(w, "overzicht", http.StatusInternalServerError)
102 return
102 return
@@ -107,7 +107,7 @@ func (s *Server) home(w http.ResponseWriter, r *http.Request) {
107 return
107 return
108 }
108 }
109 v.Repos = repos
109 v.Repos = repos
110 groups, err := s.Store.ListGroups(r.Context(), v.User.ID, v.User.InstanceAdmin)
110 groups, err := s.Store.ListGroups(r.Context(), v.User.ID)
111 if err != nil {
111 if err != nil {
112 http.Error(w, "overzicht", http.StatusInternalServerError)
112 http.Error(w, "overzicht", http.StatusInternalServerError)
113 return
113 return
@@ -116,7 +116,7 @@ func (s *Server) home(w http.ResponseWriter, r *http.Request) {
116 s.render(w, "dashboard", v)
116 s.render(w, "dashboard", v)
117 return
117 return
118 }
118 }
119 ids, err := s.Store.ListRepoIDs(r.Context(), 0, false)
119 ids, err := s.Store.ListRepoIDs(r.Context(), 0)
120 if err == nil {
120 if err == nil {
121 v.Repos, _ = s.Store.ReposByIDs(r.Context(), ids)
121 v.Repos, _ = s.Store.ReposByIDs(r.Context(), ids)
122 }
122 }
@@ -128,7 +128,7 @@ func (s *Server) newPage(w http.ResponseWriter, r *http.Request) {
128 return
128 return
129 }
129 }
130 v := s.view(w, r, "Nieuw")
130 v := s.view(w, r, "Nieuw")
131 v.Groups, _ = s.Store.ListGroups(r.Context(), v.User.ID, false)
131 v.Groups, _ = s.Store.ListGroups(r.Context(), v.User.ID)
132 s.render(w, "new", v)
132 s.render(w, "new", v)
133}
133}
134
134
@@ -221,7 +221,7 @@ func (s *Server) export(w http.ResponseWriter, r *http.Request) {
221 Value string `json:"value"`
221 Value string `json:"value"`
222 }
222 }
223 var secrets []secretRow
223 var secrets []secretRow
224 ids, _ := s.Store.ListRepoIDs(r.Context(), u.ID, false)
224 ids, _ := s.Store.ListRepoIDs(r.Context(), u.ID)
225 for _, id := range ids {
225 for _, id := range ids {
226 role, err := s.Store.EffectiveRole(r.Context(), u.ID, id)
226 role, err := s.Store.EffectiveRole(r.Context(), u.ID, id)
227 if err != nil || !role.CanManageSecrets() {
227 if err != nil || !role.CanManageSecrets() {
@@ -239,7 +239,7 @@ func (s *Server) export(w http.ResponseWriter, r *http.Request) {
239 secrets = append(secrets, secretRow{Scope: "repo:" + repo.FullPath(), Name: name, Value: value})
239 secrets = append(secrets, secretRow{Scope: "repo:" + repo.FullPath(), Name: name, Value: value})
240 }
240 }
241 }
241 }
242 groups, _ := s.Store.ListGroups(r.Context(), u.ID, false)
242 groups, _ := s.Store.ListGroups(r.Context(), u.ID)
243 for _, g := range groups {
243 for _, g := range groups {
244 role, err := s.Store.GroupRole(r.Context(), g.ID, u.ID)
244 role, err := s.Store.GroupRole(r.Context(), g.ID, u.ID)
245 if err != nil || !role.AtLeast(access.RoleMaintainer) {
245 if err != nil || !role.AtLeast(access.RoleMaintainer) {
internal/server/repo_handlers.go +1 −10
@@ -2,7 +2,6 @@ package server
2 2
3 3 import (
4 4 "net/http"
5 "net/url"
6 5 "strconv"
7 6 "strings"
8 7
@@ -53,15 +52,7 @@ func (s *Server) repoView(w http.ResponseWriter, r *http.Request, repo store.Rep
53 52 v.CanAdmin = role.CanManageSettings()
54 53 v.Rev = safeRev(r.URL.Query().Get("rev"), repo.DefaultBranch)
55 54 v.CloneHTTP = strings.TrimRight(s.Cfg.BaseURL, "/") + "/" + repo.FullPath() + ".git"
56 if s.Cfg.SSH.Enabled {
57 u, _ := url.Parse(s.Cfg.BaseURL)
58 host := u.Hostname()
59 port := "2222"
60 if _, p, ok := strings.Cut(s.Cfg.SSH.Listen, ":"); ok && p != "" {
61 port = p
62 }
63 v.CloneSSH = "ssh://git@" + host + ":" + port + "/" + repo.FullPath() + ".git"
64 }
55 v.CloneSSH = s.Cfg.CloneSSH(repo.FullPath())
65 56 return v
66 57 }
67 58
@@ -2,7 +2,6 @@ package server
2
2
3import (
3import (
4 "net/http"
4 "net/http"
5 "net/url"
6 "strconv"
5 "strconv"
7 "strings"
6 "strings"
8
7
@@ -53,15 +52,7 @@ func (s *Server) repoView(w http.ResponseWriter, r *http.Request, repo store.Rep
53 v.CanAdmin = role.CanManageSettings()
52 v.CanAdmin = role.CanManageSettings()
54 v.Rev = safeRev(r.URL.Query().Get("rev"), repo.DefaultBranch)
53 v.Rev = safeRev(r.URL.Query().Get("rev"), repo.DefaultBranch)
55 v.CloneHTTP = strings.TrimRight(s.Cfg.BaseURL, "/") + "/" + repo.FullPath() + ".git"
54 v.CloneHTTP = strings.TrimRight(s.Cfg.BaseURL, "/") + "/" + repo.FullPath() + ".git"
56 if s.Cfg.SSH.Enabled {
55 v.CloneSSH = s.Cfg.CloneSSH(repo.FullPath())
57 u, _ := url.Parse(s.Cfg.BaseURL)
58 host := u.Hostname()
59 port := "2222"
60 if _, p, ok := strings.Cut(s.Cfg.SSH.Listen, ":"); ok && p != "" {
61 port = p
62 }
63 v.CloneSSH = "ssh://git@" + host + ":" + port + "/" + repo.FullPath() + ".git"
64 }
65 return v
56 return v
66}
57}
67
58
internal/server/server.go +9 −1
@@ -16,6 +16,7 @@ import (
16 16 "gitlab.com/Timfa/bluegit/internal/access"
17 17 "gitlab.com/Timfa/bluegit/internal/auth"
18 18 "gitlab.com/Timfa/bluegit/internal/config"
19 "gitlab.com/Timfa/bluegit/internal/realip"
19 20 "gitlab.com/Timfa/bluegit/internal/runner"
20 21 "gitlab.com/Timfa/bluegit/internal/store"
21 22 )
@@ -107,7 +108,14 @@ func (s *Server) Handler() http.Handler {
107 108 mux.HandleFunc("POST /{owner}/{repo}/-/webhooks/delete", s.repoWebhookDelete)
108 109 mux.HandleFunc("POST /{owner}/{repo}/-/delete", s.deleteRepo)
109 110
110 return s.withSession(s.secure(mux))
111 return s.realIP(s.withSession(s.secure(mux)))
112 }
113
114 func (s *Server) realIP(next http.Handler) http.Handler {
115 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
116 realip.Apply(r, s.Cfg.ProxySet())
117 next.ServeHTTP(w, r)
118 })
111 119 }
112 120
113 121 func (s *Server) mustTemplates() {
@@ -16,6 +16,7 @@ import (
16 "gitlab.com/Timfa/bluegit/internal/access"
16 "gitlab.com/Timfa/bluegit/internal/access"
17 "gitlab.com/Timfa/bluegit/internal/auth"
17 "gitlab.com/Timfa/bluegit/internal/auth"
18 "gitlab.com/Timfa/bluegit/internal/config"
18 "gitlab.com/Timfa/bluegit/internal/config"
19 "gitlab.com/Timfa/bluegit/internal/realip"
19 "gitlab.com/Timfa/bluegit/internal/runner"
20 "gitlab.com/Timfa/bluegit/internal/runner"
20 "gitlab.com/Timfa/bluegit/internal/store"
21 "gitlab.com/Timfa/bluegit/internal/store"
21)
22)
@@ -107,7 +108,14 @@ func (s *Server) Handler() http.Handler {
107 mux.HandleFunc("POST /{owner}/{repo}/-/webhooks/delete", s.repoWebhookDelete)
108 mux.HandleFunc("POST /{owner}/{repo}/-/webhooks/delete", s.repoWebhookDelete)
108 mux.HandleFunc("POST /{owner}/{repo}/-/delete", s.deleteRepo)
109 mux.HandleFunc("POST /{owner}/{repo}/-/delete", s.deleteRepo)
109
110
110 return s.withSession(s.secure(mux))
111 return s.realIP(s.withSession(s.secure(mux)))
112}
113
114func (s *Server) realIP(next http.Handler) http.Handler {
115 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
116 realip.Apply(r, s.Cfg.ProxySet())
117 next.ServeHTTP(w, r)
118 })
111}
119}
112
120
113func (s *Server) mustTemplates() {
121func (s *Server) mustTemplates() {
internal/server/server_test.go +10 −3
@@ -33,7 +33,8 @@ func TestWebRepoPushAndSecretBoundary(t *testing.T) {
33 33 cfg := config.Config{
34 34 BaseURL: "http://127.0.0.1:9", Listen: "127.0.0.1:0", StoragePath: storage,
35 35 Auth: config.Auth{Mode: "dev", DevUser: "tim", DevAuthID: 1, UserAgent: "test"},
36 Git: config.Git{Binary: "git", DefaultBranch: "main"},
36 Git: config.Git{Binary: "git", DefaultBranch: "master"},
37 SSH: config.SSH{Enabled: true, Listen: "0.0.0.0:2222", PublicHost: "git.timfalken.com", PublicPort: 22},
37 38 CI: config.CI{Enabled: false},
38 39 }
39 40 cfg.Auth.BaseURL = "https://auth.timfalken.com"
@@ -68,6 +69,12 @@ func TestWebRepoPushAndSecretBoundary(t *testing.T) {
68 69 if !strings.Contains(body, "tim/demo") {
69 70 t.Fatalf("repo pagina:\n%s", body)
70 71 }
72 if !strings.Contains(body, "ssh://git@git.timfalken.com:22/tim/demo.git") {
73 t.Fatalf("clone-URL hoort de publieke SSH-poort te tonen:\n%s", body)
74 }
75 if strings.Contains(body, ":2222/") {
76 t.Fatalf("clone-URL toont de bindpoort:\n%s", body)
77 }
71 78
72 79 res, err = client.PostForm(ts.URL+"/settings/tokens", url.Values{"csrf": {csrfOf(t, body)}, "name": {"test"}})
73 80 if err != nil {
@@ -80,7 +87,7 @@ func TestWebRepoPushAndSecretBoundary(t *testing.T) {
80 87 }
81 88
82 89 work := t.TempDir()
83 git(t, work, "init", "-b", "main")
90 git(t, work, "init", "-b", "master")
84 91 git(t, work, "config", "user.email", "tim@users.git.timfalken.com")
85 92 git(t, work, "config", "user.name", "tim")
86 93 if err := os.WriteFile(filepath.Join(work, "README.md"), []byte("hallo bluegit\n"), 0o644); err != nil {
@@ -90,7 +97,7 @@ func TestWebRepoPushAndSecretBoundary(t *testing.T) {
90 97 git(t, work, "commit", "-m", "eerste commit")
91 98 remote := strings.Replace(ts.URL, "http://", "http://tim:"+token+"@", 1) + "/tim/demo.git"
92 99 git(t, work, "remote", "add", "origin", remote)
93 git(t, work, "push", "-u", "origin", "main")
100 git(t, work, "push", "-u", "origin", "master")
94 101
95 102 res, err = client.Get(ts.URL + "/tim/demo")
96 103 if err != nil {
@@ -33,7 +33,8 @@ func TestWebRepoPushAndSecretBoundary(t *testing.T) {
33 cfg := config.Config{
33 cfg := config.Config{
34 BaseURL: "http://127.0.0.1:9", Listen: "127.0.0.1:0", StoragePath: storage,
34 BaseURL: "http://127.0.0.1:9", Listen: "127.0.0.1:0", StoragePath: storage,
35 Auth: config.Auth{Mode: "dev", DevUser: "tim", DevAuthID: 1, UserAgent: "test"},
35 Auth: config.Auth{Mode: "dev", DevUser: "tim", DevAuthID: 1, UserAgent: "test"},
36 Git: config.Git{Binary: "git", DefaultBranch: "main"},
36 Git: config.Git{Binary: "git", DefaultBranch: "master"},
37 SSH: config.SSH{Enabled: true, Listen: "0.0.0.0:2222", PublicHost: "git.timfalken.com", PublicPort: 22},
37 CI: config.CI{Enabled: false},
38 CI: config.CI{Enabled: false},
38 }
39 }
39 cfg.Auth.BaseURL = "https://auth.timfalken.com"
40 cfg.Auth.BaseURL = "https://auth.timfalken.com"
@@ -68,6 +69,12 @@ func TestWebRepoPushAndSecretBoundary(t *testing.T) {
68 if !strings.Contains(body, "tim/demo") {
69 if !strings.Contains(body, "tim/demo") {
69 t.Fatalf("repo pagina:\n%s", body)
70 t.Fatalf("repo pagina:\n%s", body)
70 }
71 }
72 if !strings.Contains(body, "ssh://git@git.timfalken.com:22/tim/demo.git") {
73 t.Fatalf("clone-URL hoort de publieke SSH-poort te tonen:\n%s", body)
74 }
75 if strings.Contains(body, ":2222/") {
76 t.Fatalf("clone-URL toont de bindpoort:\n%s", body)
77 }
71
78
72 res, err = client.PostForm(ts.URL+"/settings/tokens", url.Values{"csrf": {csrfOf(t, body)}, "name": {"test"}})
79 res, err = client.PostForm(ts.URL+"/settings/tokens", url.Values{"csrf": {csrfOf(t, body)}, "name": {"test"}})
73 if err != nil {
80 if err != nil {
@@ -80,7 +87,7 @@ func TestWebRepoPushAndSecretBoundary(t *testing.T) {
80 }
87 }
81
88
82 work := t.TempDir()
89 work := t.TempDir()
83 git(t, work, "init", "-b", "main")
90 git(t, work, "init", "-b", "master")
84 git(t, work, "config", "user.email", "tim@users.git.timfalken.com")
91 git(t, work, "config", "user.email", "tim@users.git.timfalken.com")
85 git(t, work, "config", "user.name", "tim")
92 git(t, work, "config", "user.name", "tim")
86 if err := os.WriteFile(filepath.Join(work, "README.md"), []byte("hallo bluegit\n"), 0o644); err != nil {
93 if err := os.WriteFile(filepath.Join(work, "README.md"), []byte("hallo bluegit\n"), 0o644); err != nil {
@@ -90,7 +97,7 @@ func TestWebRepoPushAndSecretBoundary(t *testing.T) {
90 git(t, work, "commit", "-m", "eerste commit")
97 git(t, work, "commit", "-m", "eerste commit")
91 remote := strings.Replace(ts.URL, "http://", "http://tim:"+token+"@", 1) + "/tim/demo.git"
98 remote := strings.Replace(ts.URL, "http://", "http://tim:"+token+"@", 1) + "/tim/demo.git"
92 git(t, work, "remote", "add", "origin", remote)
99 git(t, work, "remote", "add", "origin", remote)
93 git(t, work, "push", "-u", "origin", "main")
100 git(t, work, "push", "-u", "origin", "master")
94
101
95 res, err = client.Get(ts.URL + "/tim/demo")
102 res, err = client.Get(ts.URL + "/tim/demo")
96 if err != nil {
103 if err != nil {
internal/server/templates/collab.html +2 −2
@@ -120,7 +120,7 @@
120 120 {{else if eq .Tab "branches"}}
121 121 <form class="panel" method="post" action="/{{.Repo.FullPath}}/-/protected">
122 122 <input type="hidden" name="csrf" value="{{.CSRF}}">
123 <div class="row"><input name="pattern" placeholder="main of release/*" required><button type="submit">Beschermen</button></div>
123 <div class="row"><input name="pattern" placeholder="master of release/*" required><button type="submit">Beschermen</button></div>
124 124 </form>
125 125 <ul class="clean">{{range .Patterns}}<li><code>{{.}}</code>
126 126 <form method="post" action="/{{$.Repo.FullPath}}/-/protected/remove"><input type="hidden" name="csrf" value="{{$.CSRF}}"><input type="hidden" name="pattern" value="{{.}}"><button class="ghost" type="submit">Weg</button></form>
@@ -170,7 +170,7 @@
170 170 </select>
171 171 </label>
172 172 <label>URL <input name="url" placeholder="https://example.test/hook" required></label>
173 <label>Branchfilter voor push <input name="branch_filter" placeholder="leeg, main, of re:^release/.*"></label>
173 <label>Branchfilter voor push <input name="branch_filter" placeholder="leeg, master, of re:^release/.*"></label>
174 174 <label>Headers, één per regel <textarea name="headers" placeholder="Authorization: Bearer secret.GROK_TOKEN tussen dubbele accolades"></textarea></label>
175 175 <label>Body-sjabloon, leeg is de gebeurtenis als JSON <textarea name="body" placeholder="Discord: een JSON-object met content"></textarea></label>
176 176 <fieldset>
@@ -120,7 +120,7 @@
120{{else if eq .Tab "branches"}}
120{{else if eq .Tab "branches"}}
121<form class="panel" method="post" action="/{{.Repo.FullPath}}/-/protected">
121<form class="panel" method="post" action="/{{.Repo.FullPath}}/-/protected">
122 <input type="hidden" name="csrf" value="{{.CSRF}}">
122 <input type="hidden" name="csrf" value="{{.CSRF}}">
123 <div class="row"><input name="pattern" placeholder="main of release/*" required><button type="submit">Beschermen</button></div>
123 <div class="row"><input name="pattern" placeholder="master of release/*" required><button type="submit">Beschermen</button></div>
124</form>
124</form>
125<ul class="clean">{{range .Patterns}}<li><code>{{.}}</code>
125<ul class="clean">{{range .Patterns}}<li><code>{{.}}</code>
126 <form method="post" action="/{{$.Repo.FullPath}}/-/protected/remove"><input type="hidden" name="csrf" value="{{$.CSRF}}"><input type="hidden" name="pattern" value="{{.}}"><button class="ghost" type="submit">Weg</button></form>
126 <form method="post" action="/{{$.Repo.FullPath}}/-/protected/remove"><input type="hidden" name="csrf" value="{{$.CSRF}}"><input type="hidden" name="pattern" value="{{.}}"><button class="ghost" type="submit">Weg</button></form>
@@ -170,7 +170,7 @@
170 </select>
170 </select>
171 </label>
171 </label>
172 <label>URL <input name="url" placeholder="https://example.test/hook" required></label>
172 <label>URL <input name="url" placeholder="https://example.test/hook" required></label>
173 <label>Branchfilter voor push <input name="branch_filter" placeholder="leeg, main, of re:^release/.*"></label>
173 <label>Branchfilter voor push <input name="branch_filter" placeholder="leeg, master, of re:^release/.*"></label>
174 <label>Headers, één per regel <textarea name="headers" placeholder="Authorization: Bearer secret.GROK_TOKEN tussen dubbele accolades"></textarea></label>
174 <label>Headers, één per regel <textarea name="headers" placeholder="Authorization: Bearer secret.GROK_TOKEN tussen dubbele accolades"></textarea></label>
175 <label>Body-sjabloon, leeg is de gebeurtenis als JSON <textarea name="body" placeholder="Discord: een JSON-object met content"></textarea></label>
175 <label>Body-sjabloon, leeg is de gebeurtenis als JSON <textarea name="body" placeholder="Discord: een JSON-object met content"></textarea></label>
176 <fieldset>
176 <fieldset>
internal/store/repos.go +14 −27
@@ -106,19 +106,13 @@ func scanGroup(row *sql.Row) (Group, error) {
106 106 }
107 107
108 108 // GroupRole is de rol van een gebruiker in een groep.
109 // Installatiebeheer geeft geen lidmaatschap.
109 110 func (s *Store) GroupRole(ctx context.Context, groupID, userID int64) (access.Role, error) {
110 111 if userID == 0 {
111 112 return access.RoleNone, nil
112 113 }
113 u, err := s.UserByID(ctx, userID)
114 if err != nil {
115 return access.RoleNone, err
116 }
117 if u.InstanceAdmin {
118 return access.RoleMaintainer, nil
119 }
120 114 var role string
121 err = s.db.QueryRowContext(ctx, `SELECT role FROM group_members WHERE group_id = ? AND user_id = ?`, groupID, userID).Scan(&role)
115 err := s.db.QueryRowContext(ctx, `SELECT role FROM group_members WHERE group_id = ? AND user_id = ?`, groupID, userID).Scan(&role)
122 116 if errors.Is(err, sql.ErrNoRows) {
123 117 return access.RoleNone, nil
124 118 }
@@ -128,15 +122,10 @@ func (s *Store) GroupRole(ctx context.Context, groupID, userID int64) (access.Ro
128 122 return access.Role(role), nil
129 123 }
130 124
131 // ListGroups geeft de groepen van een gebruiker. Een installatiebeheerder ziet ze allemaal.
132 func (s *Store) ListGroups(ctx context.Context, userID int64, all bool) ([]Group, error) {
133 q := `SELECT id, name, path, description, created_by, created_at FROM groups`
134 var args []any
135 if !all {
136 q += ` WHERE id IN (SELECT group_id FROM group_members WHERE user_id = ?)`
137 args = append(args, userID)
138 }
139 q += ` ORDER BY path`
125 // ListGroups geeft de groepen waarvan deze gebruiker lid is.
126 func (s *Store) ListGroups(ctx context.Context, userID int64) ([]Group, error) {
127 q := `SELECT id, name, path, description, created_by, created_at FROM groups WHERE id IN (SELECT group_id FROM group_members WHERE user_id = ?) ORDER BY path`
128 args := []any{userID}
140 129 rows, err := s.db.QueryContext(ctx, q, args...)
141 130 if err != nil {
142 131 return nil, err
@@ -167,7 +156,7 @@ func (s *Store) CreateRepo(ctx context.Context, ownerKind string, ownerID int64,
167 156 return Repo{}, fmt.Errorf("zichtbaarheid moet public of private zijn")
168 157 }
169 158 if defaultBranch == "" {
170 defaultBranch = "main"
159 defaultBranch = "master"
171 160 }
172 161 if ownerKind == "user" {
173 162 u, err := s.UserByID(ctx, ownerID)
@@ -246,8 +235,11 @@ func (s *Store) DeleteRepo(ctx context.Context, id int64) error {
246 235 return err
247 236 }
248 237
249 // ListRepoIDs geeft repositories die deze gebruiker mag zien.
250 func (s *Store) ListRepoIDs(ctx context.Context, userID int64, instanceAdmin bool) ([]int64, error) {
238 // ListRepoIDs geeft repositories die deze gebruiker mag zien:
239 // openbare repositories, eigen repositories, repositories van een groep
240 // waarvan hij lid is, en repositories met een rechtstreeks lidmaatschap.
241 // Installatiebeheer voegt daar niets aan toe.
242 func (s *Store) ListRepoIDs(ctx context.Context, userID int64) ([]int64, error) {
251 243 q := `SELECT id FROM repos WHERE visibility = 'public'`
252 244 args := []any{}
253 245 if userID != 0 {
@@ -256,10 +248,6 @@ func (s *Store) ListRepoIDs(ctx context.Context, userID int64, instanceAdmin boo
256 248 OR (owner_kind = 'group' AND owner_id IN (SELECT group_id FROM group_members WHERE user_id = ?))
257 249 OR id IN (SELECT repo_id FROM repo_members WHERE user_id = ?)`
258 250 args = []any{userID, userID, userID}
259 if instanceAdmin {
260 q = `SELECT id FROM repos`
261 args = nil
262 }
263 251 }
264 252 q += ` ORDER BY id DESC`
265 253 rows, err := s.db.QueryContext(ctx, q, args...)
@@ -332,15 +320,14 @@ func (s *Store) EffectiveRole(ctx context.Context, userID, repoID int64) (access
332 320 if userID == 0 {
333 321 return access.RoleNone, nil
334 322 }
335 u, err := s.UserByID(ctx, userID)
336 if err != nil {
323 if _, err := s.UserByID(ctx, userID); err != nil {
337 324 return access.RoleNone, err
338 325 }
339 326 repo, err := s.RepoByID(ctx, repoID)
340 327 if err != nil {
341 328 return access.RoleNone, err
342 329 }
343 in := access.Input{InstanceAdmin: u.InstanceAdmin}
330 in := access.Input{}
344 331 if repo.OwnerKind == "user" && repo.OwnerID == userID {
345 332 in.UserOwner = true
346 333 }
@@ -106,19 +106,13 @@ func scanGroup(row *sql.Row) (Group, error) {
106}
106}
107
107
108// GroupRole is de rol van een gebruiker in een groep.
108// GroupRole is de rol van een gebruiker in een groep.
109// Installatiebeheer geeft geen lidmaatschap.
109func (s *Store) GroupRole(ctx context.Context, groupID, userID int64) (access.Role, error) {
110func (s *Store) GroupRole(ctx context.Context, groupID, userID int64) (access.Role, error) {
110 if userID == 0 {
111 if userID == 0 {
111 return access.RoleNone, nil
112 return access.RoleNone, nil
112 }
113 }
113 u, err := s.UserByID(ctx, userID)
114 if err != nil {
115 return access.RoleNone, err
116 }
117 if u.InstanceAdmin {
118 return access.RoleMaintainer, nil
119 }
120 var role string
114 var role string
121 err = s.db.QueryRowContext(ctx, `SELECT role FROM group_members WHERE group_id = ? AND user_id = ?`, groupID, userID).Scan(&role)
115 err := s.db.QueryRowContext(ctx, `SELECT role FROM group_members WHERE group_id = ? AND user_id = ?`, groupID, userID).Scan(&role)
122 if errors.Is(err, sql.ErrNoRows) {
116 if errors.Is(err, sql.ErrNoRows) {
123 return access.RoleNone, nil
117 return access.RoleNone, nil
124 }
118 }
@@ -128,15 +122,10 @@ func (s *Store) GroupRole(ctx context.Context, groupID, userID int64) (access.Ro
128 return access.Role(role), nil
122 return access.Role(role), nil
129}
123}
130
124
131// ListGroups geeft de groepen van een gebruiker. Een installatiebeheerder ziet ze allemaal.
125// ListGroups geeft de groepen waarvan deze gebruiker lid is.
132func (s *Store) ListGroups(ctx context.Context, userID int64, all bool) ([]Group, error) {
126func (s *Store) ListGroups(ctx context.Context, userID int64) ([]Group, error) {
133 q := `SELECT id, name, path, description, created_by, created_at FROM groups`
127 q := `SELECT id, name, path, description, created_by, created_at FROM groups WHERE id IN (SELECT group_id FROM group_members WHERE user_id = ?) ORDER BY path`
134 var args []any
128 args := []any{userID}
135 if !all {
136 q += ` WHERE id IN (SELECT group_id FROM group_members WHERE user_id = ?)`
137 args = append(args, userID)
138 }
139 q += ` ORDER BY path`
140 rows, err := s.db.QueryContext(ctx, q, args...)
129 rows, err := s.db.QueryContext(ctx, q, args...)
141 if err != nil {
130 if err != nil {
142 return nil, err
131 return nil, err
@@ -167,7 +156,7 @@ func (s *Store) CreateRepo(ctx context.Context, ownerKind string, ownerID int64,
167 return Repo{}, fmt.Errorf("zichtbaarheid moet public of private zijn")
156 return Repo{}, fmt.Errorf("zichtbaarheid moet public of private zijn")
168 }
157 }
169 if defaultBranch == "" {
158 if defaultBranch == "" {
170 defaultBranch = "main"
159 defaultBranch = "master"
171 }
160 }
172 if ownerKind == "user" {
161 if ownerKind == "user" {
173 u, err := s.UserByID(ctx, ownerID)
162 u, err := s.UserByID(ctx, ownerID)
@@ -246,8 +235,11 @@ func (s *Store) DeleteRepo(ctx context.Context, id int64) error {
246 return err
235 return err
247}
236}
248
237
249// ListRepoIDs geeft repositories die deze gebruiker mag zien.
238// ListRepoIDs geeft repositories die deze gebruiker mag zien:
250func (s *Store) ListRepoIDs(ctx context.Context, userID int64, instanceAdmin bool) ([]int64, error) {
239// openbare repositories, eigen repositories, repositories van een groep
240// waarvan hij lid is, en repositories met een rechtstreeks lidmaatschap.
241// Installatiebeheer voegt daar niets aan toe.
242func (s *Store) ListRepoIDs(ctx context.Context, userID int64) ([]int64, error) {
251 q := `SELECT id FROM repos WHERE visibility = 'public'`
243 q := `SELECT id FROM repos WHERE visibility = 'public'`
252 args := []any{}
244 args := []any{}
253 if userID != 0 {
245 if userID != 0 {
@@ -256,10 +248,6 @@ func (s *Store) ListRepoIDs(ctx context.Context, userID int64, instanceAdmin boo
256 OR (owner_kind = 'group' AND owner_id IN (SELECT group_id FROM group_members WHERE user_id = ?))
248 OR (owner_kind = 'group' AND owner_id IN (SELECT group_id FROM group_members WHERE user_id = ?))
257 OR id IN (SELECT repo_id FROM repo_members WHERE user_id = ?)`
249 OR id IN (SELECT repo_id FROM repo_members WHERE user_id = ?)`
258 args = []any{userID, userID, userID}
250 args = []any{userID, userID, userID}
259 if instanceAdmin {
260 q = `SELECT id FROM repos`
261 args = nil
262 }
263 }
251 }
264 q += ` ORDER BY id DESC`
252 q += ` ORDER BY id DESC`
265 rows, err := s.db.QueryContext(ctx, q, args...)
253 rows, err := s.db.QueryContext(ctx, q, args...)
@@ -332,15 +320,14 @@ func (s *Store) EffectiveRole(ctx context.Context, userID, repoID int64) (access
332 if userID == 0 {
320 if userID == 0 {
333 return access.RoleNone, nil
321 return access.RoleNone, nil
334 }
322 }
335 u, err := s.UserByID(ctx, userID)
323 if _, err := s.UserByID(ctx, userID); err != nil {
336 if err != nil {
337 return access.RoleNone, err
324 return access.RoleNone, err
338 }
325 }
339 repo, err := s.RepoByID(ctx, repoID)
326 repo, err := s.RepoByID(ctx, repoID)
340 if err != nil {
327 if err != nil {
341 return access.RoleNone, err
328 return access.RoleNone, err
342 }
329 }
343 in := access.Input{InstanceAdmin: u.InstanceAdmin}
330 in := access.Input{}
344 if repo.OwnerKind == "user" && repo.OwnerID == userID {
331 if repo.OwnerKind == "user" && repo.OwnerID == userID {
345 in.UserOwner = true
332 in.UserOwner = true
346 }
333 }
internal/store/role_test.go +60 −0
@@ -25,6 +25,13 @@ func TestRolesSecretsAndPending(t *testing.T) {
25 25 if ada.InstanceAdmin {
26 26 t.Fatal("tweede gebruiker is geen installatiebeheerder")
27 27 }
28 authAdmin, err := s.UpsertUser(ctx, 9, "authadmin", "", true)
29 if err != nil {
30 t.Fatal(err)
31 }
32 if authAdmin.InstanceAdmin || !authAdmin.AuthAdmin {
33 t.Fatalf("is_admin van de auth-server geeft geen BlueGit-beheer: %+v", authAdmin)
34 }
28 35 repo, err := s.CreateRepo(ctx, "user", tim.ID, "bluegit", "zelf", "main", "private")
29 36 if err != nil {
30 37 t.Fatal(err)
@@ -97,6 +104,59 @@ func TestRolesSecretsAndPending(t *testing.T) {
97 104 if err != nil || len(names) != 1 || names[0].Name != "DEPLOY_KEY" {
98 105 t.Fatalf("namen %+v", names)
99 106 }
107
108 foreign, err := s.CreateRepo(ctx, "user", ada.ID, "geheim", "", "", "private")
109 if err != nil {
110 t.Fatal(err)
111 }
112 if foreign.DefaultBranch != "master" {
113 t.Fatalf("lege standaardbranch werd %s", foreign.DefaultBranch)
114 }
115 role, err = s.EffectiveRole(ctx, tim.ID, foreign.ID)
116 if err != nil || role != access.RoleNone {
117 t.Fatalf("installatiebeheerder op andermans repo: %s %v", role, err)
118 }
119 ids, err := s.ListRepoIDs(ctx, tim.ID)
120 if err != nil {
121 t.Fatal(err)
122 }
123 for _, id := range ids {
124 if id == foreign.ID {
125 t.Fatal("installatiebeheerder ziet een privérepository van een ander")
126 }
127 }
128 foreignGroup, err := s.CreateGroup(ctx, ada.ID, "Ada", "ada-werk", "")
129 if err != nil {
130 t.Fatal(err)
131 }
132 role, err = s.GroupRole(ctx, foreignGroup.ID, tim.ID)
133 if err != nil || role != access.RoleNone {
134 t.Fatalf("installatiebeheerder in andermans groep: %s %v", role, err)
135 }
136 groups, err := s.ListGroups(ctx, tim.ID)
137 if err != nil {
138 t.Fatal(err)
139 }
140 for _, g := range groups {
141 if g.ID == foreignGroup.ID {
142 t.Fatal("installatiebeheerder ziet andermans groep")
143 }
144 }
145 vals, err := s.SecretValues(ctx, "repo", foreign.ID, true)
146 if err != nil {
147 t.Fatal(err)
148 }
149 if len(vals) != 0 {
150 t.Fatalf("onverwachte geheimen %+v", vals)
151 }
152 if err := s.PutSecret(ctx, "repo", foreign.ID, "TOKEN", "van-ada", false); err != nil {
153 t.Fatal(err)
154 }
155 // De waarde is alleen bereikbaar voor wie de rol heeft. Die rol heeft Tim niet.
156 role, _ = s.EffectiveRole(ctx, tim.ID, foreign.ID)
157 if role.CanManageSecrets() {
158 t.Fatal("installatiebeheerder mag andermans geheim niet beheren")
159 }
100 160 }
101 161
102 162 func openTest(t *testing.T) *Store {
@@ -25,6 +25,13 @@ func TestRolesSecretsAndPending(t *testing.T) {
25 if ada.InstanceAdmin {
25 if ada.InstanceAdmin {
26 t.Fatal("tweede gebruiker is geen installatiebeheerder")
26 t.Fatal("tweede gebruiker is geen installatiebeheerder")
27 }
27 }
28 authAdmin, err := s.UpsertUser(ctx, 9, "authadmin", "", true)
29 if err != nil {
30 t.Fatal(err)
31 }
32 if authAdmin.InstanceAdmin || !authAdmin.AuthAdmin {
33 t.Fatalf("is_admin van de auth-server geeft geen BlueGit-beheer: %+v", authAdmin)
34 }
28 repo, err := s.CreateRepo(ctx, "user", tim.ID, "bluegit", "zelf", "main", "private")
35 repo, err := s.CreateRepo(ctx, "user", tim.ID, "bluegit", "zelf", "main", "private")
29 if err != nil {
36 if err != nil {
30 t.Fatal(err)
37 t.Fatal(err)
@@ -97,6 +104,59 @@ func TestRolesSecretsAndPending(t *testing.T) {
97 if err != nil || len(names) != 1 || names[0].Name != "DEPLOY_KEY" {
104 if err != nil || len(names) != 1 || names[0].Name != "DEPLOY_KEY" {
98 t.Fatalf("namen %+v", names)
105 t.Fatalf("namen %+v", names)
99 }
106 }
107
108 foreign, err := s.CreateRepo(ctx, "user", ada.ID, "geheim", "", "", "private")
109 if err != nil {
110 t.Fatal(err)
111 }
112 if foreign.DefaultBranch != "master" {
113 t.Fatalf("lege standaardbranch werd %s", foreign.DefaultBranch)
114 }
115 role, err = s.EffectiveRole(ctx, tim.ID, foreign.ID)
116 if err != nil || role != access.RoleNone {
117 t.Fatalf("installatiebeheerder op andermans repo: %s %v", role, err)
118 }
119 ids, err := s.ListRepoIDs(ctx, tim.ID)
120 if err != nil {
121 t.Fatal(err)
122 }
123 for _, id := range ids {
124 if id == foreign.ID {
125 t.Fatal("installatiebeheerder ziet een privérepository van een ander")
126 }
127 }
128 foreignGroup, err := s.CreateGroup(ctx, ada.ID, "Ada", "ada-werk", "")
129 if err != nil {
130 t.Fatal(err)
131 }
132 role, err = s.GroupRole(ctx, foreignGroup.ID, tim.ID)
133 if err != nil || role != access.RoleNone {
134 t.Fatalf("installatiebeheerder in andermans groep: %s %v", role, err)
135 }
136 groups, err := s.ListGroups(ctx, tim.ID)
137 if err != nil {
138 t.Fatal(err)
139 }
140 for _, g := range groups {
141 if g.ID == foreignGroup.ID {
142 t.Fatal("installatiebeheerder ziet andermans groep")
143 }
144 }
145 vals, err := s.SecretValues(ctx, "repo", foreign.ID, true)
146 if err != nil {
147 t.Fatal(err)
148 }
149 if len(vals) != 0 {
150 t.Fatalf("onverwachte geheimen %+v", vals)
151 }
152 if err := s.PutSecret(ctx, "repo", foreign.ID, "TOKEN", "van-ada", false); err != nil {
153 t.Fatal(err)
154 }
155 // De waarde is alleen bereikbaar voor wie de rol heeft. Die rol heeft Tim niet.
156 role, _ = s.EffectiveRole(ctx, tim.ID, foreign.ID)
157 if role.CanManageSecrets() {
158 t.Fatal("installatiebeheerder mag andermans geheim niet beheren")
159 }
100}
160}
101
161
102func openTest(t *testing.T) *Store {
162func openTest(t *testing.T) *Store {
packaging/bluegit.service +3 −2
@@ -14,8 +14,9 @@ Restart=on-failure
14 14 NoNewPrivileges=true
15 15 ProtectSystem=strict
16 16 ProtectHome=true
17 # /var/lib/bluegit is de fallback. De 4 TB-schijf staat in de drop-in
18 # packaging/storage.conf, omdat ProtectSystem het pad anders blokkeert.
17 # /var/lib/bluegit is de fallback. Het echte pad van de 4 TB-schijf is
18 # nog niet gekozen. Zet het in de drop-in packaging/storage.conf,
19 # omdat ProtectSystem een ander pad anders blokkeert.
19 20 ReadWritePaths=/var/lib/bluegit
20 21 PrivateTmp=true
21 22
@@ -14,8 +14,9 @@ Restart=on-failure
14NoNewPrivileges=true
14NoNewPrivileges=true
15ProtectSystem=strict
15ProtectSystem=strict
16ProtectHome=true
16ProtectHome=true
17# /var/lib/bluegit is de fallback. De 4 TB-schijf staat in de drop-in
17# /var/lib/bluegit is de fallback. Het echte pad van de 4 TB-schijf is
18# packaging/storage.conf, omdat ProtectSystem het pad anders blokkeert.
18# nog niet gekozen. Zet het in de drop-in packaging/storage.conf,
19# omdat ProtectSystem een ander pad anders blokkeert.
19ReadWritePaths=/var/lib/bluegit
20ReadWritePaths=/var/lib/bluegit
20PrivateTmp=true
21PrivateTmp=true
21
22
packaging/bluegit.yml +13 −4
@@ -1,9 +1,14 @@
1 1 # Voorbeeld voor de mini-PC. Kopieer naar /etc/bluegit/config.yml.
2 # Plain HTTP. TLS en de publieke SSH-poort doet de ingress, zie docs/INGRESS.md.
2 3 base_url: https://git.timfalken.com
3 listen: 127.0.0.1:8080
4 # De 4 TB-schijf. Database, repositories, artifacts en releases staan hier.
4 listen: 0.0.0.0:8080
5 # De 4 TB-schijf. Het mountpoint is nog niet gekozen; dit pad is een voorbeeld.
6 # Database, repositories, artifacts en releases staan hier.
5 7 storage_path: /mnt/storage/bluegit
6 behind_proxy: true
8 # Alleen deze adressen mogen X-Forwarded-For en X-Real-IP zetten.
9 # Zet hier het IP van de ingress, zoals de mini-PC die verbinding ziet.
10 trusted_proxies:
11 - 10.0.0.2
7 12
8 13 auth:
9 14 mode: oauth
@@ -17,11 +22,15 @@ auth:
17 22
18 23 git:
19 24 binary: git
20 default_branch: main
25 default_branch: master
21 26
22 27 ssh:
23 28 enabled: true
29 # Waar dit proces git-SSH aanneemt. De SSH van het besturingssysteem blijft vrij.
24 30 listen: 0.0.0.0:2222
31 # Wat gebruikers in de clone-URL zien. De ingress stuurt poort 22 hiernaartoe.
32 public_host: git.timfalken.com
33 public_port: 22
25 34
26 35 ci:
27 36 enabled: true
@@ -1,9 +1,14 @@
1# Voorbeeld voor de mini-PC. Kopieer naar /etc/bluegit/config.yml.
1# Voorbeeld voor de mini-PC. Kopieer naar /etc/bluegit/config.yml.
2# Plain HTTP. TLS en de publieke SSH-poort doet de ingress, zie docs/INGRESS.md.
2base_url: https://git.timfalken.com
3base_url: https://git.timfalken.com
3listen: 127.0.0.1:8080
4listen: 0.0.0.0:8080
4# De 4 TB-schijf. Database, repositories, artifacts en releases staan hier.
5# De 4 TB-schijf. Het mountpoint is nog niet gekozen; dit pad is een voorbeeld.
6# Database, repositories, artifacts en releases staan hier.
5storage_path: /mnt/storage/bluegit
7storage_path: /mnt/storage/bluegit
6behind_proxy: true
8# Alleen deze adressen mogen X-Forwarded-For en X-Real-IP zetten.
9# Zet hier het IP van de ingress, zoals de mini-PC die verbinding ziet.
10trusted_proxies:
11 - 10.0.0.2
7
12
8auth:
13auth:
9 mode: oauth
14 mode: oauth
@@ -17,11 +22,15 @@ auth:
17
22
18git:
23git:
19 binary: git
24 binary: git
20 default_branch: main
25 default_branch: master
21
26
22ssh:
27ssh:
23 enabled: true
28 enabled: true
29 # Waar dit proces git-SSH aanneemt. De SSH van het besturingssysteem blijft vrij.
24 listen: 0.0.0.0:2222
30 listen: 0.0.0.0:2222
31 # Wat gebruikers in de clone-URL zien. De ingress stuurt poort 22 hiernaartoe.
32 public_host: git.timfalken.com
33 public_port: 22
25
34
26ci:
35ci:
27 enabled: true
36 enabled: true
packaging/storage.conf +3 −1
@@ -1,4 +1,6 @@
1 1 # Zet dit neer als /etc/systemd/system/bluegit.service.d/storage.conf
2 # nadat de 4 TB-schijf gemount is. Het pad moet gelijk zijn aan storage_path.
2 # nadat de 4 TB-schijf gemount is. Het mountpoint is nog niet gekozen.
3 # Pas het pad aan tot het gelijk is aan storage_path. Dit voorbeeld wordt
4 # niet automatisch geactiveerd: een pad dat niet bestaat blokkeert de dienst.
3 5 [Service]
4 6 ReadWritePaths=/mnt/storage/bluegit
@@ -1,4 +1,6 @@
1# Zet dit neer als /etc/systemd/system/bluegit.service.d/storage.conf
1# Zet dit neer als /etc/systemd/system/bluegit.service.d/storage.conf
2# nadat de 4 TB-schijf gemount is. Het pad moet gelijk zijn aan storage_path.
2# nadat de 4 TB-schijf gemount is. Het mountpoint is nog niet gekozen.
3# Pas het pad aan tot het gelijk is aan storage_path. Dit voorbeeld wordt
4# niet automatisch geactiveerd: een pad dat niet bestaat blokkeert de dienst.
3[Service]
5[Service]
4ReadWritePaths=/mnt/storage/bluegit
6ReadWritePaths=/mnt/storage/bluegit