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>
@@ -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 aparte12
12
13
## Wat deze basis al doet13
## Wat deze basis al doet14
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 aparte22
- 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
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
## Lokaal proberen27
## Lokaal proberen28
28
@@ -64,22 +64,15 @@ cd packaging/arch && makepkg -si64
64
65
Daarna: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`.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.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`. Zonder die drop-in blokkeert `ProtectSystem` schrijven buiten `/var/lib/bluegit`.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
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.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
5. Zet het geheim in `/etc/bluegit/client_secret` (mode `0600`) of in `BLUEGIT_AUTH_CLIENT_SECRET` via `/etc/bluegit/secret.env`.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: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).73
74
```caddy75
git.timfalken.com {76
reverse_proxy 127.0.0.1:808077
}78
```79
80
7. `systemctl enable --now bluegit`. De eerste aanmelding wordt installatiebeheerder.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
## Rollen77
## Rollen85
78
@@ -91,7 +84,9 @@ Een repository hoort bij een gebruiker (die is beheerder) of bij een groep. Iema91
| 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
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
## CI, releases, webhooks91
## CI, releases, webhooks97
92
@@ -115,4 +110,4 @@ De kern zit in `internal/access` (rollen en beschermde branches), `internal/ci`115
110
116
## Licentie111
## Licentie117
112
118
MIT. Dat is een keuze voor deze basis; zeg het als het anders moet.113
MIT. Zie [LICENSE](LICENSE).@@ -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 de4
# DEPLOY_PATH en DEPLOY_SSH_KEY. Markeer ze als beschermd, en bescherm de5
# branch main (en master zolang die de standaard is). Dan komen die5
# branch master. Een regel voor main blijft staan, zodat een oude6
# geheimen alleen mee op een beschermde branch.6
# branch nog kan uitrollen. Dan komen die geheimen alleen mee op een7
# beschermde branch.7
8
8
stages: [test, build, release, deploy]9
stages: [test, build, release, deploy]9
10
@@ -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 @@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.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
```text5
```text6
browser ──HTTPS──▶ Caddy ──▶ bluegit (web + smart HTTP + API)6
browser ──HTTPS──▶ ingress ──HTTP──▶ bluegit (web + smart HTTP + API)7
git ──HTTPS──▶ Caddy ──▶ bluegit ──▶ git http-backend ──▶ pre-receive hook7
git ──HTTPS──▶ ingress ──HTTP──▶ bluegit ──▶ git http-backend ──▶ pre-receive hook8
git ──SSH:2222─────────▶ bluegit ──▶ git-receive-pack ──▶ dezelfde hook8
git ──SSH:22─▶ ingress ──TCP:2222──▶ bluegit ──▶ git-receive-pack ──▶ dezelfde hook9
bluegit ──bearer──▶ auth.timfalken.com9
bluegit ──bearer──▶ auth.timfalken.com10
bluegit ──docker run──▶ jobcontainer10
bluegit ──docker run──▶ jobcontainer11
jobcontainer ──CI_JOB_TOKEN──▶ API van bluegit (release)11
jobcontainer ──CI_JOB_TOKEN──▶ API van bluegit (release)12
jobcontainer ──SSH-geheim──▶ de host (deploy, gewone SSH)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
## Waarom deze vorm17
## Waarom deze vorm16
18
17
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.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 ni20
22
21
## Schijf23
## Schijf22
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
```text27
```text26
bluegit.db metadata, mode via het proces van gebruiker bluegit28
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
## Rechten49
## Rechten48
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
## Web55
## Web54
56
@@ -81,4 +83,4 @@ Het branchfilter geldt alleen voor `push`. Andere gebeurtenissen negeren het. Ee81
83
82
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.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.@@ -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_sec19
```19
```20
20
21
5. Het antwoord bevat `access_token`, `expires_in` (86400) en `user` met `id`, `username` en `avatar_url`. Geen e-mailadres.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
7. `POST /api/session/extend` schuift de 24 uur op. `POST /api/logout` trekt het token in.23
7. `POST /api/session/extend` schuift de 24 uur op. `POST /api/logout` trekt het token in.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`).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: BlueGitAccountClie27
27
28
## Wat BlueGit bewaart28
## Wat BlueGit bewaart29
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
## Configuratie34
## Configuratie35
35
@@ -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: build20
stage: build@@ -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
# Ingress2
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
## BlueGit8
9
```yaml10
base_url: https://git.timfalken.com11
listen: 0.0.0.0:808012
trusted_proxies:13
- 10.0.0.214
ssh:15
enabled: true16
listen: 0.0.0.0:222217
public_host: git.timfalken.com18
public_port: 2219
```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 ingress28
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
```caddyfile32
git.timfalken.com {33
reverse_proxy 10.0.0.5:808034
}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
```caddyfile42
{43
layer4 {44
:22 {45
route {46
proxy 10.0.0.5:222247
}48
}49
}50
}51
```52
53
Zonder die module kan nginx hetzelfde op de stream-laag:54
55
```nginx56
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.@@ -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 draa14
14
15
## Daarna, in deze volgorde15
## Daarna, in deze volgorde16
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.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, `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.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
3. **Merge requests verder.** Opmerkingen, een echte diff in plaats van `git log --oneline`, en een pipeline die groen moet zijn voor het samenvoegen.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
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.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
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.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
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.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
8. **Huiswerk van de server.** Versleutelde sessietokens, back-ups van `storage_path` (database én repositories), en een limiet op webhookverkeer.24
8. **Huiswerk van de server.** Versleutelde sessietokens, back-ups van `storage_path` (database én repositories), en een limiet op webhookverkeer.@@ -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 vragen1
# Besluiten2
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.3
Tim heeft deze punten beantwoord. Wat hieronder staat is de huidige regel, niet meer een open vraag.4
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.5
## Besloten6
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?6
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?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
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?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
5. Moet de installatiebeheerder overal beheerder blijven, inclusief geheimen, als er later andere mensen op de server komen?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
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?10
4. **Het afzenderadres van een merge is `{naam}@users.git.timfalken.com`.** De auth-server geeft geen e-mailadres.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?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
8. De licentie in deze basis is MIT. Klopt dat?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
9. De schijf in het voorbeeld is `/mnt/storage/bluegit`. Hoe heet het mountpoint op de mini-PC echt?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 open17
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.@@ -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 hebben2
// Een repository hoort bij een gebruiker of een groep. Leden hebben3
// Readonly, Developer of Maintainer. De effectieve rol is de hoogste3
// Readonly, Developer of Maintainer. De effectieve rol is de hoogste4
// van groepslidmaatschap, rechtstreeks repolidmaatschap en eigenaarschap.4
// van groepslidmaatschap, rechtstreeks repolidmaatschap en eigenaarschap.5
// Installatiebeheer is hier geen rol: dat geeft geen toegang tot6
// repositories, groepen of geheimen van anderen.5
package access7
package access6
8
7
import (9
import (@@ -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.108
type Input struct {111
type Input struct {109
// InstanceAdmin is beheerder van deze BlueGit-installatie.110
InstanceAdmin bool111
// 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 bool113
UserOwner bool113
// GroupRole is de rol in de groep die de repository bezit. Leeg als114
// 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 van122
// Anders geldt de hoogste van groepsrol en repositoryrol.123
// groepsrol en repositoryrol.123
func Resolve(in Input) Role {124
func Resolve(in Input) Role {124
if in.InstanceAdmin || in.UserOwner {125
if in.UserOwner {125
return RoleMaintainer126
return RoleMaintainer126
}127
}127
return Max(in.GroupRole, in.RepoRole)128
return Max(in.GroupRole, in.RepoRole)@@ -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)@@ -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 config3
3
4
import (4
import (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.14
type Config struct {17
type 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 boolean20
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.Set23
}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 wat55
// een gebruiker ziet; de ingress kan daar een andere poort voor gebruiken.46
type SSH struct {56
type 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.141
func (c Config) Validate() error {153
func (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 err188
}189
c.proxies = set190
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 nil201
return nil171
}202
}172
203
204
// ProxySet is de geparsede trusted_proxies-lijst. Nil betekent dat205
// 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 h213
}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.PublicPort226
}227
_, port, err := net.SplitHostPort(c.SSH.Listen)228
if err != nil {229
return 22230
}231
n, err := strconv.Atoi(port)232
if err != nil || n <= 0 {233
return 22234
}235
return n236
}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
// 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.174
func (c Config) RedirectURI() string {251
func (c Config) RedirectURI() string {175
return c.BaseURL + c.Auth.RedirectPath252
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.179
func Example() string {256
func 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.181
base_url: https://git.timfalken.com259
base_url: https://git.timfalken.com182
listen: 127.0.0.1:8080260
listen: 0.0.0.0:8080183
# 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.184
storage_path: /mnt/storage/bluegit263
storage_path: /mnt/storage/bluegit185
behind_proxy: true264
# 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.2186
268
187
auth:269
auth:188
mode: oauth270
mode: oauth@@ -197,11 +279,15 @@ auth:197
279
198
git:280
git:199
binary: git281
binary: git200
default_branch: main282
default_branch: master201
283
202
ssh:284
ssh:203
enabled: true285
enabled: true286
# Waar dit proces git-SSH aanneemt. De SSH van het besturingssysteem blijft vrij.204
listen: 0.0.0.0:2222287
listen: 0.0.0.0:2222288
# Wat gebruikers in de clone-URL zien. De ingress stuurt poort 22 hiernaartoe.289
public_host: git.timfalken.com290
public_port: 22205
291
206
ci:292
ci:207
enabled: true293
enabled: true@@ -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
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.com53
storage_path: ` + dir + `54
listen: 0.0.0.0:808055
trusted_proxies: ["10.0.0.2", "192.168.0.0/16"]56
auth:57
mode: oauth58
client_id: git.timfalken.com59
ssh:60
enabled: true61
listen: 0.0.0.0:222262
public_host: git.timfalken.com63
public_port: 2264
`)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
}@@ -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 verbinding3
// van een adres op de vertrouwenslijst komt. Een client die zelf een4
// kop meestuurt, kan zijn adres daarmee niet vervalsen.5
package realip6
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.IPNet17
}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
continue26
}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
continue34
}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 := 3240
if ip.To4() == nil {41
bits = 12842
}43
s.nets = append(s.nets, &net.IPNet{IP: ip, Mask: net.CIDRMask(bits, bits)})44
}45
return s, nil46
}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 false52
}53
for _, n := range s.nets {54
if n.Contains(ip) {55
return true56
}57
}58
return false59
}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 die64
// zelf geen vertrouwde proxy is. Zijn alle hops vertrouwd, dan blijft65
// 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 = remoteAddr70
}71
peerIP := net.ParseIP(peer)72
if trusted == nil || peerIP == nil || !trusted.Contains(peerIP) {73
return peer74
}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 peer82
}83
84
func rightmostUntrusted(xff string, trusted *Set) net.IP {85
if strings.TrimSpace(xff) == "" {86
return nil87
}88
parts := strings.Split(xff, ",")89
for i := len(parts) - 1; i >= 0; i-- {90
ip := parseToken(parts[i])91
if ip == nil {92
continue93
}94
if !trusted.Contains(ip) {95
return ip96
}97
}98
return nil99
}100
101
func parseToken(s string) net.IP {102
s = strings.TrimSpace(s)103
s = strings.Trim(s, `"`)104
if s == "" {105
return nil106
}107
if h, _, err := net.SplitHostPort(s); err == nil {108
s = h109
}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 staan121
// 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
return128
}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,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 @@1
package realip2
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
}@@ -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) {96
func (s *Server) home(w http.ResponseWriter, r *http.Request) {96
func (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
return102
return@@ -107,7 +107,7 @@ func (s *Server) home(w http.ResponseWriter, r *http.Request) {107
return107
return108
}108
}109
v.Repos = repos109
v.Repos = repos110
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
return113
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
return117
return118
}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
return128
return129
}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 []secretRow223
var secrets []secretRow224
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) {@@ -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 server2
2
3
import (3
import (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.Rep53
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 = p62
}63
v.CloneSSH = "ssh://git@" + host + ":" + port + "/" + repo.FullPath() + ".git"64
}65
return v56
return v66
}57
}67
58
@@ -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
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
func (s *Server) mustTemplates() {121
func (s *Server) mustTemplates() {@@ -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 {@@ -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>@@ -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.109
func (s *Store) GroupRole(ctx context.Context, groupID, userID int64) (access.Role, error) {110
func (s *Store) GroupRole(ctx context.Context, groupID, userID int64) (access.Role, error) {110
if userID == 0 {111
if userID == 0 {111
return access.RoleNone, nil112
return access.RoleNone, nil112
}113
}113
u, err := s.UserByID(ctx, userID)114
if err != nil {115
return access.RoleNone, err116
}117
if u.InstanceAdmin {118
return access.RoleMaintainer, nil119
}120
var role string114
var role string121
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, nil117
return access.RoleNone, nil124
}118
}@@ -128,15 +122,10 @@ func (s *Store) GroupRole(ctx context.Context, groupID, userID int64) (access.Ro128
return access.Role(role), nil122
return access.Role(role), nil129
}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.132
func (s *Store) ListGroups(ctx context.Context, userID int64, all bool) ([]Group, error) {126
func (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 []any128
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, err131
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 err235
return err247
}236
}248
237
249
// ListRepoIDs geeft repositories die deze gebruiker mag zien.238
// ListRepoIDs geeft repositories die deze gebruiker mag zien:250
func (s *Store) ListRepoIDs(ctx context.Context, userID int64, instanceAdmin bool) ([]int64, error) {239
// openbare repositories, eigen repositories, repositories van een groep240
// 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
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 boo256
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 = nil262
}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) (access332
if userID == 0 {320
if userID == 0 {333
return access.RoleNone, nil321
return access.RoleNone, nil334
}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, err324
return access.RoleNone, err338
}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, err328
return access.RoleNone, err342
}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 = true332
in.UserOwner = true346
}333
}@@ -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
102
func openTest(t *testing.T) *Store {162
func openTest(t *testing.T) *Store {@@ -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-failure14
NoNewPrivileges=true14
NoNewPrivileges=true15
ProtectSystem=strict15
ProtectSystem=strict16
ProtectHome=true16
ProtectHome=true17
# /var/lib/bluegit is de fallback. De 4 TB-schijf staat in de drop-in17
# /var/lib/bluegit is de fallback. Het echte pad van de 4 TB-schijf is18
# 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.19
ReadWritePaths=/var/lib/bluegit20
ReadWritePaths=/var/lib/bluegit20
PrivateTmp=true21
PrivateTmp=true21
22
@@ -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.2
base_url: https://git.timfalken.com3
base_url: https://git.timfalken.com3
listen: 127.0.0.1:80804
listen: 0.0.0.0:80804
# 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.5
storage_path: /mnt/storage/bluegit7
storage_path: /mnt/storage/bluegit6
behind_proxy: true8
# 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.27
12
8
auth:13
auth:9
mode: oauth14
mode: oauth@@ -17,11 +22,15 @@ auth:17
22
18
git:23
git:19
binary: git24
binary: git20
default_branch: main25
default_branch: master21
26
22
ssh:27
ssh:23
enabled: true28
enabled: true29
# Waar dit proces git-SSH aanneemt. De SSH van het besturingssysteem blijft vrij.24
listen: 0.0.0.0:222230
listen: 0.0.0.0:222231
# Wat gebruikers in de clone-URL zien. De ingress stuurt poort 22 hiernaartoe.32
public_host: git.timfalken.com33
public_port: 2225
34
26
ci:35
ci:27
enabled: true36
enabled: true@@ -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.conf1
# Zet dit neer als /etc/systemd/system/bluegit.service.d/storage.conf2
# 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 wordt4
# niet automatisch geactiveerd: een pad dat niet bestaat blokkeert de dienst.3
[Service]5
[Service]4
ReadWritePaths=/mnt/storage/bluegit6
ReadWritePaths=/mnt/storage/bluegit