# Ingress

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.

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.

## BlueGit

```yaml
base_url: https://git.timfalken.com
listen: 0.0.0.0:8080
trusted_proxies:
  - 10.0.0.2
ssh:
  enabled: true
  listen: 0.0.0.0:2222
  public_host: git.timfalken.com
  public_port: 22
```

`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.

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`.

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.

## Voorbeeld op de ingress

Caddy doet HTTPS en stuurt door naar de mini-PC. Vervang `10.0.0.5` door het adres van de mini-PC.

```caddyfile
git.timfalken.com {
	reverse_proxy 10.0.0.5:8080
}
```

Caddy zet `X-Forwarded-For` en `X-Forwarded-Proto`. Het certificaat komt van Caddy; BlueGit ziet geen TLS.

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`:

```caddyfile
{
	layer4 {
		:22 {
			route {
				proxy 10.0.0.5:2222
			}
		}
	}
}
```

Zonder die module kan nginx hetzelfde op de stream-laag:

```nginx
stream {
	server {
		listen 22;
		proxy_pass 10.0.0.5:2222;
	}
}
```

De clone-URL op de website is dan `git@git.timfalken.com:eigenaar/naam.git` (de korte vorm, zoals GitHub). Bij een andere publieke poort wordt het `ssh://git@host:poort/eigenaar/naam.git`. Op de mini-PC blijft git-SSH op poort 2222 luisteren, naast de SSH van Arch.

## Encoded slashes (`%2F`)

Branchnamen, bestandspaden en patterns van beschermde branches bevatten vaak een `/`. Clients sturen die slash in het URL-pad soms als `%2F`, bijvoorbeeld `DELETE /api/v1/projects/{owner}/{repo}/repository/branches/feature%2Fx`.

Caddy (het voorbeeld hierboven, en de ingress van git.timfalken.com) geeft `%2F` ongewijzigd door. Dat is op git.timfalken.com gecontroleerd: een verzoek met `%2F` in het pad komt bij BlueGit uit (een authenticatiefout, geen 404 van de ingress). Daar is geen extra instelling nodig.

Apache weigert `%2F` standaard met een 404, nog voordat de proxy het verzoek doorstuurt. Zet in de `VirtualHost` (of de `Directory`/`Location` van de site):

```apache
AllowEncodedSlashes NoDecode
```

En als je `ProxyPass` gebruikt, ook `nocanon`. Zonder die vlag canoniseert Apache het pad alsnog en blijft `%2F` stuk:

```apache
ProxyPass        / http://10.0.0.5:8080/ nocanon
ProxyPassReverse / http://10.0.0.5:8080/
```

Vervang `10.0.0.5:8080` door het adres van BlueGit, hetzelfde als in het Caddy-voorbeeld.

BlueGit zelf accepteert zowel een letterlijke slash (`feature/x`) als `%2F` in een wildcard-pad. Voor een ingress die `%2F` niet doorlaat is er een variant zonder slash in het pad:

- `DELETE /api/v1/projects/{owner}/{repo}/repository/branches?name=feature/x`
- `PUT /api/v1/projects/{owner}/{repo}/repository/branches?name=feature/x` (nieuwe naam in de JSON-body)
- `DELETE /api/v1/projects/{owner}/{repo}/protected_branches?pattern=feature/*`
- `DELETE /api/v1/projects/{owner}/{repo}/protected_tags?pattern=releases/*`
- `GET /api/v1/projects/{owner}/{repo}/repository/files?path=docs/INGRESS.md&ref=master`

De naam mag bij verwijderen ook in de JSON-body. Tagnamen mogen geen `/` bevatten; hun pad hoeft dus niet om `%2F` heen. Vergelijken in de UI gebruikt al queryparameters (`/-/compare?from=&to=`).
