BlueGit

timfa bluegit

Merge branch 'cursor/entra-login' into stage

Microsoft Entra ID-aanmelden, inclusief PKCE, tokencontroles en instel-docs.

timfa Grok Bot · pushed by timfa

Authored 2026-11-12 · 5 days ago

Hash
9e401d3f9033479af877d21130b9b3397637518a
Pipeline
Passed
15 files changed +1473 −33
README.md +38 −2
@@ -2,7 +2,7 @@
2 2
3 3 BlueGit is een self-hosted git-platform. Het is één Go-binary: de website, smart HTTP, de REST-API en de SSH-listener draaien in hetzelfde proces. Metadata staat in SQLite. Git-objecten staan in bare repositories op een schijf die de beheerder kiest. Docker wordt alleen gebruikt om CI-jobs te draaien.
4 4
5 Er is geen lokaal wachtwoord. Aanmelden gaat via de OAuth-flow van [auth.timfalken.com](https://auth.timfalken.com).
5 Er is geen lokaal wachtwoord. Aanmelden gaat via de OAuth-flow van [auth.timfalken.com](https://auth.timfalken.com) (`auth.mode: oauth`, de standaard) of via Microsoft Entra ID (`auth.mode: entra`, één tenant). Zie [docs/AUTH.md](docs/AUTH.md).
6 6
7 7 Het logo is de blauwe ster: [`assets/logo.svg`](assets/logo.svg).
8 8
@@ -42,6 +42,42 @@ Op Arch installeer je het AUR-pakket `bluegit`. De configuratie staat in `/etc/b
42 42
43 43 Hoe het pakket gepubliceerd wordt en hoe de self-update via pacman werkt, staat in [docs/AUR.md](docs/AUR.md). De stappen voor de installatie op git.timfalken.com staan in [docs/BEHEER.md](docs/BEHEER.md).
44 44
45 ## Microsoft Entra ID
46
47 Details en de OIDC-controles staan in [docs/AUTH.md](docs/AUTH.md). Kort, stap voor stap:
48
49 1. Open het [Microsoft Entra-beheercentrum](https://entra.microsoft.com) → Identiteit → Toepassingen → App-registraties → Nieuwe registratie.
50 2. Kies één tenant (*Accounts in this organizational directory only* / single tenant).
51 3. Platform: **Web**. De redirect-URI moet exact `{base_url}{auth.redirect_path}` zijn, het pad dat BlueGit verwacht. `auth.redirect_path` is standaard `/auth/callback`, dus bijvoorbeeld `https://git.timfalken.com/auth/callback`. Een ander pad, schema (`http` vs `https`) of een slash te veel of te weinig geeft een redirect-mismatch.
52 4. Maak onder *Certificates & secrets* een client secret aan. Noteer de waarde (die is maar één keer zichtbaar) en de verloopdatum; na verlopen stopt aanmelden.
53 5. BlueGit vraagt de scopes `openid`, `profile` en `email`. Die horen bij OpenID Connect; er zijn geen extra Graph-rechten nodig voor aanmelden.
54 6. Op het overzicht van de app-registratie staan de **Directory (tenant) ID** (`auth.tenant_id`) en de **Application (client) ID** (`auth.client_id`).
55
56 Zet in `/etc/bluegit/config.yml` (geen echte geheimen in dit bestand of in deze docs):
57
58 ```yaml
59 auth:
60 mode: entra
61 tenant_id: # Directory (tenant) ID
62 client_id: # Application (client) ID
63 client_secret_file: /etc/bluegit/client_secret
64 redirect_path: /auth/callback
65 # issuer alleen voor een andere cloud of een test; leeg =
66 # https://login.microsoftonline.com/{tenant_id}/v2.0
67 ```
68
69 Het clientgeheim zet je niet in de yaml als het vermijdbaar is. Alternatieven met exacte namen uit de code: `auth.client_secret`, `auth.client_secret_file` (bijvoorbeeld `/etc/bluegit/client_secret`, mode `0600`) of de omgevingsvariabele `BLUEGIT_AUTH_CLIENT_SECRET` (bijvoorbeeld in `/etc/bluegit/secret.env`). `auth.base_url` hoort bij `mode: oauth`, niet bij entra.
70
71 Herstart daarna de service (`systemctl restart bluegit`). De bestaande knop **Aanmelden** (in de navigatie, naar `/login`) start de Entra-flow; er is geen aparte knop. Zonder `auth.mode: entra` blijft die knop naar auth.timfalken.com gaan.
72
73 **Accountkoppeling.** De BlueGit-gebruiker hangt aan `tid` + `oid` uit het ID-token (stabiele `auth_id`). Dezelfde Entra-gebruiker komt terug op het bestaande account. Een nieuwe login waarvan de afgeleide gebruikersnaam al door een ander account bezet is, wordt geweigerd; er is geen overname via e-mail.
74
75 **Veelvoorkomende fouten**
76
77 - De redirect-URI komt niet exact overeen (pad, schema, host, slash) → redirect mismatch (vaak AADSTS50011).
78 - Verlopen client secret → de token-exchange faalt; maak een nieuw geheim, werk `auth.client_secret_file` of `BLUEGIT_AUTH_CLIENT_SECRET` bij, en herstart.
79 - Verkeerde tenant: `auth.tenant_id` hoort bij een andere directory, of `tid` in het token komt niet overeen → aanmelden wordt geweigerd.
80
45 81 ## Lokaal
46 82
47 83 `auth.mode: dev` maakt een sessie zonder de auth-server. De configuratie weigert die modus zodra `base_url` op `git.timfalken.com` wijst.
@@ -74,7 +110,7 @@ git clone http://tim:bg_…@127.0.0.1:8080/tim/demo.git
74 110 ## Documentatie
75 111
76 112 - [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) beschrijft het proces, de schijf en waarom het één binary is.
77 - [docs/AUTH.md](docs/AUTH.md) beschrijft de OAuth-koppeling.
113 - [docs/AUTH.md](docs/AUTH.md) beschrijft de OAuth-koppeling en Microsoft Entra ID.
78 114 - [docs/INGRESS.md](docs/INGRESS.md) beschrijft TLS en de publieke SSH-poort.
79 115 - [docs/CI.md](docs/CI.md) beschrijft `blue-ci-cd.yml` en Steve.
80 116 - [docs/AUR.md](docs/AUR.md) beschrijft het pakket en de self-update.
@@ -2,7 +2,7 @@
2
2
3BlueGit is een self-hosted git-platform. Het is één Go-binary: de website, smart HTTP, de REST-API en de SSH-listener draaien in hetzelfde proces. Metadata staat in SQLite. Git-objecten staan in bare repositories op een schijf die de beheerder kiest. Docker wordt alleen gebruikt om CI-jobs te draaien.
3BlueGit is een self-hosted git-platform. Het is één Go-binary: de website, smart HTTP, de REST-API en de SSH-listener draaien in hetzelfde proces. Metadata staat in SQLite. Git-objecten staan in bare repositories op een schijf die de beheerder kiest. Docker wordt alleen gebruikt om CI-jobs te draaien.
4
4
5Er is geen lokaal wachtwoord. Aanmelden gaat via de OAuth-flow van [auth.timfalken.com](https://auth.timfalken.com).
5Er is geen lokaal wachtwoord. Aanmelden gaat via de OAuth-flow van [auth.timfalken.com](https://auth.timfalken.com) (`auth.mode: oauth`, de standaard) of via Microsoft Entra ID (`auth.mode: entra`, één tenant). Zie [docs/AUTH.md](docs/AUTH.md).
6
6
7Het logo is de blauwe ster: [`assets/logo.svg`](assets/logo.svg).
7Het logo is de blauwe ster: [`assets/logo.svg`](assets/logo.svg).
8
8
@@ -42,6 +42,42 @@ Op Arch installeer je het AUR-pakket `bluegit`. De configuratie staat in `/etc/b
42
42
43Hoe het pakket gepubliceerd wordt en hoe de self-update via pacman werkt, staat in [docs/AUR.md](docs/AUR.md). De stappen voor de installatie op git.timfalken.com staan in [docs/BEHEER.md](docs/BEHEER.md).
43Hoe het pakket gepubliceerd wordt en hoe de self-update via pacman werkt, staat in [docs/AUR.md](docs/AUR.md). De stappen voor de installatie op git.timfalken.com staan in [docs/BEHEER.md](docs/BEHEER.md).
44
44
45## Microsoft Entra ID
46
47Details en de OIDC-controles staan in [docs/AUTH.md](docs/AUTH.md). Kort, stap voor stap:
48
491. Open het [Microsoft Entra-beheercentrum](https://entra.microsoft.com) → Identiteit → Toepassingen → App-registraties → Nieuwe registratie.
502. Kies één tenant (*Accounts in this organizational directory only* / single tenant).
513. Platform: **Web**. De redirect-URI moet exact `{base_url}{auth.redirect_path}` zijn, het pad dat BlueGit verwacht. `auth.redirect_path` is standaard `/auth/callback`, dus bijvoorbeeld `https://git.timfalken.com/auth/callback`. Een ander pad, schema (`http` vs `https`) of een slash te veel of te weinig geeft een redirect-mismatch.
524. Maak onder *Certificates & secrets* een client secret aan. Noteer de waarde (die is maar één keer zichtbaar) en de verloopdatum; na verlopen stopt aanmelden.
535. BlueGit vraagt de scopes `openid`, `profile` en `email`. Die horen bij OpenID Connect; er zijn geen extra Graph-rechten nodig voor aanmelden.
546. Op het overzicht van de app-registratie staan de **Directory (tenant) ID** (`auth.tenant_id`) en de **Application (client) ID** (`auth.client_id`).
55
56Zet in `/etc/bluegit/config.yml` (geen echte geheimen in dit bestand of in deze docs):
57
58```yaml
59auth:
60 mode: entra
61 tenant_id: # Directory (tenant) ID
62 client_id: # Application (client) ID
63 client_secret_file: /etc/bluegit/client_secret
64 redirect_path: /auth/callback
65 # issuer alleen voor een andere cloud of een test; leeg =
66 # https://login.microsoftonline.com/{tenant_id}/v2.0
67```
68
69Het clientgeheim zet je niet in de yaml als het vermijdbaar is. Alternatieven met exacte namen uit de code: `auth.client_secret`, `auth.client_secret_file` (bijvoorbeeld `/etc/bluegit/client_secret`, mode `0600`) of de omgevingsvariabele `BLUEGIT_AUTH_CLIENT_SECRET` (bijvoorbeeld in `/etc/bluegit/secret.env`). `auth.base_url` hoort bij `mode: oauth`, niet bij entra.
70
71Herstart daarna de service (`systemctl restart bluegit`). De bestaande knop **Aanmelden** (in de navigatie, naar `/login`) start de Entra-flow; er is geen aparte knop. Zonder `auth.mode: entra` blijft die knop naar auth.timfalken.com gaan.
72
73**Accountkoppeling.** De BlueGit-gebruiker hangt aan `tid` + `oid` uit het ID-token (stabiele `auth_id`). Dezelfde Entra-gebruiker komt terug op het bestaande account. Een nieuwe login waarvan de afgeleide gebruikersnaam al door een ander account bezet is, wordt geweigerd; er is geen overname via e-mail.
74
75**Veelvoorkomende fouten**
76
77- De redirect-URI komt niet exact overeen (pad, schema, host, slash) → redirect mismatch (vaak AADSTS50011).
78- Verlopen client secret → de token-exchange faalt; maak een nieuw geheim, werk `auth.client_secret_file` of `BLUEGIT_AUTH_CLIENT_SECRET` bij, en herstart.
79- Verkeerde tenant: `auth.tenant_id` hoort bij een andere directory, of `tid` in het token komt niet overeen → aanmelden wordt geweigerd.
80
45## Lokaal
81## Lokaal
46
82
47`auth.mode: dev` maakt een sessie zonder de auth-server. De configuratie weigert die modus zodra `base_url` op `git.timfalken.com` wijst.
83`auth.mode: dev` maakt een sessie zonder de auth-server. De configuratie weigert die modus zodra `base_url` op `git.timfalken.com` wijst.
@@ -74,7 +110,7 @@ git clone http://tim:bg_…@127.0.0.1:8080/tim/demo.git
74## Documentatie
110## Documentatie
75
111
76- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) beschrijft het proces, de schijf en waarom het één binary is.
112- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) beschrijft het proces, de schijf en waarom het één binary is.
77- [docs/AUTH.md](docs/AUTH.md) beschrijft de OAuth-koppeling.
113- [docs/AUTH.md](docs/AUTH.md) beschrijft de OAuth-koppeling en Microsoft Entra ID.
78- [docs/INGRESS.md](docs/INGRESS.md) beschrijft TLS en de publieke SSH-poort.
114- [docs/INGRESS.md](docs/INGRESS.md) beschrijft TLS en de publieke SSH-poort.
79- [docs/CI.md](docs/CI.md) beschrijft `blue-ci-cd.yml` en Steve.
115- [docs/CI.md](docs/CI.md) beschrijft `blue-ci-cd.yml` en Steve.
80- [docs/AUR.md](docs/AUR.md) beschrijft het pakket en de self-update.
116- [docs/AUR.md](docs/AUR.md) beschrijft het pakket en de self-update.
cmd/bluegit/main.go +5 −2
@@ -92,10 +92,13 @@ func serve(args []string) error {
92 92 dataPath := resolveStorage(cfg, log)
93 93 var provider auth.Provider
94 94 dev := cfg.Auth.Mode == "dev"
95 if dev {
95 switch cfg.Auth.Mode {
96 case "dev":
96 97 provider = auth.Dev{Username: cfg.Auth.DevUser, AuthID: cfg.Auth.DevAuthID}
97 98 log.Warn("auth.mode dev staat aan; doe dit niet op git.timfalken.com")
98 } else {
99 case "entra":
100 provider = auth.NewEntra(cfg.EntraIssuer(), cfg.Auth.TenantID, cfg.Auth.ClientID, cfg.Auth.ClientSecret, cfg.Auth.UserAgent)
101 default:
99 102 provider = auth.NewTimFalken(cfg.Auth.BaseURL, cfg.Auth.ClientID, cfg.Auth.ClientSecret, cfg.Auth.UserAgent)
100 103 }
101 104 ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
@@ -92,10 +92,13 @@ func serve(args []string) error {
92 dataPath := resolveStorage(cfg, log)
92 dataPath := resolveStorage(cfg, log)
93 var provider auth.Provider
93 var provider auth.Provider
94 dev := cfg.Auth.Mode == "dev"
94 dev := cfg.Auth.Mode == "dev"
95 if dev {
95 switch cfg.Auth.Mode {
96 case "dev":
96 provider = auth.Dev{Username: cfg.Auth.DevUser, AuthID: cfg.Auth.DevAuthID}
97 provider = auth.Dev{Username: cfg.Auth.DevUser, AuthID: cfg.Auth.DevAuthID}
97 log.Warn("auth.mode dev staat aan; doe dit niet op git.timfalken.com")
98 log.Warn("auth.mode dev staat aan; doe dit niet op git.timfalken.com")
98 } else {
99 case "entra":
100 provider = auth.NewEntra(cfg.EntraIssuer(), cfg.Auth.TenantID, cfg.Auth.ClientID, cfg.Auth.ClientSecret, cfg.Auth.UserAgent)
101 default:
99 provider = auth.NewTimFalken(cfg.Auth.BaseURL, cfg.Auth.ClientID, cfg.Auth.ClientSecret, cfg.Auth.UserAgent)
102 provider = auth.NewTimFalken(cfg.Auth.BaseURL, cfg.Auth.ClientID, cfg.Auth.ClientSecret, cfg.Auth.UserAgent)
100 }
103 }
101 ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
104 ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
docs/AUTH.md +79 −10
@@ -1,8 +1,12 @@
1 # Koppeling met auth.timfalken.com
1 # Aanmelden: auth.timfalken.com of Microsoft Entra ID
2
3 BlueGit kent drie `auth.mode`-waarden: `oauth` (standaard, auth.timfalken.com), `entra` (Microsoft Entra ID, OIDC, één tenant) en `dev` (lokale sessie zonder IdP). Zonder nieuwe velden blijft alles zoals voorheen.
4
5 ## auth.timfalken.com (`mode: oauth`)
2 6
3 7 De auth-server is geen OpenID-provider. `https://auth.timfalken.com/.well-known/openid-configuration` geeft 404. De integratie staat op [https://auth.timfalken.com/help](https://auth.timfalken.com/help) en, machineleesbaar, op [https://auth.timfalken.com/help.json](https://auth.timfalken.com/help.json) (schema 1.7, dienst `account-auth`). Verhalenboek op `projects.timfalken.com` gebruikt dezelfde flow; de README daar noemt dezelfde eindpunten.
4 8
5 ## Wat een site moet doen
9 ### Wat een site moet doen
6 10
7 11 1. Een beheerder registreert het domein op `/admin`. Het domein is de `client_id`. Voor BlueGit is dat `git.timfalken.com`. Het `client_secret` verschijnt één keer.
8 12 2. Het callback-pad is alleen het pad, zonder query. Voor BlueGit: `/auth/callback`. De volledige redirect-URI is `https://git.timfalken.com/auth/callback`. Subdomeinen van het geregistreerde domein zijn toegestaan. Een afwijkende poort moet apart geregistreerd worden.
@@ -25,13 +29,7 @@ grant_type=authorization_code&code=…&redirect_uri=…&client_id=…&client_sec
25 29
26 30 BlueGit stuurt op elk server-naar-server-verzoek `User-Agent: BlueGitAccountClient/0.1` en `Accept: application/json`.
27 31
28 ## Wat BlueGit bewaart
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. 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
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
34 ## Configuratie
32 ### Configuratie (oauth)
35 33
36 34 ```yaml
37 35 auth:
@@ -45,7 +43,78 @@ auth:
45 43
46 44 Een leeg `client_secret` valt terug op het bestand, en dat weer op `BLUEGIT_AUTH_CLIENT_SECRET`.
47 45
48 `auth.mode: dev` slaat de ronde over en maakt een sessie voor `dev_user`. De configuratie weigert die modus als `base_url` op `git.timfalken.com` staat.
46 ## Microsoft Entra ID (`mode: entra`)
47
48 Entra is wél OpenID Connect. BlueGit gebruikt de authorization-code-flow met `scope=openid profile email` en PKCE S256. De login zet HttpOnly-cookies (`bluegit_oauth_state`, `bluegit_oauth_nonce`, `bluegit_oauth_pkce`; 600 seconden, `Secure` bij HTTPS, `SameSite=Lax`) en wist ze na de callback. In het ID-token controleert BlueGit: `nonce`, handtekening (JWKS, alleen RS256; `none` en HS256 worden geweigerd), `iss`, `aud`, verplichte `exp` (met 60 seconden klokverschuiving; ook `nbf` en `iat` als ze er zijn), en verplichte `tid` die case-insensitive gelijk moet zijn aan `auth.tenant_id`. `authorization_endpoint`, `token_endpoint` en `jwks_uri` moeten op dezelfde host staan als de issuer; bij een HTTPS-issuer moeten die eindpunten ook HTTPS zijn. Een zelfgezette `auth.issuer` moet HTTPS zijn, behalve op localhost (voor tests). Alleen één tenant: zet `tenant_id` op de Directory (tenant) ID van die directory.
49
50 Een korte checklist staat ook in de [README](../README.md#microsoft-entra-id).
51
52 ### App-registratie
53
54 1. Open het [Microsoft Entra-beheercentrum](https://entra.microsoft.com) → Identiteit → Toepassingen → App-registraties → Nieuwe registratie.
55 2. Kies één tenant (*Accounts in this organizational directory only* / single tenant). Multi-tenant is niet ondersteund.
56 3. Platform: **Web**. De redirect-URI moet exact `{base_url}{auth.redirect_path}` zijn. `auth.redirect_path` is standaard `/auth/callback`, bijvoorbeeld `https://git.timfalken.com/auth/callback`. Pad, schema en host moeten letterlijk overeenkomen.
57 4. Maak onder *Certificates & secrets* een client secret aan. Noteer de waarde (één keer zichtbaar) en de verloopdatum.
58 5. BlueGit vraagt de scopes `openid`, `profile` en `email`. Geen aparte Graph-rechten nodig voor aanmelden. Avatar via Graph zit er niet in.
59 6. Op het overzicht van de registratie staan de **Directory (tenant) ID** (`auth.tenant_id`) en de **Application (client) ID** (`auth.client_id`).
60
61 ### Configuratie (entra)
62
63 ```yaml
64 auth:
65 mode: entra
66 tenant_id: 00000000-0000-0000-0000-000000000000
67 client_id: 11111111-1111-1111-1111-111111111111
68 client_secret: ""
69 client_secret_file: /etc/bluegit/client_secret
70 redirect_path: /auth/callback
71 # issuer alleen zetten voor een andere cloud of een testissuer.
72 # Leeg = https://login.microsoftonline.com/{tenant_id}/v2.0
73 # issuer: https://login.microsoftonline.com/00000000-0000-0000-0000-000000000000/v2.0
74 ```
75
76 Ontbreekt `tenant_id`, `client_id` of het clientgeheim, dan weigert BlueGit te starten met een duidelijke fout. `auth.base_url` hoort bij oauth en wordt bij entra niet standaard op auth.timfalken.com gezet.
77
78 Het clientgeheim hoort in `auth.client_secret`, in `auth.client_secret_file` (bijvoorbeeld `/etc/bluegit/client_secret`, mode `0600`) of in de omgevingsvariabele `BLUEGIT_AUTH_CLIENT_SECRET` (bijvoorbeeld `/etc/bluegit/secret.env`). Na een wijziging: `systemctl restart bluegit`.
79
80 De bestaande knop **Aanmelden** (navigatie, `/login`) start de Entra-flow zodra `auth.mode: entra` staat. Er is geen aparte knop.
81
82 ### Identiteit → BlueGit-gebruiker
83
84 | BlueGit | Bron bij Entra |
85 | --- | --- |
86 | `auth_id` (numeriek) | Stabiele hash van `tid` + `oid` (valt terug op `sub` als `oid` ontbreekt) |
87 | `username` | Lokaal deel van `preferred_username` of `email`, gesaneerd naar kleine letters; anders `u` + korte hash van `oid` |
88 | `avatar_url` | Leeg (initialen in de UI) |
89 | `auth_admin` / IdP-`is_admin` | Altijd false; Entra-rollen maken niemand BlueGit-beheerder |
90
91 Installatiebeheerder blijft: alleen de eerste aangemelde gebruiker op deze installatie.
92
93 Accountkoppeling loopt via `tid` + `oid` (de stabiele `auth_id`). Dezelfde Entra-gebruiker komt terug op het bestaande BlueGit-account, ook als de weergavenaam bij Entra verandert (als de nieuwe gebruikersnaam al bezet is, blijft de oude naam staan). Een *nieuwe* login waarvan de afgeleide gebruikersnaam al door een ander account bezet is, wordt geweigerd (`err.userTaken`). Er is geen overname via e-mail.
94
95 ### Veelvoorkomende fouten
96
97 - Redirect-URI komt niet exact overeen (pad, schema, host, slash) → redirect mismatch, vaak AADSTS50011. Zet in Entra precies `{base_url}{auth.redirect_path}`.
98 - Verlopen of verkeerd client secret → de token-exchange faalt. Maak een nieuw geheim, werk `auth.client_secret_file` of `BLUEGIT_AUTH_CLIENT_SECRET` bij, en herstart.
99 - Verkeerde tenant: `auth.tenant_id` wijst naar een andere directory, of `tid` in het ID-token komt niet overeen → aanmelden wordt geweigerd.
100 - Issuer of discovery-eindpunten niet op HTTPS (buiten localhost) of `jwks_uri` op een andere host dan de issuer → BlueGit start niet of weigert discovery.
101
102 ### Wat er anders is onder Entra
103
104 - Geen `/api/me`, geen avatar-URL, geen `email_verified` van de auth-server.
105 - `Extend` verlengt alleen de BlueGit-sessie (24 uur); er is geen remote session-extend.
106 - `Logout` wist alleen de lokale sessie; het Entra-token wordt niet ingetrokken.
107 - Pipeline-falenmail via `POST /api/email` op auth.timfalken.com werkt niet (geen `Mailer` op de Entra-provider).
108
109 ## Wat BlueGit bewaart
110
111 Van het account: het numerieke auth-id, de gebruikersnaam in kleine letters, de avatar-URL (kan leeg zijn), en of die persoon op de auth-server beheerder is (`auth_admin`; bij Entra altijd false). 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.
112
113 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.
114
115 ## Dev-modus
116
117 `auth.mode: dev` slaat de ronde over en maakt een sessie voor `dev_user`. De configuratie weigert die modus als `base_url` (van de BlueGit-site) op `git.timfalken.com` staat.
49 118
50 119 ## Export
51 120
@@ -1,8 +1,12 @@
1# Koppeling met auth.timfalken.com
1# Aanmelden: auth.timfalken.com of Microsoft Entra ID
2
3BlueGit kent drie `auth.mode`-waarden: `oauth` (standaard, auth.timfalken.com), `entra` (Microsoft Entra ID, OIDC, één tenant) en `dev` (lokale sessie zonder IdP). Zonder nieuwe velden blijft alles zoals voorheen.
4
5## auth.timfalken.com (`mode: oauth`)
2
6
3De auth-server is geen OpenID-provider. `https://auth.timfalken.com/.well-known/openid-configuration` geeft 404. De integratie staat op [https://auth.timfalken.com/help](https://auth.timfalken.com/help) en, machineleesbaar, op [https://auth.timfalken.com/help.json](https://auth.timfalken.com/help.json) (schema 1.7, dienst `account-auth`). Verhalenboek op `projects.timfalken.com` gebruikt dezelfde flow; de README daar noemt dezelfde eindpunten.
7De auth-server is geen OpenID-provider. `https://auth.timfalken.com/.well-known/openid-configuration` geeft 404. De integratie staat op [https://auth.timfalken.com/help](https://auth.timfalken.com/help) en, machineleesbaar, op [https://auth.timfalken.com/help.json](https://auth.timfalken.com/help.json) (schema 1.7, dienst `account-auth`). Verhalenboek op `projects.timfalken.com` gebruikt dezelfde flow; de README daar noemt dezelfde eindpunten.
4
8
5## Wat een site moet doen
9### Wat een site moet doen
6
10
71. Een beheerder registreert het domein op `/admin`. Het domein is de `client_id`. Voor BlueGit is dat `git.timfalken.com`. Het `client_secret` verschijnt één keer.
111. Een beheerder registreert het domein op `/admin`. Het domein is de `client_id`. Voor BlueGit is dat `git.timfalken.com`. Het `client_secret` verschijnt één keer.
82. Het callback-pad is alleen het pad, zonder query. Voor BlueGit: `/auth/callback`. De volledige redirect-URI is `https://git.timfalken.com/auth/callback`. Subdomeinen van het geregistreerde domein zijn toegestaan. Een afwijkende poort moet apart geregistreerd worden.
122. Het callback-pad is alleen het pad, zonder query. Voor BlueGit: `/auth/callback`. De volledige redirect-URI is `https://git.timfalken.com/auth/callback`. Subdomeinen van het geregistreerde domein zijn toegestaan. Een afwijkende poort moet apart geregistreerd worden.
@@ -25,13 +29,7 @@ grant_type=authorization_code&code=…&redirect_uri=…&client_id=…&client_sec
25
29
26BlueGit stuurt op elk server-naar-server-verzoek `User-Agent: BlueGitAccountClient/0.1` en `Accept: application/json`.
30BlueGit stuurt op elk server-naar-server-verzoek `User-Agent: BlueGitAccountClient/0.1` en `Accept: application/json`.
27
31
28## Wat BlueGit bewaart
32### Configuratie (oauth)
29
30Van het account: het numerieke id, de gebruikersnaam in kleine letters, de avatar-URL, en of die persoon op de auth-server beheerder is. Geen e-mail. 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
32SSH-sleutels op de auth-server zijn er voor aanmelden dáár (`POST /api/ssh-login/challenge` en `/verify`, namespace `timfalken-account`). Er komt geen API waarmee een verbonden site die sleutels ophaalt. BlueGit houdt eigen sleutels bij voor git-over-SSH. Ze worden geplakt op de accountpagina.
33
34## Configuratie
35
33
36```yaml
34```yaml
37auth:
35auth:
@@ -45,7 +43,78 @@ auth:
45
43
46Een leeg `client_secret` valt terug op het bestand, en dat weer op `BLUEGIT_AUTH_CLIENT_SECRET`.
44Een leeg `client_secret` valt terug op het bestand, en dat weer op `BLUEGIT_AUTH_CLIENT_SECRET`.
47
45
48`auth.mode: dev` slaat de ronde over en maakt een sessie voor `dev_user`. De configuratie weigert die modus als `base_url` op `git.timfalken.com` staat.
46## Microsoft Entra ID (`mode: entra`)
47
48Entra is wél OpenID Connect. BlueGit gebruikt de authorization-code-flow met `scope=openid profile email` en PKCE S256. De login zet HttpOnly-cookies (`bluegit_oauth_state`, `bluegit_oauth_nonce`, `bluegit_oauth_pkce`; 600 seconden, `Secure` bij HTTPS, `SameSite=Lax`) en wist ze na de callback. In het ID-token controleert BlueGit: `nonce`, handtekening (JWKS, alleen RS256; `none` en HS256 worden geweigerd), `iss`, `aud`, verplichte `exp` (met 60 seconden klokverschuiving; ook `nbf` en `iat` als ze er zijn), en verplichte `tid` die case-insensitive gelijk moet zijn aan `auth.tenant_id`. `authorization_endpoint`, `token_endpoint` en `jwks_uri` moeten op dezelfde host staan als de issuer; bij een HTTPS-issuer moeten die eindpunten ook HTTPS zijn. Een zelfgezette `auth.issuer` moet HTTPS zijn, behalve op localhost (voor tests). Alleen één tenant: zet `tenant_id` op de Directory (tenant) ID van die directory.
49
50Een korte checklist staat ook in de [README](../README.md#microsoft-entra-id).
51
52### App-registratie
53
541. Open het [Microsoft Entra-beheercentrum](https://entra.microsoft.com) → Identiteit → Toepassingen → App-registraties → Nieuwe registratie.
552. Kies één tenant (*Accounts in this organizational directory only* / single tenant). Multi-tenant is niet ondersteund.
563. Platform: **Web**. De redirect-URI moet exact `{base_url}{auth.redirect_path}` zijn. `auth.redirect_path` is standaard `/auth/callback`, bijvoorbeeld `https://git.timfalken.com/auth/callback`. Pad, schema en host moeten letterlijk overeenkomen.
574. Maak onder *Certificates & secrets* een client secret aan. Noteer de waarde (één keer zichtbaar) en de verloopdatum.
585. BlueGit vraagt de scopes `openid`, `profile` en `email`. Geen aparte Graph-rechten nodig voor aanmelden. Avatar via Graph zit er niet in.
596. Op het overzicht van de registratie staan de **Directory (tenant) ID** (`auth.tenant_id`) en de **Application (client) ID** (`auth.client_id`).
60
61### Configuratie (entra)
62
63```yaml
64auth:
65 mode: entra
66 tenant_id: 00000000-0000-0000-0000-000000000000
67 client_id: 11111111-1111-1111-1111-111111111111
68 client_secret: ""
69 client_secret_file: /etc/bluegit/client_secret
70 redirect_path: /auth/callback
71 # issuer alleen zetten voor een andere cloud of een testissuer.
72 # Leeg = https://login.microsoftonline.com/{tenant_id}/v2.0
73 # issuer: https://login.microsoftonline.com/00000000-0000-0000-0000-000000000000/v2.0
74```
75
76Ontbreekt `tenant_id`, `client_id` of het clientgeheim, dan weigert BlueGit te starten met een duidelijke fout. `auth.base_url` hoort bij oauth en wordt bij entra niet standaard op auth.timfalken.com gezet.
77
78Het clientgeheim hoort in `auth.client_secret`, in `auth.client_secret_file` (bijvoorbeeld `/etc/bluegit/client_secret`, mode `0600`) of in de omgevingsvariabele `BLUEGIT_AUTH_CLIENT_SECRET` (bijvoorbeeld `/etc/bluegit/secret.env`). Na een wijziging: `systemctl restart bluegit`.
79
80De bestaande knop **Aanmelden** (navigatie, `/login`) start de Entra-flow zodra `auth.mode: entra` staat. Er is geen aparte knop.
81
82### Identiteit → BlueGit-gebruiker
83
84| BlueGit | Bron bij Entra |
85| --- | --- |
86| `auth_id` (numeriek) | Stabiele hash van `tid` + `oid` (valt terug op `sub` als `oid` ontbreekt) |
87| `username` | Lokaal deel van `preferred_username` of `email`, gesaneerd naar kleine letters; anders `u` + korte hash van `oid` |
88| `avatar_url` | Leeg (initialen in de UI) |
89| `auth_admin` / IdP-`is_admin` | Altijd false; Entra-rollen maken niemand BlueGit-beheerder |
90
91Installatiebeheerder blijft: alleen de eerste aangemelde gebruiker op deze installatie.
92
93Accountkoppeling loopt via `tid` + `oid` (de stabiele `auth_id`). Dezelfde Entra-gebruiker komt terug op het bestaande BlueGit-account, ook als de weergavenaam bij Entra verandert (als de nieuwe gebruikersnaam al bezet is, blijft de oude naam staan). Een *nieuwe* login waarvan de afgeleide gebruikersnaam al door een ander account bezet is, wordt geweigerd (`err.userTaken`). Er is geen overname via e-mail.
94
95### Veelvoorkomende fouten
96
97- Redirect-URI komt niet exact overeen (pad, schema, host, slash) → redirect mismatch, vaak AADSTS50011. Zet in Entra precies `{base_url}{auth.redirect_path}`.
98- Verlopen of verkeerd client secret → de token-exchange faalt. Maak een nieuw geheim, werk `auth.client_secret_file` of `BLUEGIT_AUTH_CLIENT_SECRET` bij, en herstart.
99- Verkeerde tenant: `auth.tenant_id` wijst naar een andere directory, of `tid` in het ID-token komt niet overeen → aanmelden wordt geweigerd.
100- Issuer of discovery-eindpunten niet op HTTPS (buiten localhost) of `jwks_uri` op een andere host dan de issuer → BlueGit start niet of weigert discovery.
101
102### Wat er anders is onder Entra
103
104- Geen `/api/me`, geen avatar-URL, geen `email_verified` van de auth-server.
105- `Extend` verlengt alleen de BlueGit-sessie (24 uur); er is geen remote session-extend.
106- `Logout` wist alleen de lokale sessie; het Entra-token wordt niet ingetrokken.
107- Pipeline-falenmail via `POST /api/email` op auth.timfalken.com werkt niet (geen `Mailer` op de Entra-provider).
108
109## Wat BlueGit bewaart
110
111Van het account: het numerieke auth-id, de gebruikersnaam in kleine letters, de avatar-URL (kan leeg zijn), en of die persoon op de auth-server beheerder is (`auth_admin`; bij Entra altijd false). 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.
112
113SSH-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.
114
115## Dev-modus
116
117`auth.mode: dev` slaat de ronde over en maakt een sessie voor `dev_user`. De configuratie weigert die modus als `base_url` (van de BlueGit-site) op `git.timfalken.com` staat.
49
118
50## Export
119## Export
51
120
internal/auth/auth.go +14 −8
@@ -1,7 +1,7 @@
1 // Package auth praat met auth.timfalken.com.
2 // De site gebruikt de authorization-code-flow: het domein is de client_id,
3 // de code wordt server-side gewisseld, en /api/me levert id en gebruikersnaam.
4 // E-mail komt nooit mee. Er is geen lokaal wachtwoord.
1 // Package auth praat met de gekozen identity provider.
2 // Standaard is dat auth.timfalken.com (authorization-code-flow); optioneel
3 // Microsoft Entra ID (OIDC). E-mail komt nooit in het BlueGit-usermodel.
4 // Er is geen lokaal wachtwoord.
5 5 package auth
6 6
7 7 import (
@@ -27,9 +27,11 @@ type Identity struct {
27 27 }
28 28
29 29 // Provider is de auth-server, of een testvervanger.
30 // nonce is verplicht voor OIDC (Entra); TimFalken en Dev negeren hem.
31 // codeChallenge / codeVerifier zijn PKCE S256; verplicht bij Entra, genegeerd door TimFalken en Dev.
30 32 type Provider interface {
31 AuthorizeURL(state, redirectURI string) string
32 Exchange(ctx context.Context, code, redirectURI string) (Identity, error)
33 AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string
34 Exchange(ctx context.Context, code, redirectURI, nonce, codeVerifier string) (Identity, error)
33 35 Extend(ctx context.Context, accessToken string) (expiresIn int, err error)
34 36 Logout(ctx context.Context, accessToken string) error
35 37 }
@@ -55,17 +57,21 @@ func NewTimFalken(baseURL, clientID, secret, userAgent string) *TimFalken {
55 57 }
56 58
57 59 // AuthorizeURL stuurt de browser naar de toestemmingspagina.
58 func (t *TimFalken) AuthorizeURL(state, redirectURI string) string {
60 func (t *TimFalken) AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string {
59 61 q := url.Values{}
60 62 q.Set("client_id", t.ClientID)
61 63 q.Set("redirect_uri", redirectURI)
62 64 q.Set("response_type", "code")
63 65 q.Set("state", state)
66 _ = nonce
67 _ = codeChallenge
64 68 return t.BaseURL + "/oauth/authorize?" + q.Encode()
65 69 }
66 70
67 71 // Exchange wisselt de eenmalige code om voor een bearer-token.
68 func (t *TimFalken) Exchange(ctx context.Context, code, redirectURI string) (Identity, error) {
72 func (t *TimFalken) Exchange(ctx context.Context, code, redirectURI, nonce, codeVerifier string) (Identity, error) {
73 _ = nonce
74 _ = codeVerifier
69 75 form := url.Values{}
70 76 form.Set("grant_type", "authorization_code")
71 77 form.Set("code", code)
@@ -1,7 +1,7 @@
1// Package auth praat met auth.timfalken.com.
1// Package auth praat met de gekozen identity provider.
2// De site gebruikt de authorization-code-flow: het domein is de client_id,
2// Standaard is dat auth.timfalken.com (authorization-code-flow); optioneel
3// de code wordt server-side gewisseld, en /api/me levert id en gebruikersnaam.
3// Microsoft Entra ID (OIDC). E-mail komt nooit in het BlueGit-usermodel.
4// E-mail komt nooit mee. Er is geen lokaal wachtwoord.
4// Er is geen lokaal wachtwoord.
5package auth
5package auth
6
6
7import (
7import (
@@ -27,9 +27,11 @@ type Identity struct {
27}
27}
28
28
29// Provider is de auth-server, of een testvervanger.
29// Provider is de auth-server, of een testvervanger.
30// nonce is verplicht voor OIDC (Entra); TimFalken en Dev negeren hem.
31// codeChallenge / codeVerifier zijn PKCE S256; verplicht bij Entra, genegeerd door TimFalken en Dev.
30type Provider interface {
32type Provider interface {
31 AuthorizeURL(state, redirectURI string) string
33 AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string
32 Exchange(ctx context.Context, code, redirectURI string) (Identity, error)
34 Exchange(ctx context.Context, code, redirectURI, nonce, codeVerifier string) (Identity, error)
33 Extend(ctx context.Context, accessToken string) (expiresIn int, err error)
35 Extend(ctx context.Context, accessToken string) (expiresIn int, err error)
34 Logout(ctx context.Context, accessToken string) error
36 Logout(ctx context.Context, accessToken string) error
35}
37}
@@ -55,17 +57,21 @@ func NewTimFalken(baseURL, clientID, secret, userAgent string) *TimFalken {
55}
57}
56
58
57// AuthorizeURL stuurt de browser naar de toestemmingspagina.
59// AuthorizeURL stuurt de browser naar de toestemmingspagina.
58func (t *TimFalken) AuthorizeURL(state, redirectURI string) string {
60func (t *TimFalken) AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string {
59 q := url.Values{}
61 q := url.Values{}
60 q.Set("client_id", t.ClientID)
62 q.Set("client_id", t.ClientID)
61 q.Set("redirect_uri", redirectURI)
63 q.Set("redirect_uri", redirectURI)
62 q.Set("response_type", "code")
64 q.Set("response_type", "code")
63 q.Set("state", state)
65 q.Set("state", state)
66 _ = nonce
67 _ = codeChallenge
64 return t.BaseURL + "/oauth/authorize?" + q.Encode()
68 return t.BaseURL + "/oauth/authorize?" + q.Encode()
65}
69}
66
70
67// Exchange wisselt de eenmalige code om voor een bearer-token.
71// Exchange wisselt de eenmalige code om voor een bearer-token.
68func (t *TimFalken) Exchange(ctx context.Context, code, redirectURI string) (Identity, error) {
72func (t *TimFalken) Exchange(ctx context.Context, code, redirectURI, nonce, codeVerifier string) (Identity, error) {
73 _ = nonce
74 _ = codeVerifier
69 form := url.Values{}
75 form := url.Values{}
70 form.Set("grant_type", "authorization_code")
76 form.Set("grant_type", "authorization_code")
71 form.Set("code", code)
77 form.Set("code", code)
internal/auth/auth_test.go +2 −2
@@ -31,7 +31,7 @@ func TestExchangeUsesAuthorizationCode(t *testing.T) {
31 31 }))
32 32 defer srv.Close()
33 33 client := NewTimFalken(srv.URL, "git.timfalken.com", "geheim", "BlueGitAccountClient/0.1")
34 id, err := client.Exchange(context.Background(), "code-1", "https://git.timfalken.com/auth/callback")
34 id, err := client.Exchange(context.Background(), "code-1", "https://git.timfalken.com/auth/callback", "", "")
35 35 if err != nil {
36 36 t.Fatal(err)
37 37 }
@@ -44,7 +44,7 @@ func TestExchangeUsesAuthorizationCode(t *testing.T) {
44 44 if gotAgent != "BlueGitAccountClient/0.1" || gotAccept != "application/json" {
45 45 t.Fatalf("headers %s %s", gotAgent, gotAccept)
46 46 }
47 url := client.AuthorizeURL("state-1", "https://git.timfalken.com/auth/callback")
47 url := client.AuthorizeURL("state-1", "nonce-1", "https://git.timfalken.com/auth/callback", "")
48 48 if !strings.Contains(url, "/oauth/authorize?") || !strings.Contains(url, "state=state-1") {
49 49 t.Fatal(url)
50 50 }
@@ -31,7 +31,7 @@ func TestExchangeUsesAuthorizationCode(t *testing.T) {
31 }))
31 }))
32 defer srv.Close()
32 defer srv.Close()
33 client := NewTimFalken(srv.URL, "git.timfalken.com", "geheim", "BlueGitAccountClient/0.1")
33 client := NewTimFalken(srv.URL, "git.timfalken.com", "geheim", "BlueGitAccountClient/0.1")
34 id, err := client.Exchange(context.Background(), "code-1", "https://git.timfalken.com/auth/callback")
34 id, err := client.Exchange(context.Background(), "code-1", "https://git.timfalken.com/auth/callback", "", "")
35 if err != nil {
35 if err != nil {
36 t.Fatal(err)
36 t.Fatal(err)
37 }
37 }
@@ -44,7 +44,7 @@ func TestExchangeUsesAuthorizationCode(t *testing.T) {
44 if gotAgent != "BlueGitAccountClient/0.1" || gotAccept != "application/json" {
44 if gotAgent != "BlueGitAccountClient/0.1" || gotAccept != "application/json" {
45 t.Fatalf("headers %s %s", gotAgent, gotAccept)
45 t.Fatalf("headers %s %s", gotAgent, gotAccept)
46 }
46 }
47 url := client.AuthorizeURL("state-1", "https://git.timfalken.com/auth/callback")
47 url := client.AuthorizeURL("state-1", "nonce-1", "https://git.timfalken.com/auth/callback", "")
48 if !strings.Contains(url, "/oauth/authorize?") || !strings.Contains(url, "state=state-1") {
48 if !strings.Contains(url, "/oauth/authorize?") || !strings.Contains(url, "state=state-1") {
49 t.Fatal(url)
49 t.Fatal(url)
50 }
50 }
internal/auth/dev.go +2 −2
@@ -13,10 +13,10 @@ type Dev struct {
13 13 }
14 14
15 15 // AuthorizeURL komt in de dev-modus niet voor: /login maakt meteen een sessie.
16 func (d Dev) AuthorizeURL(state, redirectURI string) string { return "/login" }
16 func (d Dev) AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string { return "/login" }
17 17
18 18 // Exchange bestaat zodat de interface klopt. Dev-login gebruikt hem niet.
19 func (d Dev) Exchange(ctx context.Context, code, redirectURI string) (Identity, error) {
19 func (d Dev) Exchange(ctx context.Context, code, redirectURI, nonce, codeVerifier string) (Identity, error) {
20 20 if code != "dev" {
21 21 return Identity{}, fmt.Errorf("dev-auth accepteert alleen de lokale code")
22 22 }
@@ -13,10 +13,10 @@ type Dev struct {
13}
13}
14
14
15// AuthorizeURL komt in de dev-modus niet voor: /login maakt meteen een sessie.
15// AuthorizeURL komt in de dev-modus niet voor: /login maakt meteen een sessie.
16func (d Dev) AuthorizeURL(state, redirectURI string) string { return "/login" }
16func (d Dev) AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string { return "/login" }
17
17
18// Exchange bestaat zodat de interface klopt. Dev-login gebruikt hem niet.
18// Exchange bestaat zodat de interface klopt. Dev-login gebruikt hem niet.
19func (d Dev) Exchange(ctx context.Context, code, redirectURI string) (Identity, error) {
19func (d Dev) Exchange(ctx context.Context, code, redirectURI, nonce, codeVerifier string) (Identity, error) {
20 if code != "dev" {
20 if code != "dev" {
21 return Identity{}, fmt.Errorf("dev-auth accepteert alleen de lokale code")
21 return Identity{}, fmt.Errorf("dev-auth accepteert alleen de lokale code")
22 }
22 }
internal/auth/entra.go added +401 −0
@@ -0,0 +1,401 @@
1 package auth
2
3 import (
4 "context"
5 "crypto/sha256"
6 "encoding/json"
7 "fmt"
8 "io"
9 "net/http"
10 "net/url"
11 "strings"
12 "sync"
13 "time"
14
15 "gitlab.com/Timfa/bluegit/internal/names"
16 )
17
18 // entraScope is wat de authorization-code-flow bij Entra vraagt.
19 const entraScope = "openid profile email"
20
21 // idTokenSkew is de toegestane klokverschuiving bij exp, nbf en iat.
22 const idTokenSkew = 60 * time.Second
23
24 // Entra is Microsoft Entra ID (OIDC, één tenant).
25 // Extend en Logout doen niets op afstand: Entra kent die TimFalken-API's niet.
26 type Entra struct {
27 Issuer string
28 TenantID string
29 ClientID string
30 Secret string
31 UserAgent string
32 HTTP *http.Client
33
34 mu sync.Mutex
35 authz string
36 token string
37 jwks *jwksCache
38 jwksURI string
39 }
40
41 // NewEntra maakt een OIDC-client. issuer is zonder slash aan het eind
42 // (standaard https://login.microsoftonline.com/{tenant}/v2.0).
43 func NewEntra(issuer, tenantID, clientID, secret, userAgent string) *Entra {
44 return &Entra{
45 Issuer: strings.TrimRight(issuer, "/"),
46 TenantID: tenantID,
47 ClientID: clientID,
48 Secret: secret,
49 UserAgent: userAgent,
50 HTTP: &http.Client{Timeout: 15 * time.Second},
51 jwks: &jwksCache{},
52 }
53 }
54
55 // AuthorizeURL stuurt de browser naar Entra met openid-profile-email, nonce en PKCE S256.
56 func (e *Entra) AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string {
57 authz, err := e.authorizeEndpoint(context.Background())
58 if err != nil {
59 // Zonder discovery: vaste Entra-URL zodat /login niet paniceert.
60 authz = strings.TrimSuffix(e.Issuer, "/v2.0") + "/oauth2/v2.0/authorize"
61 }
62 q := url.Values{}
63 q.Set("client_id", e.ClientID)
64 q.Set("redirect_uri", redirectURI)
65 q.Set("response_type", "code")
66 q.Set("response_mode", "query")
67 q.Set("scope", entraScope)
68 q.Set("state", state)
69 q.Set("nonce", nonce)
70 if codeChallenge != "" {
71 q.Set("code_challenge", codeChallenge)
72 q.Set("code_challenge_method", "S256")
73 }
74 return authz + "?" + q.Encode()
75 }
76
77 // Exchange wisselt de code om, valideert het ID-token (JWKS, iss, aud, exp, tid, nonce, PKCE)
78 // en mapt oid/tid naar een BlueGit-identity.
79 func (e *Entra) Exchange(ctx context.Context, code, redirectURI, nonce, codeVerifier string) (Identity, error) {
80 if nonce == "" {
81 return Identity{}, fmt.Errorf("auth: nonce ontbreekt")
82 }
83 if strings.TrimSpace(codeVerifier) == "" {
84 return Identity{}, fmt.Errorf("auth: PKCE-verifier ontbreekt")
85 }
86 tokenURL, err := e.tokenEndpoint(ctx)
87 if err != nil {
88 return Identity{}, err
89 }
90 form := url.Values{}
91 form.Set("grant_type", "authorization_code")
92 form.Set("code", code)
93 form.Set("redirect_uri", redirectURI)
94 form.Set("client_id", e.ClientID)
95 form.Set("client_secret", e.Secret)
96 form.Set("scope", entraScope)
97 form.Set("code_verifier", codeVerifier)
98 req, err := http.NewRequestWithContext(ctx, http.MethodPost, tokenURL, strings.NewReader(form.Encode()))
99 if err != nil {
100 return Identity{}, err
101 }
102 req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
103 req.Header.Set("Accept", "application/json")
104 if e.UserAgent != "" {
105 req.Header.Set("User-Agent", e.UserAgent)
106 }
107 var body struct {
108 AccessToken string `json:"access_token"`
109 IDToken string `json:"id_token"`
110 ExpiresIn int `json:"expires_in"`
111 Error string `json:"error"`
112 ErrorDesc string `json:"error_description"`
113 }
114 if err := e.doJSON(req, &body); err != nil {
115 return Identity{}, err
116 }
117 if body.Error != "" || body.IDToken == "" {
118 msg := body.Error
119 if body.ErrorDesc != "" {
120 msg = body.ErrorDesc
121 }
122 if msg == "" {
123 msg = "lege tokenrespons"
124 }
125 return Identity{}, fmt.Errorf("auth: %s", msg)
126 }
127 claims, err := e.verifyIDToken(ctx, body.IDToken, nonce)
128 if err != nil {
129 return Identity{}, err
130 }
131 oid := claims.OID
132 if oid == "" {
133 oid = claims.Sub
134 }
135 if oid == "" {
136 return Identity{}, fmt.Errorf("auth: id_token zonder oid/sub")
137 }
138 username, err := entraUsername(claims.PreferredUsername, claims.Email, claims.Name, oid)
139 if err != nil {
140 return Identity{}, err
141 }
142 return Identity{
143 AuthID: StableAuthID(e.TenantID, oid),
144 Username: username,
145 AvatarURL: "", // Entra levert geen avatar-URL zonder Graph-foto-API.
146 IsAdmin: false,
147 AccessToken: body.AccessToken,
148 ExpiresIn: 86400, // BlueGit-sessie; Entra's access_token is korter.
149 }, nil
150 }
151
152 // Extend verlengt alleen lokaal: Entra heeft geen /api/session/extend.
153 func (e *Entra) Extend(ctx context.Context, accessToken string) (int, error) {
154 return 86400, nil
155 }
156
157 // Logout doet niets op afstand; BlueGit wist de lokale sessie zelf.
158 func (e *Entra) Logout(ctx context.Context, accessToken string) error {
159 return nil
160 }
161
162 type idClaims struct {
163 Iss string `json:"iss"`
164 Aud jsonAudience `json:"aud"`
165 Exp int64 `json:"exp"`
166 Iat int64 `json:"iat"`
167 Nbf int64 `json:"nbf"`
168 Nonce string `json:"nonce"`
169 OID string `json:"oid"`
170 Sub string `json:"sub"`
171 TID string `json:"tid"`
172 PreferredUsername string `json:"preferred_username"`
173 Email string `json:"email"`
174 Name string `json:"name"`
175 }
176
177 func (e *Entra) verifyIDToken(ctx context.Context, raw, nonce string) (idClaims, error) {
178 hdr, payload, err := parseJWT(raw)
179 if err != nil {
180 return idClaims{}, err
181 }
182 var claims idClaims
183 if hdr.Alg != "RS256" {
184 return idClaims{}, fmt.Errorf("auth: onverwacht jwt-algorithme %q", hdr.Alg)
185 }
186 if err := json.Unmarshal(payload, &claims); err != nil {
187 return idClaims{}, fmt.Errorf("auth: id_token claims: %w", err)
188 }
189 if claims.Iss != e.Issuer {
190 return idClaims{}, fmt.Errorf("auth: ongeldige issuer")
191 }
192 if !claims.Aud.includes(e.ClientID) {
193 return idClaims{}, fmt.Errorf("auth: ongeldige audience")
194 }
195 now := time.Now()
196 if claims.Exp == 0 || now.Add(-idTokenSkew).Unix() >= claims.Exp {
197 return idClaims{}, fmt.Errorf("auth: id_token verlopen of mist exp")
198 }
199 if claims.Nbf > 0 && now.Add(idTokenSkew).Unix() < claims.Nbf {
200 return idClaims{}, fmt.Errorf("auth: id_token nog niet geldig")
201 }
202 if claims.Iat > 0 && now.Add(idTokenSkew).Unix() < claims.Iat {
203 return idClaims{}, fmt.Errorf("auth: id_token iat ligt in de toekomst")
204 }
205 if claims.Nonce == "" || claims.Nonce != nonce {
206 return idClaims{}, fmt.Errorf("auth: ongeldige nonce")
207 }
208 if claims.TID == "" || !strings.EqualFold(claims.TID, e.TenantID) {
209 return idClaims{}, fmt.Errorf("auth: onverwachte tenant")
210 }
211 key, err := e.signingKey(ctx, hdr.Kid)
212 if err != nil {
213 return idClaims{}, err
214 }
215 if err := verifyRS256(raw, key); err != nil {
216 return idClaims{}, err
217 }
218 return claims, nil
219 }
220
221 func (e *Entra) signingKey(ctx context.Context, kid string) (any, error) {
222 if err := e.ensureDiscovery(ctx); err != nil {
223 return nil, err
224 }
225 return e.jwks.key(ctx, e.HTTP, e.jwksURI, kid)
226 }
227
228 func (e *Entra) authorizeEndpoint(ctx context.Context) (string, error) {
229 if err := e.ensureDiscovery(ctx); err != nil {
230 return "", err
231 }
232 e.mu.Lock()
233 defer e.mu.Unlock()
234 return e.authz, nil
235 }
236
237 func (e *Entra) tokenEndpoint(ctx context.Context) (string, error) {
238 if err := e.ensureDiscovery(ctx); err != nil {
239 return "", err
240 }
241 e.mu.Lock()
242 defer e.mu.Unlock()
243 return e.token, nil
244 }
245
246 func (e *Entra) ensureDiscovery(ctx context.Context) error {
247 e.mu.Lock()
248 if e.authz != "" && e.token != "" && e.jwksURI != "" {
249 e.mu.Unlock()
250 return nil
251 }
252 e.mu.Unlock()
253
254 req, err := http.NewRequestWithContext(ctx, http.MethodGet, e.Issuer+"/.well-known/openid-configuration", nil)
255 if err != nil {
256 return err
257 }
258 if e.UserAgent != "" {
259 req.Header.Set("User-Agent", e.UserAgent)
260 }
261 var doc struct {
262 AuthorizationEndpoint string `json:"authorization_endpoint"`
263 TokenEndpoint string `json:"token_endpoint"`
264 JWKSURI string `json:"jwks_uri"`
265 Issuer string `json:"issuer"`
266 }
267 if err := e.doJSON(req, &doc); err != nil {
268 return fmt.Errorf("auth: oidc discovery: %w", err)
269 }
270 if doc.AuthorizationEndpoint == "" || doc.TokenEndpoint == "" || doc.JWKSURI == "" {
271 return fmt.Errorf("auth: onvolledige oidc discovery")
272 }
273 if doc.Issuer != "" && doc.Issuer != e.Issuer {
274 return fmt.Errorf("auth: discovery-issuer wijkt af")
275 }
276 for _, ep := range []string{doc.AuthorizationEndpoint, doc.TokenEndpoint, doc.JWKSURI} {
277 if err := oidcEndpointHostOK(ep, e.Issuer); err != nil {
278 return err
279 }
280 }
281 e.mu.Lock()
282 e.authz = doc.AuthorizationEndpoint
283 e.token = doc.TokenEndpoint
284 e.jwksURI = doc.JWKSURI
285 e.mu.Unlock()
286 return nil
287 }
288
289 // oidcEndpointHostOK eist dat authorization, token en jwks op dezelfde host
290 // staan als de issuer, en HTTPS gebruiken als de issuer HTTPS is.
291 func oidcEndpointHostOK(endpoint, issuer string) error {
292 eu, err := url.Parse(endpoint)
293 if err != nil || eu.Host == "" || (eu.Scheme != "https" && eu.Scheme != "http") {
294 return fmt.Errorf("auth: ongeldig OIDC-eindpunt %q", endpoint)
295 }
296 iu, err := url.Parse(issuer)
297 if err != nil || iu.Host == "" {
298 return fmt.Errorf("auth: ongeldige issuer %q", issuer)
299 }
300 if !strings.EqualFold(eu.Hostname(), iu.Hostname()) {
301 return fmt.Errorf("auth: OIDC-eindpunt host %s past niet bij issuer-host %s", eu.Hostname(), iu.Hostname())
302 }
303 if iu.Scheme == "https" && eu.Scheme != "https" {
304 return fmt.Errorf("auth: OIDC-eindpunt moet HTTPS zijn: %s", endpoint)
305 }
306 return nil
307 }
308
309 func (e *Entra) doJSON(req *http.Request, dest any) error {
310 res, err := e.HTTP.Do(req)
311 if err != nil {
312 return fmt.Errorf("auth: %w", err)
313 }
314 defer res.Body.Close()
315 raw, err := io.ReadAll(io.LimitReader(res.Body, 1<<20))
316 if err != nil {
317 return err
318 }
319 if res.StatusCode >= 400 {
320 var env struct {
321 Error string `json:"error"`
322 ErrorDesc string `json:"error_description"`
323 }
324 _ = json.Unmarshal(raw, &env)
325 msg := env.ErrorDesc
326 if msg == "" {
327 msg = env.Error
328 }
329 if msg == "" {
330 msg = res.Status
331 }
332 return fmt.Errorf("auth: %s", msg)
333 }
334 if dest == nil {
335 return nil
336 }
337 if err := json.Unmarshal(raw, dest); err != nil {
338 return fmt.Errorf("auth-antwoord: %w", err)
339 }
340 return nil
341 }
342
343 // StableAuthID maakt een positieve int64 uit tenant + object-id.
344 // Collisie is theoretisch mogelijk; bij een botsing krijgt de tweede gebruiker
345 // dezelfde auth_id (upsert op bestaande rij).
346 func StableAuthID(tenantID, objectID string) int64 {
347 sum := sha256.Sum256([]byte(tenantID + "\x00" + objectID))
348 var n uint64
349 for i := 0; i < 8; i++ {
350 n = n<<8 | uint64(sum[i])
351 }
352 n &^= 1 << 63
353 if n == 0 {
354 n = 1
355 }
356 return int64(n)
357 }
358
359 // entraUsername maakt een BlueGit-gebruikersnaam uit Entra-claims.
360 func entraUsername(preferred, email, display, oid string) (string, error) {
361 raw := strings.TrimSpace(preferred)
362 if raw == "" {
363 raw = strings.TrimSpace(email)
364 }
365 if i := strings.IndexByte(raw, '@'); i > 0 {
366 raw = raw[:i]
367 }
368 if raw == "" {
369 raw = strings.TrimSpace(display)
370 }
371 s := sanitizeUsername(raw)
372 if s == "" || names.ValidUsername(s) != nil {
373 sum := sha256.Sum256([]byte(oid))
374 s = fmt.Sprintf("u%x", sum[:4])
375 }
376 if err := names.ValidUsername(s); err != nil {
377 return "", fmt.Errorf("auth: geen bruikbare gebruikersnaam")
378 }
379 return s, nil
380 }
381
382 func sanitizeUsername(raw string) string {
383 s := strings.ToLower(strings.TrimSpace(raw))
384 var b strings.Builder
385 for _, r := range s {
386 switch {
387 case r >= 'a' && r <= 'z', r >= '0' && r <= '9', r == '_', r == '-':
388 b.WriteRune(r)
389 case r == '.' || r == ' ':
390 b.WriteByte('-')
391 }
392 }
393 out := strings.Trim(b.String(), "-_")
394 for strings.Contains(out, "--") {
395 out = strings.ReplaceAll(out, "--", "-")
396 }
397 if len(out) > 63 {
398 out = strings.Trim(out[:63], "-_")
399 }
400 return out
401 }
@@ -0,0 +1,401 @@
1package auth
2
3import (
4 "context"
5 "crypto/sha256"
6 "encoding/json"
7 "fmt"
8 "io"
9 "net/http"
10 "net/url"
11 "strings"
12 "sync"
13 "time"
14
15 "gitlab.com/Timfa/bluegit/internal/names"
16)
17
18// entraScope is wat de authorization-code-flow bij Entra vraagt.
19const entraScope = "openid profile email"
20
21// idTokenSkew is de toegestane klokverschuiving bij exp, nbf en iat.
22const idTokenSkew = 60 * time.Second
23
24// Entra is Microsoft Entra ID (OIDC, één tenant).
25// Extend en Logout doen niets op afstand: Entra kent die TimFalken-API's niet.
26type Entra struct {
27 Issuer string
28 TenantID string
29 ClientID string
30 Secret string
31 UserAgent string
32 HTTP *http.Client
33
34 mu sync.Mutex
35 authz string
36 token string
37 jwks *jwksCache
38 jwksURI string
39}
40
41// NewEntra maakt een OIDC-client. issuer is zonder slash aan het eind
42// (standaard https://login.microsoftonline.com/{tenant}/v2.0).
43func NewEntra(issuer, tenantID, clientID, secret, userAgent string) *Entra {
44 return &Entra{
45 Issuer: strings.TrimRight(issuer, "/"),
46 TenantID: tenantID,
47 ClientID: clientID,
48 Secret: secret,
49 UserAgent: userAgent,
50 HTTP: &http.Client{Timeout: 15 * time.Second},
51 jwks: &jwksCache{},
52 }
53}
54
55// AuthorizeURL stuurt de browser naar Entra met openid-profile-email, nonce en PKCE S256.
56func (e *Entra) AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string {
57 authz, err := e.authorizeEndpoint(context.Background())
58 if err != nil {
59 // Zonder discovery: vaste Entra-URL zodat /login niet paniceert.
60 authz = strings.TrimSuffix(e.Issuer, "/v2.0") + "/oauth2/v2.0/authorize"
61 }
62 q := url.Values{}
63 q.Set("client_id", e.ClientID)
64 q.Set("redirect_uri", redirectURI)
65 q.Set("response_type", "code")
66 q.Set("response_mode", "query")
67 q.Set("scope", entraScope)
68 q.Set("state", state)
69 q.Set("nonce", nonce)
70 if codeChallenge != "" {
71 q.Set("code_challenge", codeChallenge)
72 q.Set("code_challenge_method", "S256")
73 }
74 return authz + "?" + q.Encode()
75}
76
77// Exchange wisselt de code om, valideert het ID-token (JWKS, iss, aud, exp, tid, nonce, PKCE)
78// en mapt oid/tid naar een BlueGit-identity.
79func (e *Entra) Exchange(ctx context.Context, code, redirectURI, nonce, codeVerifier string) (Identity, error) {
80 if nonce == "" {
81 return Identity{}, fmt.Errorf("auth: nonce ontbreekt")
82 }
83 if strings.TrimSpace(codeVerifier) == "" {
84 return Identity{}, fmt.Errorf("auth: PKCE-verifier ontbreekt")
85 }
86 tokenURL, err := e.tokenEndpoint(ctx)
87 if err != nil {
88 return Identity{}, err
89 }
90 form := url.Values{}
91 form.Set("grant_type", "authorization_code")
92 form.Set("code", code)
93 form.Set("redirect_uri", redirectURI)
94 form.Set("client_id", e.ClientID)
95 form.Set("client_secret", e.Secret)
96 form.Set("scope", entraScope)
97 form.Set("code_verifier", codeVerifier)
98 req, err := http.NewRequestWithContext(ctx, http.MethodPost, tokenURL, strings.NewReader(form.Encode()))
99 if err != nil {
100 return Identity{}, err
101 }
102 req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
103 req.Header.Set("Accept", "application/json")
104 if e.UserAgent != "" {
105 req.Header.Set("User-Agent", e.UserAgent)
106 }
107 var body struct {
108 AccessToken string `json:"access_token"`
109 IDToken string `json:"id_token"`
110 ExpiresIn int `json:"expires_in"`
111 Error string `json:"error"`
112 ErrorDesc string `json:"error_description"`
113 }
114 if err := e.doJSON(req, &body); err != nil {
115 return Identity{}, err
116 }
117 if body.Error != "" || body.IDToken == "" {
118 msg := body.Error
119 if body.ErrorDesc != "" {
120 msg = body.ErrorDesc
121 }
122 if msg == "" {
123 msg = "lege tokenrespons"
124 }
125 return Identity{}, fmt.Errorf("auth: %s", msg)
126 }
127 claims, err := e.verifyIDToken(ctx, body.IDToken, nonce)
128 if err != nil {
129 return Identity{}, err
130 }
131 oid := claims.OID
132 if oid == "" {
133 oid = claims.Sub
134 }
135 if oid == "" {
136 return Identity{}, fmt.Errorf("auth: id_token zonder oid/sub")
137 }
138 username, err := entraUsername(claims.PreferredUsername, claims.Email, claims.Name, oid)
139 if err != nil {
140 return Identity{}, err
141 }
142 return Identity{
143 AuthID: StableAuthID(e.TenantID, oid),
144 Username: username,
145 AvatarURL: "", // Entra levert geen avatar-URL zonder Graph-foto-API.
146 IsAdmin: false,
147 AccessToken: body.AccessToken,
148 ExpiresIn: 86400, // BlueGit-sessie; Entra's access_token is korter.
149 }, nil
150}
151
152// Extend verlengt alleen lokaal: Entra heeft geen /api/session/extend.
153func (e *Entra) Extend(ctx context.Context, accessToken string) (int, error) {
154 return 86400, nil
155}
156
157// Logout doet niets op afstand; BlueGit wist de lokale sessie zelf.
158func (e *Entra) Logout(ctx context.Context, accessToken string) error {
159 return nil
160}
161
162type idClaims struct {
163 Iss string `json:"iss"`
164 Aud jsonAudience `json:"aud"`
165 Exp int64 `json:"exp"`
166 Iat int64 `json:"iat"`
167 Nbf int64 `json:"nbf"`
168 Nonce string `json:"nonce"`
169 OID string `json:"oid"`
170 Sub string `json:"sub"`
171 TID string `json:"tid"`
172 PreferredUsername string `json:"preferred_username"`
173 Email string `json:"email"`
174 Name string `json:"name"`
175}
176
177func (e *Entra) verifyIDToken(ctx context.Context, raw, nonce string) (idClaims, error) {
178 hdr, payload, err := parseJWT(raw)
179 if err != nil {
180 return idClaims{}, err
181 }
182 var claims idClaims
183 if hdr.Alg != "RS256" {
184 return idClaims{}, fmt.Errorf("auth: onverwacht jwt-algorithme %q", hdr.Alg)
185 }
186 if err := json.Unmarshal(payload, &claims); err != nil {
187 return idClaims{}, fmt.Errorf("auth: id_token claims: %w", err)
188 }
189 if claims.Iss != e.Issuer {
190 return idClaims{}, fmt.Errorf("auth: ongeldige issuer")
191 }
192 if !claims.Aud.includes(e.ClientID) {
193 return idClaims{}, fmt.Errorf("auth: ongeldige audience")
194 }
195 now := time.Now()
196 if claims.Exp == 0 || now.Add(-idTokenSkew).Unix() >= claims.Exp {
197 return idClaims{}, fmt.Errorf("auth: id_token verlopen of mist exp")
198 }
199 if claims.Nbf > 0 && now.Add(idTokenSkew).Unix() < claims.Nbf {
200 return idClaims{}, fmt.Errorf("auth: id_token nog niet geldig")
201 }
202 if claims.Iat > 0 && now.Add(idTokenSkew).Unix() < claims.Iat {
203 return idClaims{}, fmt.Errorf("auth: id_token iat ligt in de toekomst")
204 }
205 if claims.Nonce == "" || claims.Nonce != nonce {
206 return idClaims{}, fmt.Errorf("auth: ongeldige nonce")
207 }
208 if claims.TID == "" || !strings.EqualFold(claims.TID, e.TenantID) {
209 return idClaims{}, fmt.Errorf("auth: onverwachte tenant")
210 }
211 key, err := e.signingKey(ctx, hdr.Kid)
212 if err != nil {
213 return idClaims{}, err
214 }
215 if err := verifyRS256(raw, key); err != nil {
216 return idClaims{}, err
217 }
218 return claims, nil
219}
220
221func (e *Entra) signingKey(ctx context.Context, kid string) (any, error) {
222 if err := e.ensureDiscovery(ctx); err != nil {
223 return nil, err
224 }
225 return e.jwks.key(ctx, e.HTTP, e.jwksURI, kid)
226}
227
228func (e *Entra) authorizeEndpoint(ctx context.Context) (string, error) {
229 if err := e.ensureDiscovery(ctx); err != nil {
230 return "", err
231 }
232 e.mu.Lock()
233 defer e.mu.Unlock()
234 return e.authz, nil
235}
236
237func (e *Entra) tokenEndpoint(ctx context.Context) (string, error) {
238 if err := e.ensureDiscovery(ctx); err != nil {
239 return "", err
240 }
241 e.mu.Lock()
242 defer e.mu.Unlock()
243 return e.token, nil
244}
245
246func (e *Entra) ensureDiscovery(ctx context.Context) error {
247 e.mu.Lock()
248 if e.authz != "" && e.token != "" && e.jwksURI != "" {
249 e.mu.Unlock()
250 return nil
251 }
252 e.mu.Unlock()
253
254 req, err := http.NewRequestWithContext(ctx, http.MethodGet, e.Issuer+"/.well-known/openid-configuration", nil)
255 if err != nil {
256 return err
257 }
258 if e.UserAgent != "" {
259 req.Header.Set("User-Agent", e.UserAgent)
260 }
261 var doc struct {
262 AuthorizationEndpoint string `json:"authorization_endpoint"`
263 TokenEndpoint string `json:"token_endpoint"`
264 JWKSURI string `json:"jwks_uri"`
265 Issuer string `json:"issuer"`
266 }
267 if err := e.doJSON(req, &doc); err != nil {
268 return fmt.Errorf("auth: oidc discovery: %w", err)
269 }
270 if doc.AuthorizationEndpoint == "" || doc.TokenEndpoint == "" || doc.JWKSURI == "" {
271 return fmt.Errorf("auth: onvolledige oidc discovery")
272 }
273 if doc.Issuer != "" && doc.Issuer != e.Issuer {
274 return fmt.Errorf("auth: discovery-issuer wijkt af")
275 }
276 for _, ep := range []string{doc.AuthorizationEndpoint, doc.TokenEndpoint, doc.JWKSURI} {
277 if err := oidcEndpointHostOK(ep, e.Issuer); err != nil {
278 return err
279 }
280 }
281 e.mu.Lock()
282 e.authz = doc.AuthorizationEndpoint
283 e.token = doc.TokenEndpoint
284 e.jwksURI = doc.JWKSURI
285 e.mu.Unlock()
286 return nil
287}
288
289// oidcEndpointHostOK eist dat authorization, token en jwks op dezelfde host
290// staan als de issuer, en HTTPS gebruiken als de issuer HTTPS is.
291func oidcEndpointHostOK(endpoint, issuer string) error {
292 eu, err := url.Parse(endpoint)
293 if err != nil || eu.Host == "" || (eu.Scheme != "https" && eu.Scheme != "http") {
294 return fmt.Errorf("auth: ongeldig OIDC-eindpunt %q", endpoint)
295 }
296 iu, err := url.Parse(issuer)
297 if err != nil || iu.Host == "" {
298 return fmt.Errorf("auth: ongeldige issuer %q", issuer)
299 }
300 if !strings.EqualFold(eu.Hostname(), iu.Hostname()) {
301 return fmt.Errorf("auth: OIDC-eindpunt host %s past niet bij issuer-host %s", eu.Hostname(), iu.Hostname())
302 }
303 if iu.Scheme == "https" && eu.Scheme != "https" {
304 return fmt.Errorf("auth: OIDC-eindpunt moet HTTPS zijn: %s", endpoint)
305 }
306 return nil
307}
308
309func (e *Entra) doJSON(req *http.Request, dest any) error {
310 res, err := e.HTTP.Do(req)
311 if err != nil {
312 return fmt.Errorf("auth: %w", err)
313 }
314 defer res.Body.Close()
315 raw, err := io.ReadAll(io.LimitReader(res.Body, 1<<20))
316 if err != nil {
317 return err
318 }
319 if res.StatusCode >= 400 {
320 var env struct {
321 Error string `json:"error"`
322 ErrorDesc string `json:"error_description"`
323 }
324 _ = json.Unmarshal(raw, &env)
325 msg := env.ErrorDesc
326 if msg == "" {
327 msg = env.Error
328 }
329 if msg == "" {
330 msg = res.Status
331 }
332 return fmt.Errorf("auth: %s", msg)
333 }
334 if dest == nil {
335 return nil
336 }
337 if err := json.Unmarshal(raw, dest); err != nil {
338 return fmt.Errorf("auth-antwoord: %w", err)
339 }
340 return nil
341}
342
343// StableAuthID maakt een positieve int64 uit tenant + object-id.
344// Collisie is theoretisch mogelijk; bij een botsing krijgt de tweede gebruiker
345// dezelfde auth_id (upsert op bestaande rij).
346func StableAuthID(tenantID, objectID string) int64 {
347 sum := sha256.Sum256([]byte(tenantID + "\x00" + objectID))
348 var n uint64
349 for i := 0; i < 8; i++ {
350 n = n<<8 | uint64(sum[i])
351 }
352 n &^= 1 << 63
353 if n == 0 {
354 n = 1
355 }
356 return int64(n)
357}
358
359// entraUsername maakt een BlueGit-gebruikersnaam uit Entra-claims.
360func entraUsername(preferred, email, display, oid string) (string, error) {
361 raw := strings.TrimSpace(preferred)
362 if raw == "" {
363 raw = strings.TrimSpace(email)
364 }
365 if i := strings.IndexByte(raw, '@'); i > 0 {
366 raw = raw[:i]
367 }
368 if raw == "" {
369 raw = strings.TrimSpace(display)
370 }
371 s := sanitizeUsername(raw)
372 if s == "" || names.ValidUsername(s) != nil {
373 sum := sha256.Sum256([]byte(oid))
374 s = fmt.Sprintf("u%x", sum[:4])
375 }
376 if err := names.ValidUsername(s); err != nil {
377 return "", fmt.Errorf("auth: geen bruikbare gebruikersnaam")
378 }
379 return s, nil
380}
381
382func sanitizeUsername(raw string) string {
383 s := strings.ToLower(strings.TrimSpace(raw))
384 var b strings.Builder
385 for _, r := range s {
386 switch {
387 case r >= 'a' && r <= 'z', r >= '0' && r <= '9', r == '_', r == '-':
388 b.WriteRune(r)
389 case r == '.' || r == ' ':
390 b.WriteByte('-')
391 }
392 }
393 out := strings.Trim(b.String(), "-_")
394 for strings.Contains(out, "--") {
395 out = strings.ReplaceAll(out, "--", "-")
396 }
397 if len(out) > 63 {
398 out = strings.Trim(out[:63], "-_")
399 }
400 return out
401}
internal/auth/entra_hardening_test.go added +277 −0
@@ -0,0 +1,277 @@
1 package auth
2
3 import (
4 "context"
5 "crypto/hmac"
6 "crypto/rand"
7 "crypto/rsa"
8 "crypto/sha256"
9 "encoding/base64"
10 "encoding/json"
11 "net/http"
12 "net/http/httptest"
13 "strings"
14 "testing"
15 "time"
16 )
17
18 func TestPKCEChallengeRFC7636(t *testing.T) {
19 got := PKCEChallenge("dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk")
20 if got != "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM" {
21 t.Fatal(got)
22 }
23 }
24
25 type tokenHarness struct {
26 client *Entra
27 key *rsa.PrivateKey
28 kid string
29 nonce string
30 verifier string
31 close func()
32 }
33
34 func newTokenHarness(t *testing.T) *tokenHarness {
35 t.Helper()
36 key, err := rsa.GenerateKey(rand.Reader, 2048)
37 if err != nil {
38 t.Fatal(err)
39 }
40 kid := "test-key-1"
41 tenant := "00000000-0000-0000-0000-000000000099"
42 clientID := "11111111-1111-1111-1111-111111111199"
43 oid := "22222222-2222-2222-2222-222222222299"
44 nonce := "nonce-abc"
45 verifier, err := NewPKCEVerifier()
46 if err != nil {
47 t.Fatal(err)
48 }
49 mux := http.NewServeMux()
50 srv := httptest.NewServer(mux)
51 issuer := srv.URL
52 mux.HandleFunc("/.well-known/openid-configuration", func(w http.ResponseWriter, r *http.Request) {
53 _ = json.NewEncoder(w).Encode(map[string]string{
54 "issuer": issuer,
55 "authorization_endpoint": issuer + "/authorize",
56 "token_endpoint": issuer + "/token",
57 "jwks_uri": issuer + "/jwks",
58 })
59 })
60 mux.HandleFunc("/jwks", func(w http.ResponseWriter, r *http.Request) {
61 _ = json.NewEncoder(w).Encode(map[string]any{"keys": []map[string]string{testJWK(key, kid)}})
62 })
63 mux.HandleFunc("/token", func(w http.ResponseWriter, r *http.Request) {
64 _ = r.ParseForm()
65 if r.Form.Get("code_verifier") != verifier {
66 http.Error(w, `{"error":"invalid_grant"}`, http.StatusBadRequest)
67 return
68 }
69 tok, err := signIDToken(key, kid, validTokenClaims(issuer, nonce, tenant, clientID, oid))
70 if err != nil {
71 http.Error(w, err.Error(), 500)
72 return
73 }
74 _ = json.NewEncoder(w).Encode(map[string]any{"access_token": "entra-access", "id_token": tok, "expires_in": 3600})
75 })
76 client := NewEntra(issuer, tenant, clientID, "client-secret-placeholder", "BlueGitAccountClient/0.1")
77 client.HTTP = srv.Client()
78 return &tokenHarness{client: client, key: key, kid: kid, nonce: nonce, verifier: verifier, close: srv.Close}
79 }
80
81 func validTokenClaims(issuer, nonce, tenant, clientID, oid string) map[string]any {
82 now := time.Now()
83 return map[string]any{
84 "iss": issuer, "aud": clientID, "exp": now.Add(time.Hour).Unix(),
85 "iat": now.Unix(), "nbf": now.Add(-time.Minute).Unix(),
86 "nonce": nonce, "oid": oid, "sub": oid, "tid": tenant,
87 "preferred_username": "ada@contoso.example",
88 }
89 }
90
91 func signIDTokenAlg(alg, kid string, claims map[string]any, signer func(signing string) (string, error)) (string, error) {
92 hdr, err := json.Marshal(map[string]string{"alg": alg, "typ": "JWT", "kid": kid})
93 if err != nil {
94 return "", err
95 }
96 payload, err := json.Marshal(claims)
97 if err != nil {
98 return "", err
99 }
100 h := base64.RawURLEncoding.EncodeToString(hdr)
101 p := base64.RawURLEncoding.EncodeToString(payload)
102 signing := h + "." + p
103 if signer == nil {
104 return signing + ".", nil
105 }
106 sig, err := signer(signing)
107 if err != nil {
108 return "", err
109 }
110 return signing + "." + sig, nil
111 }
112
113 func TestEntraRequiresPKCE(t *testing.T) {
114 h := newTokenHarness(t)
115 defer h.close()
116 if _, err := h.client.Exchange(context.Background(), "good-code", "https://cb", h.nonce, ""); err == nil || !strings.Contains(err.Error(), "PKCE") {
117 t.Fatalf("lege verifier: %v", err)
118 }
119 if _, err := h.client.Exchange(context.Background(), "good-code", "https://cb", h.nonce, "andere-verifier"); err == nil {
120 t.Fatal("verkeerde verifier moest falen")
121 }
122 if _, err := h.client.Exchange(context.Background(), "good-code", "https://cb", h.nonce, h.verifier); err != nil {
123 t.Fatal(err)
124 }
125 }
126
127 func TestEntraRejectsForeignEndpointHost(t *testing.T) {
128 mux := http.NewServeMux()
129 srv := httptest.NewServer(mux)
130 defer srv.Close()
131 mux.HandleFunc("/.well-known/openid-configuration", func(w http.ResponseWriter, r *http.Request) {
132 _ = json.NewEncoder(w).Encode(map[string]string{
133 "issuer": srv.URL,
134 "authorization_endpoint": srv.URL + "/authorize",
135 "token_endpoint": srv.URL + "/token",
136 "jwks_uri": "https://evil.example/jwks",
137 })
138 })
139 client := NewEntra(srv.URL, "t", "c", "s", "")
140 client.HTTP = srv.Client()
141 err := client.ensureDiscovery(context.Background())
142 if err == nil || !strings.Contains(err.Error(), "host") {
143 t.Fatalf("vreemde jwks-host moest falen, kreeg %v", err)
144 }
145 }
146
147 func TestEntraIDTokenChecks(t *testing.T) {
148 h := newTokenHarness(t)
149 defer h.close()
150 if err := h.client.ensureDiscovery(context.Background()); err != nil {
151 t.Fatal(err)
152 }
153 tenant := h.client.TenantID
154 clientID := h.client.ClientID
155 oid := "22222222-2222-2222-2222-222222222299"
156 issuer := h.client.Issuer
157 nonce := h.nonce
158
159 mustOK := func(t *testing.T, claims map[string]any) {
160 t.Helper()
161 tok, err := signIDToken(h.key, h.kid, claims)
162 if err != nil {
163 t.Fatal(err)
164 }
165 if _, err := h.client.verifyIDToken(context.Background(), tok, nonce); err != nil {
166 t.Fatal(err)
167 }
168 }
169 mustErr := func(t *testing.T, tok, sub string) {
170 t.Helper()
171 _, err := h.client.verifyIDToken(context.Background(), tok, nonce)
172 if err == nil || (sub != "" && !strings.Contains(err.Error(), sub)) {
173 t.Fatalf("verwacht %q, kreeg %v", sub, err)
174 }
175 }
176
177 t.Run("ok", func(t *testing.T) { mustOK(t, validTokenClaims(issuer, nonce, tenant, clientID, oid)) })
178
179 t.Run("verlopen", func(t *testing.T) {
180 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
181 c["exp"] = time.Now().Add(-2 * time.Minute).Unix()
182 tok, err := signIDToken(h.key, h.kid, c)
183 if err != nil {
184 t.Fatal(err)
185 }
186 mustErr(t, tok, "verlopen")
187 })
188 t.Run("geen exp", func(t *testing.T) {
189 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
190 delete(c, "exp")
191 tok, err := signIDToken(h.key, h.kid, c)
192 if err != nil {
193 t.Fatal(err)
194 }
195 mustErr(t, tok, "exp")
196 })
197 t.Run("klokverschuiving exp", func(t *testing.T) {
198 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
199 c["exp"] = time.Now().Add(-30 * time.Second).Unix()
200 mustOK(t, c)
201 })
202 t.Run("geen tid", func(t *testing.T) {
203 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
204 delete(c, "tid")
205 tok, err := signIDToken(h.key, h.kid, c)
206 if err != nil {
207 t.Fatal(err)
208 }
209 mustErr(t, tok, "tenant")
210 })
211 t.Run("verkeerde tid", func(t *testing.T) {
212 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
213 c["tid"] = "andere-tenant"
214 tok, err := signIDToken(h.key, h.kid, c)
215 if err != nil {
216 t.Fatal(err)
217 }
218 mustErr(t, tok, "tenant")
219 })
220 t.Run("tid hoofdletters", func(t *testing.T) {
221 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
222 c["tid"] = strings.ToUpper(tenant)
223 mustOK(t, c)
224 })
225 t.Run("verkeerde issuer", func(t *testing.T) {
226 c := validTokenClaims("https://evil.example/t/v2.0", nonce, tenant, clientID, oid)
227 tok, err := signIDToken(h.key, h.kid, c)
228 if err != nil {
229 t.Fatal(err)
230 }
231 mustErr(t, tok, "issuer")
232 })
233 t.Run("slechte handtekening", func(t *testing.T) {
234 tok, err := signIDToken(h.key, h.kid, validTokenClaims(issuer, nonce, tenant, clientID, oid))
235 if err != nil {
236 t.Fatal(err)
237 }
238 tok = tok[:len(tok)-4] + "AAAA"
239 mustErr(t, tok, "handtekening")
240 })
241 t.Run("alg none", func(t *testing.T) {
242 tok, err := signIDTokenAlg("none", h.kid, validTokenClaims(issuer, nonce, tenant, clientID, oid), nil)
243 if err != nil {
244 t.Fatal(err)
245 }
246 mustErr(t, tok, "algorithme")
247 })
248 t.Run("alg HS256", func(t *testing.T) {
249 tok, err := signIDTokenAlg("HS256", h.kid, validTokenClaims(issuer, nonce, tenant, clientID, oid), func(signing string) (string, error) {
250 mac := hmac.New(sha256.New, []byte("geheim"))
251 _, _ = mac.Write([]byte(signing))
252 return base64.RawURLEncoding.EncodeToString(mac.Sum(nil)), nil
253 })
254 if err != nil {
255 t.Fatal(err)
256 }
257 mustErr(t, tok, "algorithme")
258 })
259 t.Run("nbf toekomst", func(t *testing.T) {
260 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
261 c["nbf"] = time.Now().Add(2 * time.Minute).Unix()
262 tok, err := signIDToken(h.key, h.kid, c)
263 if err != nil {
264 t.Fatal(err)
265 }
266 mustErr(t, tok, "geldig")
267 })
268 t.Run("iat toekomst", func(t *testing.T) {
269 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
270 c["iat"] = time.Now().Add(2 * time.Minute).Unix()
271 tok, err := signIDToken(h.key, h.kid, c)
272 if err != nil {
273 t.Fatal(err)
274 }
275 mustErr(t, tok, "iat")
276 })
277 }
@@ -0,0 +1,277 @@
1package auth
2
3import (
4 "context"
5 "crypto/hmac"
6 "crypto/rand"
7 "crypto/rsa"
8 "crypto/sha256"
9 "encoding/base64"
10 "encoding/json"
11 "net/http"
12 "net/http/httptest"
13 "strings"
14 "testing"
15 "time"
16)
17
18func TestPKCEChallengeRFC7636(t *testing.T) {
19 got := PKCEChallenge("dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk")
20 if got != "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM" {
21 t.Fatal(got)
22 }
23}
24
25type tokenHarness struct {
26 client *Entra
27 key *rsa.PrivateKey
28 kid string
29 nonce string
30 verifier string
31 close func()
32}
33
34func newTokenHarness(t *testing.T) *tokenHarness {
35 t.Helper()
36 key, err := rsa.GenerateKey(rand.Reader, 2048)
37 if err != nil {
38 t.Fatal(err)
39 }
40 kid := "test-key-1"
41 tenant := "00000000-0000-0000-0000-000000000099"
42 clientID := "11111111-1111-1111-1111-111111111199"
43 oid := "22222222-2222-2222-2222-222222222299"
44 nonce := "nonce-abc"
45 verifier, err := NewPKCEVerifier()
46 if err != nil {
47 t.Fatal(err)
48 }
49 mux := http.NewServeMux()
50 srv := httptest.NewServer(mux)
51 issuer := srv.URL
52 mux.HandleFunc("/.well-known/openid-configuration", func(w http.ResponseWriter, r *http.Request) {
53 _ = json.NewEncoder(w).Encode(map[string]string{
54 "issuer": issuer,
55 "authorization_endpoint": issuer + "/authorize",
56 "token_endpoint": issuer + "/token",
57 "jwks_uri": issuer + "/jwks",
58 })
59 })
60 mux.HandleFunc("/jwks", func(w http.ResponseWriter, r *http.Request) {
61 _ = json.NewEncoder(w).Encode(map[string]any{"keys": []map[string]string{testJWK(key, kid)}})
62 })
63 mux.HandleFunc("/token", func(w http.ResponseWriter, r *http.Request) {
64 _ = r.ParseForm()
65 if r.Form.Get("code_verifier") != verifier {
66 http.Error(w, `{"error":"invalid_grant"}`, http.StatusBadRequest)
67 return
68 }
69 tok, err := signIDToken(key, kid, validTokenClaims(issuer, nonce, tenant, clientID, oid))
70 if err != nil {
71 http.Error(w, err.Error(), 500)
72 return
73 }
74 _ = json.NewEncoder(w).Encode(map[string]any{"access_token": "entra-access", "id_token": tok, "expires_in": 3600})
75 })
76 client := NewEntra(issuer, tenant, clientID, "client-secret-placeholder", "BlueGitAccountClient/0.1")
77 client.HTTP = srv.Client()
78 return &tokenHarness{client: client, key: key, kid: kid, nonce: nonce, verifier: verifier, close: srv.Close}
79}
80
81func validTokenClaims(issuer, nonce, tenant, clientID, oid string) map[string]any {
82 now := time.Now()
83 return map[string]any{
84 "iss": issuer, "aud": clientID, "exp": now.Add(time.Hour).Unix(),
85 "iat": now.Unix(), "nbf": now.Add(-time.Minute).Unix(),
86 "nonce": nonce, "oid": oid, "sub": oid, "tid": tenant,
87 "preferred_username": "ada@contoso.example",
88 }
89}
90
91func signIDTokenAlg(alg, kid string, claims map[string]any, signer func(signing string) (string, error)) (string, error) {
92 hdr, err := json.Marshal(map[string]string{"alg": alg, "typ": "JWT", "kid": kid})
93 if err != nil {
94 return "", err
95 }
96 payload, err := json.Marshal(claims)
97 if err != nil {
98 return "", err
99 }
100 h := base64.RawURLEncoding.EncodeToString(hdr)
101 p := base64.RawURLEncoding.EncodeToString(payload)
102 signing := h + "." + p
103 if signer == nil {
104 return signing + ".", nil
105 }
106 sig, err := signer(signing)
107 if err != nil {
108 return "", err
109 }
110 return signing + "." + sig, nil
111}
112
113func TestEntraRequiresPKCE(t *testing.T) {
114 h := newTokenHarness(t)
115 defer h.close()
116 if _, err := h.client.Exchange(context.Background(), "good-code", "https://cb", h.nonce, ""); err == nil || !strings.Contains(err.Error(), "PKCE") {
117 t.Fatalf("lege verifier: %v", err)
118 }
119 if _, err := h.client.Exchange(context.Background(), "good-code", "https://cb", h.nonce, "andere-verifier"); err == nil {
120 t.Fatal("verkeerde verifier moest falen")
121 }
122 if _, err := h.client.Exchange(context.Background(), "good-code", "https://cb", h.nonce, h.verifier); err != nil {
123 t.Fatal(err)
124 }
125}
126
127func TestEntraRejectsForeignEndpointHost(t *testing.T) {
128 mux := http.NewServeMux()
129 srv := httptest.NewServer(mux)
130 defer srv.Close()
131 mux.HandleFunc("/.well-known/openid-configuration", func(w http.ResponseWriter, r *http.Request) {
132 _ = json.NewEncoder(w).Encode(map[string]string{
133 "issuer": srv.URL,
134 "authorization_endpoint": srv.URL + "/authorize",
135 "token_endpoint": srv.URL + "/token",
136 "jwks_uri": "https://evil.example/jwks",
137 })
138 })
139 client := NewEntra(srv.URL, "t", "c", "s", "")
140 client.HTTP = srv.Client()
141 err := client.ensureDiscovery(context.Background())
142 if err == nil || !strings.Contains(err.Error(), "host") {
143 t.Fatalf("vreemde jwks-host moest falen, kreeg %v", err)
144 }
145}
146
147func TestEntraIDTokenChecks(t *testing.T) {
148 h := newTokenHarness(t)
149 defer h.close()
150 if err := h.client.ensureDiscovery(context.Background()); err != nil {
151 t.Fatal(err)
152 }
153 tenant := h.client.TenantID
154 clientID := h.client.ClientID
155 oid := "22222222-2222-2222-2222-222222222299"
156 issuer := h.client.Issuer
157 nonce := h.nonce
158
159 mustOK := func(t *testing.T, claims map[string]any) {
160 t.Helper()
161 tok, err := signIDToken(h.key, h.kid, claims)
162 if err != nil {
163 t.Fatal(err)
164 }
165 if _, err := h.client.verifyIDToken(context.Background(), tok, nonce); err != nil {
166 t.Fatal(err)
167 }
168 }
169 mustErr := func(t *testing.T, tok, sub string) {
170 t.Helper()
171 _, err := h.client.verifyIDToken(context.Background(), tok, nonce)
172 if err == nil || (sub != "" && !strings.Contains(err.Error(), sub)) {
173 t.Fatalf("verwacht %q, kreeg %v", sub, err)
174 }
175 }
176
177 t.Run("ok", func(t *testing.T) { mustOK(t, validTokenClaims(issuer, nonce, tenant, clientID, oid)) })
178
179 t.Run("verlopen", func(t *testing.T) {
180 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
181 c["exp"] = time.Now().Add(-2 * time.Minute).Unix()
182 tok, err := signIDToken(h.key, h.kid, c)
183 if err != nil {
184 t.Fatal(err)
185 }
186 mustErr(t, tok, "verlopen")
187 })
188 t.Run("geen exp", func(t *testing.T) {
189 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
190 delete(c, "exp")
191 tok, err := signIDToken(h.key, h.kid, c)
192 if err != nil {
193 t.Fatal(err)
194 }
195 mustErr(t, tok, "exp")
196 })
197 t.Run("klokverschuiving exp", func(t *testing.T) {
198 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
199 c["exp"] = time.Now().Add(-30 * time.Second).Unix()
200 mustOK(t, c)
201 })
202 t.Run("geen tid", func(t *testing.T) {
203 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
204 delete(c, "tid")
205 tok, err := signIDToken(h.key, h.kid, c)
206 if err != nil {
207 t.Fatal(err)
208 }
209 mustErr(t, tok, "tenant")
210 })
211 t.Run("verkeerde tid", func(t *testing.T) {
212 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
213 c["tid"] = "andere-tenant"
214 tok, err := signIDToken(h.key, h.kid, c)
215 if err != nil {
216 t.Fatal(err)
217 }
218 mustErr(t, tok, "tenant")
219 })
220 t.Run("tid hoofdletters", func(t *testing.T) {
221 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
222 c["tid"] = strings.ToUpper(tenant)
223 mustOK(t, c)
224 })
225 t.Run("verkeerde issuer", func(t *testing.T) {
226 c := validTokenClaims("https://evil.example/t/v2.0", nonce, tenant, clientID, oid)
227 tok, err := signIDToken(h.key, h.kid, c)
228 if err != nil {
229 t.Fatal(err)
230 }
231 mustErr(t, tok, "issuer")
232 })
233 t.Run("slechte handtekening", func(t *testing.T) {
234 tok, err := signIDToken(h.key, h.kid, validTokenClaims(issuer, nonce, tenant, clientID, oid))
235 if err != nil {
236 t.Fatal(err)
237 }
238 tok = tok[:len(tok)-4] + "AAAA"
239 mustErr(t, tok, "handtekening")
240 })
241 t.Run("alg none", func(t *testing.T) {
242 tok, err := signIDTokenAlg("none", h.kid, validTokenClaims(issuer, nonce, tenant, clientID, oid), nil)
243 if err != nil {
244 t.Fatal(err)
245 }
246 mustErr(t, tok, "algorithme")
247 })
248 t.Run("alg HS256", func(t *testing.T) {
249 tok, err := signIDTokenAlg("HS256", h.kid, validTokenClaims(issuer, nonce, tenant, clientID, oid), func(signing string) (string, error) {
250 mac := hmac.New(sha256.New, []byte("geheim"))
251 _, _ = mac.Write([]byte(signing))
252 return base64.RawURLEncoding.EncodeToString(mac.Sum(nil)), nil
253 })
254 if err != nil {
255 t.Fatal(err)
256 }
257 mustErr(t, tok, "algorithme")
258 })
259 t.Run("nbf toekomst", func(t *testing.T) {
260 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
261 c["nbf"] = time.Now().Add(2 * time.Minute).Unix()
262 tok, err := signIDToken(h.key, h.kid, c)
263 if err != nil {
264 t.Fatal(err)
265 }
266 mustErr(t, tok, "geldig")
267 })
268 t.Run("iat toekomst", func(t *testing.T) {
269 c := validTokenClaims(issuer, nonce, tenant, clientID, oid)
270 c["iat"] = time.Now().Add(2 * time.Minute).Unix()
271 tok, err := signIDToken(h.key, h.kid, c)
272 if err != nil {
273 t.Fatal(err)
274 }
275 mustErr(t, tok, "iat")
276 })
277}
internal/auth/entra_test.go added +203 −0
@@ -0,0 +1,203 @@
1 package auth
2
3 import (
4 "context"
5 "crypto"
6 "crypto/rand"
7 "crypto/rsa"
8 "crypto/sha256"
9 "encoding/base64"
10 "encoding/binary"
11 "encoding/json"
12 "net/http"
13 "net/http/httptest"
14 "strings"
15 "testing"
16 "time"
17 )
18
19 func TestStableAuthID(t *testing.T) {
20 a := StableAuthID("tenant-a", "oid-1")
21 b := StableAuthID("tenant-a", "oid-1")
22 c := StableAuthID("tenant-a", "oid-2")
23 if a <= 0 || a != b || a == c {
24 t.Fatalf("%d %d %d", a, b, c)
25 }
26 }
27
28 func TestEntraUsername(t *testing.T) {
29 u, err := entraUsername("Ada.Lovelace@contoso.example", "", "", "oid")
30 if err != nil || u != "ada-lovelace" {
31 t.Fatalf("%q %v", u, err)
32 }
33 u, err = entraUsername("", "", "!!!", "deadbeef-oid")
34 if err != nil || !strings.HasPrefix(u, "u") {
35 t.Fatalf("%q %v", u, err)
36 }
37 }
38
39 func TestEntraExchangeWithFakeOIDC(t *testing.T) {
40 key, err := rsa.GenerateKey(rand.Reader, 2048)
41 if err != nil {
42 t.Fatal(err)
43 }
44 kid := "test-key-1"
45 tenant := "00000000-0000-0000-0000-000000000099"
46 clientID := "11111111-1111-1111-1111-111111111199"
47 oid := "22222222-2222-2222-2222-222222222299"
48 nonce := "nonce-abc"
49 verifier, err := NewPKCEVerifier()
50 if err != nil {
51 t.Fatal(err)
52 }
53
54 var issuer string
55 mux := http.NewServeMux()
56 srv := httptest.NewServer(mux)
57 defer srv.Close()
58 issuer = srv.URL
59
60 mux.HandleFunc("/.well-known/openid-configuration", func(w http.ResponseWriter, r *http.Request) {
61 _ = json.NewEncoder(w).Encode(map[string]string{
62 "issuer": issuer,
63 "authorization_endpoint": issuer + "/authorize",
64 "token_endpoint": issuer + "/token",
65 "jwks_uri": issuer + "/jwks",
66 })
67 })
68 mux.HandleFunc("/jwks", func(w http.ResponseWriter, r *http.Request) {
69 _ = json.NewEncoder(w).Encode(map[string]any{"keys": []map[string]string{testJWK(key, kid)}})
70 })
71 mux.HandleFunc("/token", func(w http.ResponseWriter, r *http.Request) {
72 if err := r.ParseForm(); err != nil {
73 t.Error(err)
74 }
75 if r.Form.Get("code") != "good-code" || r.Form.Get("client_id") != clientID || r.Form.Get("code_verifier") != verifier {
76 http.Error(w, `{"error":"invalid_grant"}`, http.StatusBadRequest)
77 return
78 }
79 idTok, err := signIDToken(key, kid, map[string]any{
80 "iss": issuer,
81 "aud": clientID,
82 "exp": time.Now().Add(time.Hour).Unix(),
83 "nbf": time.Now().Add(-time.Minute).Unix(),
84 "nonce": nonce,
85 "oid": oid,
86 "sub": oid,
87 "tid": tenant,
88 "preferred_username": "ada@contoso.example",
89 "name": "Ada Lovelace",
90 })
91 if err != nil {
92 t.Error(err)
93 http.Error(w, err.Error(), 500)
94 return
95 }
96 _ = json.NewEncoder(w).Encode(map[string]any{
97 "access_token": "entra-access",
98 "id_token": idTok,
99 "expires_in": 3600,
100 "token_type": "Bearer",
101 })
102 })
103
104 client := NewEntra(issuer, tenant, clientID, "client-secret-placeholder", "BlueGitAccountClient/0.1")
105 client.HTTP = srv.Client()
106
107 challenge := PKCEChallenge(verifier)
108 url := client.AuthorizeURL("state-1", nonce, "https://git.example.test/auth/callback", challenge)
109 if !strings.Contains(url, "/authorize?") || !strings.Contains(url, "nonce="+nonce) || !strings.Contains(url, "scope=openid+profile+email") {
110 t.Fatal(url)
111 }
112 if !strings.Contains(url, "code_challenge="+challenge) || !strings.Contains(url, "code_challenge_method=S256") {
113 t.Fatal(url)
114 }
115
116 id, err := client.Exchange(context.Background(), "good-code", "https://git.example.test/auth/callback", nonce, verifier)
117 if err != nil {
118 t.Fatal(err)
119 }
120 if id.AuthID != StableAuthID(tenant, oid) || id.Username != "ada" || id.AccessToken != "entra-access" {
121 t.Fatalf("%+v", id)
122 }
123 if id.IsAdmin || id.AvatarURL != "" || id.ExpiresIn != 86400 {
124 t.Fatalf("degradatie verwacht: %+v", id)
125 }
126 sec, err := client.Extend(context.Background(), id.AccessToken)
127 if err != nil || sec != 86400 {
128 t.Fatalf("extend %d %v", sec, err)
129 }
130 if err := client.Logout(context.Background(), id.AccessToken); err != nil {
131 t.Fatal(err)
132 }
133 if _, err := client.Exchange(context.Background(), "good-code", "https://git.example.test/auth/callback", "andere", verifier); err == nil {
134 t.Fatal("verwacht nonce-fout")
135 }
136 }
137
138 func TestEntraRejectsBadAudience(t *testing.T) {
139 key, err := rsa.GenerateKey(rand.Reader, 2048)
140 if err != nil {
141 t.Fatal(err)
142 }
143 kid := "k1"
144 mux := http.NewServeMux()
145 srv := httptest.NewServer(mux)
146 defer srv.Close()
147 issuer := srv.URL
148 mux.HandleFunc("/.well-known/openid-configuration", func(w http.ResponseWriter, r *http.Request) {
149 _ = json.NewEncoder(w).Encode(map[string]string{
150 "issuer": issuer, "authorization_endpoint": issuer + "/a",
151 "token_endpoint": issuer + "/token", "jwks_uri": issuer + "/jwks",
152 })
153 })
154 mux.HandleFunc("/jwks", func(w http.ResponseWriter, r *http.Request) {
155 _ = json.NewEncoder(w).Encode(map[string]any{"keys": []map[string]string{testJWK(key, kid)}})
156 })
157 mux.HandleFunc("/token", func(w http.ResponseWriter, r *http.Request) {
158 tok, _ := signIDToken(key, kid, map[string]any{
159 "iss": issuer, "aud": "andere-app", "exp": time.Now().Add(time.Hour).Unix(),
160 "nonce": "n", "oid": "o", "sub": "o", "tid": "t",
161 })
162 _ = json.NewEncoder(w).Encode(map[string]any{"access_token": "x", "id_token": tok})
163 })
164 client := NewEntra(issuer, "t", "mijn-app", "geheim", "")
165 client.HTTP = srv.Client()
166 _, err = client.Exchange(context.Background(), "c", "https://cb", "n", "pkce-verifier")
167 if err == nil || !strings.Contains(err.Error(), "audience") {
168 t.Fatalf("verwacht audience-fout, kreeg %v", err)
169 }
170 }
171
172 func testJWK(key *rsa.PrivateKey, kid string) map[string]string {
173 n := base64.RawURLEncoding.EncodeToString(key.N.Bytes())
174 eb := make([]byte, 8)
175 binary.BigEndian.PutUint64(eb, uint64(key.E))
176 for len(eb) > 1 && eb[0] == 0 {
177 eb = eb[1:]
178 }
179 return map[string]string{
180 "kty": "RSA", "kid": kid, "use": "sig", "alg": "RS256",
181 "n": n, "e": base64.RawURLEncoding.EncodeToString(eb),
182 }
183 }
184
185 func signIDToken(key *rsa.PrivateKey, kid string, claims map[string]any) (string, error) {
186 hdr, err := json.Marshal(map[string]string{"alg": "RS256", "typ": "JWT", "kid": kid})
187 if err != nil {
188 return "", err
189 }
190 payload, err := json.Marshal(claims)
191 if err != nil {
192 return "", err
193 }
194 h := base64.RawURLEncoding.EncodeToString(hdr)
195 p := base64.RawURLEncoding.EncodeToString(payload)
196 signing := h + "." + p
197 sum := sha256.Sum256([]byte(signing))
198 sig, err := rsa.SignPKCS1v15(rand.Reader, key, crypto.SHA256, sum[:])
199 if err != nil {
200 return "", err
201 }
202 return signing + "." + base64.RawURLEncoding.EncodeToString(sig), nil
203 }
@@ -0,0 +1,203 @@
1package auth
2
3import (
4 "context"
5 "crypto"
6 "crypto/rand"
7 "crypto/rsa"
8 "crypto/sha256"
9 "encoding/base64"
10 "encoding/binary"
11 "encoding/json"
12 "net/http"
13 "net/http/httptest"
14 "strings"
15 "testing"
16 "time"
17)
18
19func TestStableAuthID(t *testing.T) {
20 a := StableAuthID("tenant-a", "oid-1")
21 b := StableAuthID("tenant-a", "oid-1")
22 c := StableAuthID("tenant-a", "oid-2")
23 if a <= 0 || a != b || a == c {
24 t.Fatalf("%d %d %d", a, b, c)
25 }
26}
27
28func TestEntraUsername(t *testing.T) {
29 u, err := entraUsername("Ada.Lovelace@contoso.example", "", "", "oid")
30 if err != nil || u != "ada-lovelace" {
31 t.Fatalf("%q %v", u, err)
32 }
33 u, err = entraUsername("", "", "!!!", "deadbeef-oid")
34 if err != nil || !strings.HasPrefix(u, "u") {
35 t.Fatalf("%q %v", u, err)
36 }
37}
38
39func TestEntraExchangeWithFakeOIDC(t *testing.T) {
40 key, err := rsa.GenerateKey(rand.Reader, 2048)
41 if err != nil {
42 t.Fatal(err)
43 }
44 kid := "test-key-1"
45 tenant := "00000000-0000-0000-0000-000000000099"
46 clientID := "11111111-1111-1111-1111-111111111199"
47 oid := "22222222-2222-2222-2222-222222222299"
48 nonce := "nonce-abc"
49 verifier, err := NewPKCEVerifier()
50 if err != nil {
51 t.Fatal(err)
52 }
53
54 var issuer string
55 mux := http.NewServeMux()
56 srv := httptest.NewServer(mux)
57 defer srv.Close()
58 issuer = srv.URL
59
60 mux.HandleFunc("/.well-known/openid-configuration", func(w http.ResponseWriter, r *http.Request) {
61 _ = json.NewEncoder(w).Encode(map[string]string{
62 "issuer": issuer,
63 "authorization_endpoint": issuer + "/authorize",
64 "token_endpoint": issuer + "/token",
65 "jwks_uri": issuer + "/jwks",
66 })
67 })
68 mux.HandleFunc("/jwks", func(w http.ResponseWriter, r *http.Request) {
69 _ = json.NewEncoder(w).Encode(map[string]any{"keys": []map[string]string{testJWK(key, kid)}})
70 })
71 mux.HandleFunc("/token", func(w http.ResponseWriter, r *http.Request) {
72 if err := r.ParseForm(); err != nil {
73 t.Error(err)
74 }
75 if r.Form.Get("code") != "good-code" || r.Form.Get("client_id") != clientID || r.Form.Get("code_verifier") != verifier {
76 http.Error(w, `{"error":"invalid_grant"}`, http.StatusBadRequest)
77 return
78 }
79 idTok, err := signIDToken(key, kid, map[string]any{
80 "iss": issuer,
81 "aud": clientID,
82 "exp": time.Now().Add(time.Hour).Unix(),
83 "nbf": time.Now().Add(-time.Minute).Unix(),
84 "nonce": nonce,
85 "oid": oid,
86 "sub": oid,
87 "tid": tenant,
88 "preferred_username": "ada@contoso.example",
89 "name": "Ada Lovelace",
90 })
91 if err != nil {
92 t.Error(err)
93 http.Error(w, err.Error(), 500)
94 return
95 }
96 _ = json.NewEncoder(w).Encode(map[string]any{
97 "access_token": "entra-access",
98 "id_token": idTok,
99 "expires_in": 3600,
100 "token_type": "Bearer",
101 })
102 })
103
104 client := NewEntra(issuer, tenant, clientID, "client-secret-placeholder", "BlueGitAccountClient/0.1")
105 client.HTTP = srv.Client()
106
107 challenge := PKCEChallenge(verifier)
108 url := client.AuthorizeURL("state-1", nonce, "https://git.example.test/auth/callback", challenge)
109 if !strings.Contains(url, "/authorize?") || !strings.Contains(url, "nonce="+nonce) || !strings.Contains(url, "scope=openid+profile+email") {
110 t.Fatal(url)
111 }
112 if !strings.Contains(url, "code_challenge="+challenge) || !strings.Contains(url, "code_challenge_method=S256") {
113 t.Fatal(url)
114 }
115
116 id, err := client.Exchange(context.Background(), "good-code", "https://git.example.test/auth/callback", nonce, verifier)
117 if err != nil {
118 t.Fatal(err)
119 }
120 if id.AuthID != StableAuthID(tenant, oid) || id.Username != "ada" || id.AccessToken != "entra-access" {
121 t.Fatalf("%+v", id)
122 }
123 if id.IsAdmin || id.AvatarURL != "" || id.ExpiresIn != 86400 {
124 t.Fatalf("degradatie verwacht: %+v", id)
125 }
126 sec, err := client.Extend(context.Background(), id.AccessToken)
127 if err != nil || sec != 86400 {
128 t.Fatalf("extend %d %v", sec, err)
129 }
130 if err := client.Logout(context.Background(), id.AccessToken); err != nil {
131 t.Fatal(err)
132 }
133 if _, err := client.Exchange(context.Background(), "good-code", "https://git.example.test/auth/callback", "andere", verifier); err == nil {
134 t.Fatal("verwacht nonce-fout")
135 }
136}
137
138func TestEntraRejectsBadAudience(t *testing.T) {
139 key, err := rsa.GenerateKey(rand.Reader, 2048)
140 if err != nil {
141 t.Fatal(err)
142 }
143 kid := "k1"
144 mux := http.NewServeMux()
145 srv := httptest.NewServer(mux)
146 defer srv.Close()
147 issuer := srv.URL
148 mux.HandleFunc("/.well-known/openid-configuration", func(w http.ResponseWriter, r *http.Request) {
149 _ = json.NewEncoder(w).Encode(map[string]string{
150 "issuer": issuer, "authorization_endpoint": issuer + "/a",
151 "token_endpoint": issuer + "/token", "jwks_uri": issuer + "/jwks",
152 })
153 })
154 mux.HandleFunc("/jwks", func(w http.ResponseWriter, r *http.Request) {
155 _ = json.NewEncoder(w).Encode(map[string]any{"keys": []map[string]string{testJWK(key, kid)}})
156 })
157 mux.HandleFunc("/token", func(w http.ResponseWriter, r *http.Request) {
158 tok, _ := signIDToken(key, kid, map[string]any{
159 "iss": issuer, "aud": "andere-app", "exp": time.Now().Add(time.Hour).Unix(),
160 "nonce": "n", "oid": "o", "sub": "o", "tid": "t",
161 })
162 _ = json.NewEncoder(w).Encode(map[string]any{"access_token": "x", "id_token": tok})
163 })
164 client := NewEntra(issuer, "t", "mijn-app", "geheim", "")
165 client.HTTP = srv.Client()
166 _, err = client.Exchange(context.Background(), "c", "https://cb", "n", "pkce-verifier")
167 if err == nil || !strings.Contains(err.Error(), "audience") {
168 t.Fatalf("verwacht audience-fout, kreeg %v", err)
169 }
170}
171
172func testJWK(key *rsa.PrivateKey, kid string) map[string]string {
173 n := base64.RawURLEncoding.EncodeToString(key.N.Bytes())
174 eb := make([]byte, 8)
175 binary.BigEndian.PutUint64(eb, uint64(key.E))
176 for len(eb) > 1 && eb[0] == 0 {
177 eb = eb[1:]
178 }
179 return map[string]string{
180 "kty": "RSA", "kid": kid, "use": "sig", "alg": "RS256",
181 "n": n, "e": base64.RawURLEncoding.EncodeToString(eb),
182 }
183}
184
185func signIDToken(key *rsa.PrivateKey, kid string, claims map[string]any) (string, error) {
186 hdr, err := json.Marshal(map[string]string{"alg": "RS256", "typ": "JWT", "kid": kid})
187 if err != nil {
188 return "", err
189 }
190 payload, err := json.Marshal(claims)
191 if err != nil {
192 return "", err
193 }
194 h := base64.RawURLEncoding.EncodeToString(hdr)
195 p := base64.RawURLEncoding.EncodeToString(payload)
196 signing := h + "." + p
197 sum := sha256.Sum256([]byte(signing))
198 sig, err := rsa.SignPKCS1v15(rand.Reader, key, crypto.SHA256, sum[:])
199 if err != nil {
200 return "", err
201 }
202 return signing + "." + base64.RawURLEncoding.EncodeToString(sig), nil
203}
internal/auth/oidc_jwt.go added +195 −0
@@ -0,0 +1,195 @@
1 package auth
2
3 import (
4 "context"
5 "crypto"
6 "crypto/rsa"
7 "crypto/sha256"
8 "encoding/base64"
9 "encoding/binary"
10 "encoding/json"
11 "fmt"
12 "io"
13 "math/big"
14 "net/http"
15 "strings"
16 "sync"
17 "time"
18 )
19
20 type jwtHeader struct {
21 Alg string `json:"alg"`
22 Kid string `json:"kid"`
23 Typ string `json:"typ"`
24 }
25
26 // jsonAudience accepteert "aud" als string of als array.
27 type jsonAudience []string
28
29 func (a *jsonAudience) UnmarshalJSON(b []byte) error {
30 var one string
31 if err := json.Unmarshal(b, &one); err == nil {
32 *a = []string{one}
33 return nil
34 }
35 var many []string
36 if err := json.Unmarshal(b, &many); err != nil {
37 return err
38 }
39 *a = many
40 return nil
41 }
42
43 func (a jsonAudience) includes(want string) bool {
44 for _, v := range a {
45 if v == want {
46 return true
47 }
48 }
49 return false
50 }
51
52 func parseJWT(raw string) (jwtHeader, []byte, error) {
53 parts := strings.Split(raw, ".")
54 if len(parts) != 3 {
55 return jwtHeader{}, nil, fmt.Errorf("auth: ongeldig jwt")
56 }
57 hb, err := b64url(parts[0])
58 if err != nil {
59 return jwtHeader{}, nil, fmt.Errorf("auth: jwt-header: %w", err)
60 }
61 var hdr jwtHeader
62 if err := json.Unmarshal(hb, &hdr); err != nil {
63 return jwtHeader{}, nil, fmt.Errorf("auth: jwt-header: %w", err)
64 }
65 pb, err := b64url(parts[1])
66 if err != nil {
67 return jwtHeader{}, nil, fmt.Errorf("auth: jwt-payload: %w", err)
68 }
69 return hdr, pb, nil
70 }
71
72 func verifyRS256(raw string, key any) error {
73 pub, ok := key.(*rsa.PublicKey)
74 if !ok || pub == nil {
75 return fmt.Errorf("auth: geen rsa-sleutel")
76 }
77 parts := strings.Split(raw, ".")
78 if len(parts) != 3 {
79 return fmt.Errorf("auth: ongeldig jwt")
80 }
81 sig, err := b64url(parts[2])
82 if err != nil {
83 return fmt.Errorf("auth: jwt-handtekening: %w", err)
84 }
85 sum := sha256.Sum256([]byte(parts[0] + "." + parts[1]))
86 if err := rsa.VerifyPKCS1v15(pub, crypto.SHA256, sum[:], sig); err != nil {
87 return fmt.Errorf("auth: jwt-handtekening ongeldig")
88 }
89 return nil
90 }
91
92 func b64url(s string) ([]byte, error) {
93 return base64.RawURLEncoding.DecodeString(s)
94 }
95
96 type jwksCache struct {
97 mu sync.Mutex
98 fetched time.Time
99 keys map[string]*rsa.PublicKey
100 uri string
101 }
102
103 func (c *jwksCache) key(ctx context.Context, httpc *http.Client, uri, kid string) (*rsa.PublicKey, error) {
104 c.mu.Lock()
105 if k := c.keys[kid]; k != nil && c.uri == uri && time.Since(c.fetched) < time.Hour {
106 c.mu.Unlock()
107 return k, nil
108 }
109 c.mu.Unlock()
110 if err := c.refresh(ctx, httpc, uri); err != nil {
111 return nil, err
112 }
113 c.mu.Lock()
114 defer c.mu.Unlock()
115 k := c.keys[kid]
116 if k == nil {
117 return nil, fmt.Errorf("auth: jwks-sleutel %q ontbreekt", kid)
118 }
119 return k, nil
120 }
121
122 func (c *jwksCache) refresh(ctx context.Context, httpc *http.Client, uri string) error {
123 req, err := http.NewRequestWithContext(ctx, http.MethodGet, uri, nil)
124 if err != nil {
125 return err
126 }
127 res, err := httpc.Do(req)
128 if err != nil {
129 return fmt.Errorf("auth: jwks: %w", err)
130 }
131 defer res.Body.Close()
132 raw, err := io.ReadAll(io.LimitReader(res.Body, 1<<20))
133 if err != nil {
134 return err
135 }
136 if res.StatusCode >= 400 {
137 return fmt.Errorf("auth: jwks %s", res.Status)
138 }
139 var doc struct {
140 Keys []jwk `json:"keys"`
141 }
142 if err := json.Unmarshal(raw, &doc); err != nil {
143 return fmt.Errorf("auth: jwks: %w", err)
144 }
145 keys := make(map[string]*rsa.PublicKey, len(doc.Keys))
146 for _, k := range doc.Keys {
147 if k.Kty != "RSA" || k.Kid == "" || k.N == "" || k.E == "" {
148 continue
149 }
150 pub, err := k.rsaPublic()
151 if err != nil {
152 continue
153 }
154 keys[k.Kid] = pub
155 }
156 if len(keys) == 0 {
157 return fmt.Errorf("auth: jwks zonder bruikbare sleutels")
158 }
159 c.mu.Lock()
160 c.keys = keys
161 c.uri = uri
162 c.fetched = time.Now()
163 c.mu.Unlock()
164 return nil
165 }
166
167 type jwk struct {
168 Kty string `json:"kty"`
169 Kid string `json:"kid"`
170 N string `json:"n"`
171 E string `json:"e"`
172 Use string `json:"use"`
173 Alg string `json:"alg"`
174 }
175
176 func (k jwk) rsaPublic() (*rsa.PublicKey, error) {
177 nb, err := b64url(k.N)
178 if err != nil {
179 return nil, err
180 }
181 eb, err := b64url(k.E)
182 if err != nil {
183 return nil, err
184 }
185 var e int
186 if len(eb) < 8 {
187 pad := make([]byte, 8-len(eb))
188 eb = append(pad, eb...)
189 }
190 e = int(binary.BigEndian.Uint64(eb[len(eb)-8:]))
191 if e <= 0 {
192 return nil, fmt.Errorf("ongeldige exponent")
193 }
194 return &rsa.PublicKey{N: new(big.Int).SetBytes(nb), E: e}, nil
195 }
@@ -0,0 +1,195 @@
1package auth
2
3import (
4 "context"
5 "crypto"
6 "crypto/rsa"
7 "crypto/sha256"
8 "encoding/base64"
9 "encoding/binary"
10 "encoding/json"
11 "fmt"
12 "io"
13 "math/big"
14 "net/http"
15 "strings"
16 "sync"
17 "time"
18)
19
20type jwtHeader struct {
21 Alg string `json:"alg"`
22 Kid string `json:"kid"`
23 Typ string `json:"typ"`
24}
25
26// jsonAudience accepteert "aud" als string of als array.
27type jsonAudience []string
28
29func (a *jsonAudience) UnmarshalJSON(b []byte) error {
30 var one string
31 if err := json.Unmarshal(b, &one); err == nil {
32 *a = []string{one}
33 return nil
34 }
35 var many []string
36 if err := json.Unmarshal(b, &many); err != nil {
37 return err
38 }
39 *a = many
40 return nil
41}
42
43func (a jsonAudience) includes(want string) bool {
44 for _, v := range a {
45 if v == want {
46 return true
47 }
48 }
49 return false
50}
51
52func parseJWT(raw string) (jwtHeader, []byte, error) {
53 parts := strings.Split(raw, ".")
54 if len(parts) != 3 {
55 return jwtHeader{}, nil, fmt.Errorf("auth: ongeldig jwt")
56 }
57 hb, err := b64url(parts[0])
58 if err != nil {
59 return jwtHeader{}, nil, fmt.Errorf("auth: jwt-header: %w", err)
60 }
61 var hdr jwtHeader
62 if err := json.Unmarshal(hb, &hdr); err != nil {
63 return jwtHeader{}, nil, fmt.Errorf("auth: jwt-header: %w", err)
64 }
65 pb, err := b64url(parts[1])
66 if err != nil {
67 return jwtHeader{}, nil, fmt.Errorf("auth: jwt-payload: %w", err)
68 }
69 return hdr, pb, nil
70}
71
72func verifyRS256(raw string, key any) error {
73 pub, ok := key.(*rsa.PublicKey)
74 if !ok || pub == nil {
75 return fmt.Errorf("auth: geen rsa-sleutel")
76 }
77 parts := strings.Split(raw, ".")
78 if len(parts) != 3 {
79 return fmt.Errorf("auth: ongeldig jwt")
80 }
81 sig, err := b64url(parts[2])
82 if err != nil {
83 return fmt.Errorf("auth: jwt-handtekening: %w", err)
84 }
85 sum := sha256.Sum256([]byte(parts[0] + "." + parts[1]))
86 if err := rsa.VerifyPKCS1v15(pub, crypto.SHA256, sum[:], sig); err != nil {
87 return fmt.Errorf("auth: jwt-handtekening ongeldig")
88 }
89 return nil
90}
91
92func b64url(s string) ([]byte, error) {
93 return base64.RawURLEncoding.DecodeString(s)
94}
95
96type jwksCache struct {
97 mu sync.Mutex
98 fetched time.Time
99 keys map[string]*rsa.PublicKey
100 uri string
101}
102
103func (c *jwksCache) key(ctx context.Context, httpc *http.Client, uri, kid string) (*rsa.PublicKey, error) {
104 c.mu.Lock()
105 if k := c.keys[kid]; k != nil && c.uri == uri && time.Since(c.fetched) < time.Hour {
106 c.mu.Unlock()
107 return k, nil
108 }
109 c.mu.Unlock()
110 if err := c.refresh(ctx, httpc, uri); err != nil {
111 return nil, err
112 }
113 c.mu.Lock()
114 defer c.mu.Unlock()
115 k := c.keys[kid]
116 if k == nil {
117 return nil, fmt.Errorf("auth: jwks-sleutel %q ontbreekt", kid)
118 }
119 return k, nil
120}
121
122func (c *jwksCache) refresh(ctx context.Context, httpc *http.Client, uri string) error {
123 req, err := http.NewRequestWithContext(ctx, http.MethodGet, uri, nil)
124 if err != nil {
125 return err
126 }
127 res, err := httpc.Do(req)
128 if err != nil {
129 return fmt.Errorf("auth: jwks: %w", err)
130 }
131 defer res.Body.Close()
132 raw, err := io.ReadAll(io.LimitReader(res.Body, 1<<20))
133 if err != nil {
134 return err
135 }
136 if res.StatusCode >= 400 {
137 return fmt.Errorf("auth: jwks %s", res.Status)
138 }
139 var doc struct {
140 Keys []jwk `json:"keys"`
141 }
142 if err := json.Unmarshal(raw, &doc); err != nil {
143 return fmt.Errorf("auth: jwks: %w", err)
144 }
145 keys := make(map[string]*rsa.PublicKey, len(doc.Keys))
146 for _, k := range doc.Keys {
147 if k.Kty != "RSA" || k.Kid == "" || k.N == "" || k.E == "" {
148 continue
149 }
150 pub, err := k.rsaPublic()
151 if err != nil {
152 continue
153 }
154 keys[k.Kid] = pub
155 }
156 if len(keys) == 0 {
157 return fmt.Errorf("auth: jwks zonder bruikbare sleutels")
158 }
159 c.mu.Lock()
160 c.keys = keys
161 c.uri = uri
162 c.fetched = time.Now()
163 c.mu.Unlock()
164 return nil
165}
166
167type jwk struct {
168 Kty string `json:"kty"`
169 Kid string `json:"kid"`
170 N string `json:"n"`
171 E string `json:"e"`
172 Use string `json:"use"`
173 Alg string `json:"alg"`
174}
175
176func (k jwk) rsaPublic() (*rsa.PublicKey, error) {
177 nb, err := b64url(k.N)
178 if err != nil {
179 return nil, err
180 }
181 eb, err := b64url(k.E)
182 if err != nil {
183 return nil, err
184 }
185 var e int
186 if len(eb) < 8 {
187 pad := make([]byte, 8-len(eb))
188 eb = append(pad, eb...)
189 }
190 e = int(binary.BigEndian.Uint64(eb[len(eb)-8:]))
191 if e <= 0 {
192 return nil, fmt.Errorf("ongeldige exponent")
193 }
194 return &rsa.PublicKey{N: new(big.Int).SetBytes(nb), E: e}, nil
195}
internal/auth/pkce.go added +23 −0
@@ -0,0 +1,23 @@
1 package auth
2
3 import (
4 "crypto/rand"
5 "crypto/sha256"
6 "encoding/base64"
7 "fmt"
8 )
9
10 // NewPKCEVerifier maakt een code_verifier (RFC 7636, 43 tekens, unreserved).
11 func NewPKCEVerifier() (string, error) {
12 b := make([]byte, 32)
13 if _, err := rand.Read(b); err != nil {
14 return "", fmt.Errorf("PKCE-verifier: %w", err)
15 }
16 return base64.RawURLEncoding.EncodeToString(b), nil
17 }
18
19 // PKCEChallenge is BASE64URL(SHA256(verifier)), methode S256.
20 func PKCEChallenge(verifier string) string {
21 sum := sha256.Sum256([]byte(verifier))
22 return base64.RawURLEncoding.EncodeToString(sum[:])
23 }
@@ -0,0 +1,23 @@
1package auth
2
3import (
4 "crypto/rand"
5 "crypto/sha256"
6 "encoding/base64"
7 "fmt"
8)
9
10// NewPKCEVerifier maakt een code_verifier (RFC 7636, 43 tekens, unreserved).
11func NewPKCEVerifier() (string, error) {
12 b := make([]byte, 32)
13 if _, err := rand.Read(b); err != nil {
14 return "", fmt.Errorf("PKCE-verifier: %w", err)
15 }
16 return base64.RawURLEncoding.EncodeToString(b), nil
17}
18
19// PKCEChallenge is BASE64URL(SHA256(verifier)), methode S256.
20func PKCEChallenge(verifier string) string {
21 sum := sha256.Sum256([]byte(verifier))
22 return base64.RawURLEncoding.EncodeToString(sum[:])
23}
internal/config/config.go +58 −4
@@ -42,9 +42,9 @@ type Config struct {
42 42 proxies *realip.Set
43 43 }
44 44
45 // Auth wijst naar auth.timfalken.com of naar de lokale ontwikkelmodus.
45 // Auth wijst naar auth.timfalken.com, Microsoft Entra ID, of de lokale ontwikkelmodus.
46 46 type Auth struct {
47 Mode string `yaml:"mode"`
47 Mode string `yaml:"mode"` // oauth | entra | dev
48 48 BaseURL string `yaml:"base_url"`
49 49 ClientID string `yaml:"client_id"`
50 50 ClientSecret string `yaml:"client_secret"`
@@ -53,6 +53,11 @@ type Auth struct {
53 53 UserAgent string `yaml:"user_agent"`
54 54 DevUser string `yaml:"dev_user"`
55 55 DevAuthID int64 `yaml:"dev_auth_id"`
56 // TenantID is verplicht bij mode entra (directory-/tenant-id).
57 TenantID string `yaml:"tenant_id"`
58 // Issuer overschrijft de Entra-issuer. Leeg: login.microsoftonline.com/{tenant}/v2.0.
59 // Voor tests of andere clouds (bijv. login.microsoftonline.us).
60 Issuer string `yaml:"issuer"`
56 61 }
57 62
58 63 // Git wijst naar de git-binary en de standaardbranch van nieuwe repositories.
@@ -173,7 +178,8 @@ func (c *Config) applyDefaults() {
173 178 if c.Auth.Mode == "" {
174 179 c.Auth.Mode = "oauth"
175 180 }
176 if c.Auth.BaseURL == "" {
181 // base_url hoort bij oauth (auth.timfalken.com). Entra gebruikt issuer/tenant.
182 if c.Auth.Mode == "oauth" && c.Auth.BaseURL == "" {
177 183 c.Auth.BaseURL = "https://auth.timfalken.com"
178 184 }
179 185 if c.Auth.RedirectPath == "" {
@@ -215,6 +221,8 @@ func (c *Config) applyDefaults() {
215 221 c.Runner.Name = strings.TrimSpace(c.Runner.Name)
216 222 }
217 223 c.Auth.BaseURL = strings.TrimRight(c.Auth.BaseURL, "/")
224 c.Auth.Issuer = strings.TrimRight(strings.TrimSpace(c.Auth.Issuer), "/")
225 c.Auth.TenantID = strings.TrimSpace(c.Auth.TenantID)
218 226 c.BaseURL = strings.TrimRight(c.BaseURL, "/")
219 227 }
220 228
@@ -241,12 +249,24 @@ func (c *Config) Validate() error {
241 249 if c.Auth.BaseURL == "" {
242 250 return fmt.Errorf("auth.base_url ontbreekt")
243 251 }
252 case "entra":
253 if c.Auth.TenantID == "" {
254 return fmt.Errorf("entra vereist auth.tenant_id")
255 }
256 if c.Auth.ClientID == "" || c.Auth.ClientSecret == "" {
257 return fmt.Errorf("entra vereist auth.client_id en een clientgeheim (veld, bestand of BLUEGIT_AUTH_CLIENT_SECRET)")
258 }
259 if c.Auth.Issuer != "" {
260 if err := validateIssuer(c.Auth.Issuer); err != nil {
261 return err
262 }
263 }
244 264 case "dev":
245 265 if strings.EqualFold(u.Hostname(), "git.timfalken.com") {
246 266 return fmt.Errorf("auth.mode dev is geweigerd voor git.timfalken.com")
247 267 }
248 268 default:
249 return fmt.Errorf("auth.mode moet oauth of dev zijn")
269 return fmt.Errorf("auth.mode moet oauth, entra of dev zijn")
250 270 }
251 271 if c.BehindProxy {
252 272 return fmt.Errorf("behind_proxy doet niets meer; zet trusted_proxies op het IP of CIDR van de ingress en haal behind_proxy weg")
@@ -329,6 +349,34 @@ func (c Config) RedirectURI() string {
329 349 return c.BaseURL + c.Auth.RedirectPath
330 350 }
331 351
352 // validateIssuer eist een absolute URL. HTTP is alleen toegestaan op localhost.
353 func validateIssuer(issuer string) error {
354 iu, err := url.Parse(issuer)
355 if err != nil || (iu.Scheme != "https" && iu.Scheme != "http") || iu.Host == "" {
356 return fmt.Errorf("auth.issuer moet een absolute http(s)-URL zijn")
357 }
358 if iu.Scheme != "https" && !issuerLoopback(iu.Hostname()) {
359 return fmt.Errorf("auth.issuer moet HTTPS zijn (HTTP alleen op localhost)")
360 }
361 return nil
362 }
363
364 func issuerLoopback(host string) bool {
365 if strings.EqualFold(host, "localhost") {
366 return true
367 }
368 ip := net.ParseIP(host)
369 return ip != nil && ip.IsLoopback()
370 }
371
372 // EntraIssuer is de OIDC-issuer voor mode entra.
373 func (c Config) EntraIssuer() string {
374 if c.Auth.Issuer != "" {
375 return c.Auth.Issuer
376 }
377 return "https://login.microsoftonline.com/" + c.Auth.TenantID + "/v2.0"
378 }
379
332 380 // Example is een startconfiguratie voor de mini-PC.
333 381 func Example() string {
334 382 return `# BlueGit op de mini-PC. Kopieer naar /etc/bluegit/config.yml.
@@ -354,6 +402,12 @@ auth:
354 402 client_secret_file: /etc/bluegit/client_secret
355 403 redirect_path: /auth/callback
356 404 user_agent: BlueGitAccountClient/0.1
405 # Alternatief: Microsoft Entra ID (OIDC, één tenant). Zet mode op entra
406 # en vul tenant_id + client_id; geheim hetzelfde als hierboven.
407 # mode: entra
408 # tenant_id: 00000000-0000-0000-0000-000000000000
409 # client_id: 11111111-1111-1111-1111-111111111111
410 # issuer blijft leeg, tenzij je een andere cloud of testissuer nodig hebt.
357 411
358 412 git:
359 413 binary: git
@@ -42,9 +42,9 @@ type Config struct {
42 proxies *realip.Set
42 proxies *realip.Set
43}
43}
44
44
45// Auth wijst naar auth.timfalken.com of naar de lokale ontwikkelmodus.
45// Auth wijst naar auth.timfalken.com, Microsoft Entra ID, of de lokale ontwikkelmodus.
46type Auth struct {
46type Auth struct {
47 Mode string `yaml:"mode"`
47 Mode string `yaml:"mode"` // oauth | entra | dev
48 BaseURL string `yaml:"base_url"`
48 BaseURL string `yaml:"base_url"`
49 ClientID string `yaml:"client_id"`
49 ClientID string `yaml:"client_id"`
50 ClientSecret string `yaml:"client_secret"`
50 ClientSecret string `yaml:"client_secret"`
@@ -53,6 +53,11 @@ type Auth struct {
53 UserAgent string `yaml:"user_agent"`
53 UserAgent string `yaml:"user_agent"`
54 DevUser string `yaml:"dev_user"`
54 DevUser string `yaml:"dev_user"`
55 DevAuthID int64 `yaml:"dev_auth_id"`
55 DevAuthID int64 `yaml:"dev_auth_id"`
56 // TenantID is verplicht bij mode entra (directory-/tenant-id).
57 TenantID string `yaml:"tenant_id"`
58 // Issuer overschrijft de Entra-issuer. Leeg: login.microsoftonline.com/{tenant}/v2.0.
59 // Voor tests of andere clouds (bijv. login.microsoftonline.us).
60 Issuer string `yaml:"issuer"`
56}
61}
57
62
58// Git wijst naar de git-binary en de standaardbranch van nieuwe repositories.
63// Git wijst naar de git-binary en de standaardbranch van nieuwe repositories.
@@ -173,7 +178,8 @@ func (c *Config) applyDefaults() {
173 if c.Auth.Mode == "" {
178 if c.Auth.Mode == "" {
174 c.Auth.Mode = "oauth"
179 c.Auth.Mode = "oauth"
175 }
180 }
176 if c.Auth.BaseURL == "" {
181 // base_url hoort bij oauth (auth.timfalken.com). Entra gebruikt issuer/tenant.
182 if c.Auth.Mode == "oauth" && c.Auth.BaseURL == "" {
177 c.Auth.BaseURL = "https://auth.timfalken.com"
183 c.Auth.BaseURL = "https://auth.timfalken.com"
178 }
184 }
179 if c.Auth.RedirectPath == "" {
185 if c.Auth.RedirectPath == "" {
@@ -215,6 +221,8 @@ func (c *Config) applyDefaults() {
215 c.Runner.Name = strings.TrimSpace(c.Runner.Name)
221 c.Runner.Name = strings.TrimSpace(c.Runner.Name)
216 }
222 }
217 c.Auth.BaseURL = strings.TrimRight(c.Auth.BaseURL, "/")
223 c.Auth.BaseURL = strings.TrimRight(c.Auth.BaseURL, "/")
224 c.Auth.Issuer = strings.TrimRight(strings.TrimSpace(c.Auth.Issuer), "/")
225 c.Auth.TenantID = strings.TrimSpace(c.Auth.TenantID)
218 c.BaseURL = strings.TrimRight(c.BaseURL, "/")
226 c.BaseURL = strings.TrimRight(c.BaseURL, "/")
219}
227}
220
228
@@ -241,12 +249,24 @@ func (c *Config) Validate() error {
241 if c.Auth.BaseURL == "" {
249 if c.Auth.BaseURL == "" {
242 return fmt.Errorf("auth.base_url ontbreekt")
250 return fmt.Errorf("auth.base_url ontbreekt")
243 }
251 }
252 case "entra":
253 if c.Auth.TenantID == "" {
254 return fmt.Errorf("entra vereist auth.tenant_id")
255 }
256 if c.Auth.ClientID == "" || c.Auth.ClientSecret == "" {
257 return fmt.Errorf("entra vereist auth.client_id en een clientgeheim (veld, bestand of BLUEGIT_AUTH_CLIENT_SECRET)")
258 }
259 if c.Auth.Issuer != "" {
260 if err := validateIssuer(c.Auth.Issuer); err != nil {
261 return err
262 }
263 }
244 case "dev":
264 case "dev":
245 if strings.EqualFold(u.Hostname(), "git.timfalken.com") {
265 if strings.EqualFold(u.Hostname(), "git.timfalken.com") {
246 return fmt.Errorf("auth.mode dev is geweigerd voor git.timfalken.com")
266 return fmt.Errorf("auth.mode dev is geweigerd voor git.timfalken.com")
247 }
267 }
248 default:
268 default:
249 return fmt.Errorf("auth.mode moet oauth of dev zijn")
269 return fmt.Errorf("auth.mode moet oauth, entra of dev zijn")
250 }
270 }
251 if c.BehindProxy {
271 if c.BehindProxy {
252 return fmt.Errorf("behind_proxy doet niets meer; zet trusted_proxies op het IP of CIDR van de ingress en haal behind_proxy weg")
272 return fmt.Errorf("behind_proxy doet niets meer; zet trusted_proxies op het IP of CIDR van de ingress en haal behind_proxy weg")
@@ -329,6 +349,34 @@ func (c Config) RedirectURI() string {
329 return c.BaseURL + c.Auth.RedirectPath
349 return c.BaseURL + c.Auth.RedirectPath
330}
350}
331
351
352// validateIssuer eist een absolute URL. HTTP is alleen toegestaan op localhost.
353func validateIssuer(issuer string) error {
354 iu, err := url.Parse(issuer)
355 if err != nil || (iu.Scheme != "https" && iu.Scheme != "http") || iu.Host == "" {
356 return fmt.Errorf("auth.issuer moet een absolute http(s)-URL zijn")
357 }
358 if iu.Scheme != "https" && !issuerLoopback(iu.Hostname()) {
359 return fmt.Errorf("auth.issuer moet HTTPS zijn (HTTP alleen op localhost)")
360 }
361 return nil
362}
363
364func issuerLoopback(host string) bool {
365 if strings.EqualFold(host, "localhost") {
366 return true
367 }
368 ip := net.ParseIP(host)
369 return ip != nil && ip.IsLoopback()
370}
371
372// EntraIssuer is de OIDC-issuer voor mode entra.
373func (c Config) EntraIssuer() string {
374 if c.Auth.Issuer != "" {
375 return c.Auth.Issuer
376 }
377 return "https://login.microsoftonline.com/" + c.Auth.TenantID + "/v2.0"
378}
379
332// Example is een startconfiguratie voor de mini-PC.
380// Example is een startconfiguratie voor de mini-PC.
333func Example() string {
381func Example() string {
334 return `# BlueGit op de mini-PC. Kopieer naar /etc/bluegit/config.yml.
382 return `# BlueGit op de mini-PC. Kopieer naar /etc/bluegit/config.yml.
@@ -354,6 +402,12 @@ auth:
354 client_secret_file: /etc/bluegit/client_secret
402 client_secret_file: /etc/bluegit/client_secret
355 redirect_path: /auth/callback
403 redirect_path: /auth/callback
356 user_agent: BlueGitAccountClient/0.1
404 user_agent: BlueGitAccountClient/0.1
405 # Alternatief: Microsoft Entra ID (OIDC, één tenant). Zet mode op entra
406 # en vul tenant_id + client_id; geheim hetzelfde als hierboven.
407 # mode: entra
408 # tenant_id: 00000000-0000-0000-0000-000000000000
409 # client_id: 11111111-1111-1111-1111-111111111111
410 # issuer blijft leeg, tenzij je een andere cloud of testissuer nodig hebt.
357
411
358git:
412git:
359 binary: git
413 binary: git
internal/config/config_test.go +138 −0
@@ -102,6 +102,144 @@ func TestDevModeRefusedOnProductionHost(t *testing.T) {
102 102 }
103 103 }
104 104
105 func TestOAuthDefaultsUnchanged(t *testing.T) {
106 dir := t.TempDir()
107 path := filepath.Join(dir, "config.yml")
108 body := []byte("base_url: https://git.example.test\nauth:\n mode: oauth\n client_id: git.example.test\n")
109 if err := os.WriteFile(path, body, 0o600); err != nil {
110 t.Fatal(err)
111 }
112 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
113 cfg, err := Load(path)
114 if err != nil {
115 t.Fatal(err)
116 }
117 if cfg.Auth.Mode != "oauth" || cfg.Auth.BaseURL != "https://auth.timfalken.com" {
118 t.Fatalf("%+v", cfg.Auth)
119 }
120 if cfg.Auth.RedirectPath != "/auth/callback" || cfg.Auth.UserAgent != "BlueGitAccountClient/0.1" {
121 t.Fatalf("%+v", cfg.Auth)
122 }
123 if cfg.Auth.TenantID != "" || cfg.Auth.Issuer != "" {
124 t.Fatalf("entra-velden horen leeg: %+v", cfg.Auth)
125 }
126 }
127
128 func TestEntraConfig(t *testing.T) {
129 dir := t.TempDir()
130 path := filepath.Join(dir, "config.yml")
131 body := []byte(`base_url: https://git.example.test
132 auth:
133 mode: entra
134 tenant_id: 00000000-0000-0000-0000-000000000001
135 client_id: 11111111-1111-1111-1111-111111111111
136 `)
137 if err := os.WriteFile(path, body, 0o600); err != nil {
138 t.Fatal(err)
139 }
140 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "entra-geheim")
141 cfg, err := Load(path)
142 if err != nil {
143 t.Fatal(err)
144 }
145 if cfg.Auth.BaseURL != "" {
146 t.Fatalf("entra zet geen auth.timfalken-default, kreeg %q", cfg.Auth.BaseURL)
147 }
148 if cfg.EntraIssuer() != "https://login.microsoftonline.com/00000000-0000-0000-0000-000000000001/v2.0" {
149 t.Fatal(cfg.EntraIssuer())
150 }
151 if cfg.Auth.ClientSecret != "entra-geheim" || cfg.RedirectURI() != "https://git.example.test/auth/callback" {
152 t.Fatalf("%+v", cfg.Auth)
153 }
154
155 body = []byte(`base_url: https://git.example.test
156 auth:
157 mode: entra
158 tenant_id: 00000000-0000-0000-0000-000000000001
159 client_id: 11111111-1111-1111-1111-111111111111
160 issuer: https://login.test.example/t/v2.0
161 `)
162 if err := os.WriteFile(path, body, 0o600); err != nil {
163 t.Fatal(err)
164 }
165 cfg, err = Load(path)
166 if err != nil {
167 t.Fatal(err)
168 }
169 if cfg.EntraIssuer() != "https://login.test.example/t/v2.0" {
170 t.Fatal(cfg.EntraIssuer())
171 }
172 }
173
174 func TestEntraValidation(t *testing.T) {
175 dir := t.TempDir()
176 path := filepath.Join(dir, "config.yml")
177 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
178 cases := []struct {
179 body string
180 want string
181 }{
182 {
183 body: "base_url: https://git.example.test\nauth:\n mode: entra\n client_id: app\n",
184 want: "tenant_id",
185 },
186 {
187 body: "base_url: https://git.example.test\nauth:\n mode: entra\n tenant_id: t1\n",
188 want: "client_id",
189 },
190 {
191 body: "base_url: https://git.example.test\nauth:\n mode: entra\n tenant_id: t1\n client_id: app\n issuer: niet-een-url\n",
192 want: "issuer",
193 },
194 {
195 body: "base_url: https://git.example.test\nauth:\n mode: entra\n tenant_id: t1\n client_id: app\n issuer: http://login.microsoftonline.com/t/v2.0\n",
196 want: "HTTPS",
197 },
198 }
199 for _, tc := range cases {
200 if err := os.WriteFile(path, []byte(tc.body), 0o600); err != nil {
201 t.Fatal(err)
202 }
203 _, err := Load(path)
204 if err == nil || !strings.Contains(err.Error(), tc.want) {
205 t.Fatalf("body %q: verwacht %q, kreeg %v", tc.body, tc.want, err)
206 }
207 }
208 // Zonder geheim:zelfde fouttekst als oauth.
209 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "")
210 body := []byte("base_url: https://git.example.test\nauth:\n mode: entra\n tenant_id: t1\n client_id: app\n")
211 if err := os.WriteFile(path, body, 0o600); err != nil {
212 t.Fatal(err)
213 }
214 _, err := Load(path)
215 if err == nil || !strings.Contains(err.Error(), "clientgeheim") {
216 t.Fatalf("verwacht clientgeheim-fout, kreeg %v", err)
217 }
218 }
219
220 func TestEntraIssuerHTTPLoopback(t *testing.T) {
221 dir := t.TempDir()
222 path := filepath.Join(dir, "config.yml")
223 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
224 body := []byte(`base_url: https://git.example.test
225 auth:
226 mode: entra
227 tenant_id: t1
228 client_id: app
229 issuer: http://127.0.0.1:8081/t/v2.0
230 `)
231 if err := os.WriteFile(path, body, 0o600); err != nil {
232 t.Fatal(err)
233 }
234 cfg, err := Load(path)
235 if err != nil {
236 t.Fatal(err)
237 }
238 if cfg.EntraIssuer() != "http://127.0.0.1:8081/t/v2.0" {
239 t.Fatal(cfg.EntraIssuer())
240 }
241 }
242
105 243 func TestSecretFromEnv(t *testing.T) {
106 244 dir := t.TempDir()
107 245 path := filepath.Join(dir, "config.yml")
@@ -102,6 +102,144 @@ func TestDevModeRefusedOnProductionHost(t *testing.T) {
102 }
102 }
103}
103}
104
104
105func TestOAuthDefaultsUnchanged(t *testing.T) {
106 dir := t.TempDir()
107 path := filepath.Join(dir, "config.yml")
108 body := []byte("base_url: https://git.example.test\nauth:\n mode: oauth\n client_id: git.example.test\n")
109 if err := os.WriteFile(path, body, 0o600); err != nil {
110 t.Fatal(err)
111 }
112 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
113 cfg, err := Load(path)
114 if err != nil {
115 t.Fatal(err)
116 }
117 if cfg.Auth.Mode != "oauth" || cfg.Auth.BaseURL != "https://auth.timfalken.com" {
118 t.Fatalf("%+v", cfg.Auth)
119 }
120 if cfg.Auth.RedirectPath != "/auth/callback" || cfg.Auth.UserAgent != "BlueGitAccountClient/0.1" {
121 t.Fatalf("%+v", cfg.Auth)
122 }
123 if cfg.Auth.TenantID != "" || cfg.Auth.Issuer != "" {
124 t.Fatalf("entra-velden horen leeg: %+v", cfg.Auth)
125 }
126}
127
128func TestEntraConfig(t *testing.T) {
129 dir := t.TempDir()
130 path := filepath.Join(dir, "config.yml")
131 body := []byte(`base_url: https://git.example.test
132auth:
133 mode: entra
134 tenant_id: 00000000-0000-0000-0000-000000000001
135 client_id: 11111111-1111-1111-1111-111111111111
136`)
137 if err := os.WriteFile(path, body, 0o600); err != nil {
138 t.Fatal(err)
139 }
140 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "entra-geheim")
141 cfg, err := Load(path)
142 if err != nil {
143 t.Fatal(err)
144 }
145 if cfg.Auth.BaseURL != "" {
146 t.Fatalf("entra zet geen auth.timfalken-default, kreeg %q", cfg.Auth.BaseURL)
147 }
148 if cfg.EntraIssuer() != "https://login.microsoftonline.com/00000000-0000-0000-0000-000000000001/v2.0" {
149 t.Fatal(cfg.EntraIssuer())
150 }
151 if cfg.Auth.ClientSecret != "entra-geheim" || cfg.RedirectURI() != "https://git.example.test/auth/callback" {
152 t.Fatalf("%+v", cfg.Auth)
153 }
154
155 body = []byte(`base_url: https://git.example.test
156auth:
157 mode: entra
158 tenant_id: 00000000-0000-0000-0000-000000000001
159 client_id: 11111111-1111-1111-1111-111111111111
160 issuer: https://login.test.example/t/v2.0
161`)
162 if err := os.WriteFile(path, body, 0o600); err != nil {
163 t.Fatal(err)
164 }
165 cfg, err = Load(path)
166 if err != nil {
167 t.Fatal(err)
168 }
169 if cfg.EntraIssuer() != "https://login.test.example/t/v2.0" {
170 t.Fatal(cfg.EntraIssuer())
171 }
172}
173
174func TestEntraValidation(t *testing.T) {
175 dir := t.TempDir()
176 path := filepath.Join(dir, "config.yml")
177 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
178 cases := []struct {
179 body string
180 want string
181 }{
182 {
183 body: "base_url: https://git.example.test\nauth:\n mode: entra\n client_id: app\n",
184 want: "tenant_id",
185 },
186 {
187 body: "base_url: https://git.example.test\nauth:\n mode: entra\n tenant_id: t1\n",
188 want: "client_id",
189 },
190 {
191 body: "base_url: https://git.example.test\nauth:\n mode: entra\n tenant_id: t1\n client_id: app\n issuer: niet-een-url\n",
192 want: "issuer",
193 },
194 {
195 body: "base_url: https://git.example.test\nauth:\n mode: entra\n tenant_id: t1\n client_id: app\n issuer: http://login.microsoftonline.com/t/v2.0\n",
196 want: "HTTPS",
197 },
198 }
199 for _, tc := range cases {
200 if err := os.WriteFile(path, []byte(tc.body), 0o600); err != nil {
201 t.Fatal(err)
202 }
203 _, err := Load(path)
204 if err == nil || !strings.Contains(err.Error(), tc.want) {
205 t.Fatalf("body %q: verwacht %q, kreeg %v", tc.body, tc.want, err)
206 }
207 }
208 // Zonder geheim:zelfde fouttekst als oauth.
209 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "")
210 body := []byte("base_url: https://git.example.test\nauth:\n mode: entra\n tenant_id: t1\n client_id: app\n")
211 if err := os.WriteFile(path, body, 0o600); err != nil {
212 t.Fatal(err)
213 }
214 _, err := Load(path)
215 if err == nil || !strings.Contains(err.Error(), "clientgeheim") {
216 t.Fatalf("verwacht clientgeheim-fout, kreeg %v", err)
217 }
218}
219
220func TestEntraIssuerHTTPLoopback(t *testing.T) {
221 dir := t.TempDir()
222 path := filepath.Join(dir, "config.yml")
223 t.Setenv("BLUEGIT_AUTH_CLIENT_SECRET", "geheim")
224 body := []byte(`base_url: https://git.example.test
225auth:
226 mode: entra
227 tenant_id: t1
228 client_id: app
229 issuer: http://127.0.0.1:8081/t/v2.0
230`)
231 if err := os.WriteFile(path, body, 0o600); err != nil {
232 t.Fatal(err)
233 }
234 cfg, err := Load(path)
235 if err != nil {
236 t.Fatal(err)
237 }
238 if cfg.EntraIssuer() != "http://127.0.0.1:8081/t/v2.0" {
239 t.Fatal(cfg.EntraIssuer())
240 }
241}
242
105func TestSecretFromEnv(t *testing.T) {
243func TestSecretFromEnv(t *testing.T) {
106 dir := t.TempDir()
244 dir := t.TempDir()
107 path := filepath.Join(dir, "config.yml")
245 path := filepath.Join(dir, "config.yml")
internal/server/auth_handlers.go +34 −3
@@ -7,6 +7,7 @@ import (
7 7 "strings"
8 8 "time"
9 9
10 "gitlab.com/Timfa/bluegit/internal/auth"
10 11 "gitlab.com/Timfa/bluegit/internal/store"
11 12 )
12 13
@@ -16,7 +17,7 @@ func (s *Server) login(w http.ResponseWriter, r *http.Request) {
16 17 return
17 18 }
18 19 if s.Dev {
19 id, err := s.Auth.Exchange(r.Context(), "dev", s.Cfg.RedirectURI())
20 id, err := s.Auth.Exchange(r.Context(), "dev", s.Cfg.RedirectURI(), "", "")
20 21 if err != nil {
21 22 http.Error(w, err.Error(), http.StatusBadGateway)
22 23 return
@@ -29,12 +30,30 @@ func (s *Server) login(w http.ResponseWriter, r *http.Request) {
29 30 http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)
30 31 return
31 32 }
33 nonce, err := randomState()
34 if err != nil {
35 http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)
36 return
37 }
38 verifier, err := auth.NewPKCEVerifier()
39 if err != nil {
40 http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)
41 return
42 }
32 43 secure := strings.HasPrefix(s.Cfg.BaseURL, "https://")
33 44 http.SetCookie(w, &http.Cookie{
34 45 Name: "bluegit_oauth_state", Value: state, Path: "/", MaxAge: 600,
35 46 HttpOnly: true, Secure: secure, SameSite: http.SameSiteLaxMode,
36 47 })
37 http.Redirect(w, r, s.Auth.AuthorizeURL(state, s.Cfg.RedirectURI()), http.StatusFound)
48 http.SetCookie(w, &http.Cookie{
49 Name: "bluegit_oauth_nonce", Value: nonce, Path: "/", MaxAge: 600,
50 HttpOnly: true, Secure: secure, SameSite: http.SameSiteLaxMode,
51 })
52 http.SetCookie(w, &http.Cookie{
53 Name: "bluegit_oauth_pkce", Value: verifier, Path: "/", MaxAge: 600,
54 HttpOnly: true, Secure: secure, SameSite: http.SameSiteLaxMode,
55 })
56 http.Redirect(w, r, s.Auth.AuthorizeURL(state, nonce, s.Cfg.RedirectURI(), auth.PKCEChallenge(verifier)), http.StatusFound)
38 57 }
39 58
40 59 func (s *Server) callback(w http.ResponseWriter, r *http.Request) {
@@ -51,8 +70,20 @@ func (s *Server) callback(w http.ResponseWriter, r *http.Request) {
51 70 http.Error(w, s.tr(r, "err.oauthState"), http.StatusBadRequest)
52 71 return
53 72 }
73 nonceCookie, err := r.Cookie("bluegit_oauth_nonce")
74 nonce := ""
75 if err == nil {
76 nonce = nonceCookie.Value
77 }
78 pkceCookie, err := r.Cookie("bluegit_oauth_pkce")
79 verifier := ""
80 if err == nil {
81 verifier = pkceCookie.Value
82 }
54 83 http.SetCookie(w, &http.Cookie{Name: "bluegit_oauth_state", Value: "", Path: "/", MaxAge: -1})
55 id, err := s.Auth.Exchange(r.Context(), r.URL.Query().Get("code"), s.Cfg.RedirectURI())
84 http.SetCookie(w, &http.Cookie{Name: "bluegit_oauth_nonce", Value: "", Path: "/", MaxAge: -1})
85 http.SetCookie(w, &http.Cookie{Name: "bluegit_oauth_pkce", Value: "", Path: "/", MaxAge: -1})
86 id, err := s.Auth.Exchange(r.Context(), r.URL.Query().Get("code"), s.Cfg.RedirectURI(), nonce, verifier)
56 87 if err != nil {
57 88 s.Log.Error("oauth", "err", err)
58 89 s.redirect(w, r, "/", "", s.tr(r, "err.oauthFail"))
@@ -7,6 +7,7 @@ import (
7 "strings"
7 "strings"
8 "time"
8 "time"
9
9
10 "gitlab.com/Timfa/bluegit/internal/auth"
10 "gitlab.com/Timfa/bluegit/internal/store"
11 "gitlab.com/Timfa/bluegit/internal/store"
11)
12)
12
13
@@ -16,7 +17,7 @@ func (s *Server) login(w http.ResponseWriter, r *http.Request) {
16 return
17 return
17 }
18 }
18 if s.Dev {
19 if s.Dev {
19 id, err := s.Auth.Exchange(r.Context(), "dev", s.Cfg.RedirectURI())
20 id, err := s.Auth.Exchange(r.Context(), "dev", s.Cfg.RedirectURI(), "", "")
20 if err != nil {
21 if err != nil {
21 http.Error(w, err.Error(), http.StatusBadGateway)
22 http.Error(w, err.Error(), http.StatusBadGateway)
22 return
23 return
@@ -29,12 +30,30 @@ func (s *Server) login(w http.ResponseWriter, r *http.Request) {
29 http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)
30 http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)
30 return
31 return
31 }
32 }
33 nonce, err := randomState()
34 if err != nil {
35 http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)
36 return
37 }
38 verifier, err := auth.NewPKCEVerifier()
39 if err != nil {
40 http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)
41 return
42 }
32 secure := strings.HasPrefix(s.Cfg.BaseURL, "https://")
43 secure := strings.HasPrefix(s.Cfg.BaseURL, "https://")
33 http.SetCookie(w, &http.Cookie{
44 http.SetCookie(w, &http.Cookie{
34 Name: "bluegit_oauth_state", Value: state, Path: "/", MaxAge: 600,
45 Name: "bluegit_oauth_state", Value: state, Path: "/", MaxAge: 600,
35 HttpOnly: true, Secure: secure, SameSite: http.SameSiteLaxMode,
46 HttpOnly: true, Secure: secure, SameSite: http.SameSiteLaxMode,
36 })
47 })
37 http.Redirect(w, r, s.Auth.AuthorizeURL(state, s.Cfg.RedirectURI()), http.StatusFound)
48 http.SetCookie(w, &http.Cookie{
49 Name: "bluegit_oauth_nonce", Value: nonce, Path: "/", MaxAge: 600,
50 HttpOnly: true, Secure: secure, SameSite: http.SameSiteLaxMode,
51 })
52 http.SetCookie(w, &http.Cookie{
53 Name: "bluegit_oauth_pkce", Value: verifier, Path: "/", MaxAge: 600,
54 HttpOnly: true, Secure: secure, SameSite: http.SameSiteLaxMode,
55 })
56 http.Redirect(w, r, s.Auth.AuthorizeURL(state, nonce, s.Cfg.RedirectURI(), auth.PKCEChallenge(verifier)), http.StatusFound)
38}
57}
39
58
40func (s *Server) callback(w http.ResponseWriter, r *http.Request) {
59func (s *Server) callback(w http.ResponseWriter, r *http.Request) {
@@ -51,8 +70,20 @@ func (s *Server) callback(w http.ResponseWriter, r *http.Request) {
51 http.Error(w, s.tr(r, "err.oauthState"), http.StatusBadRequest)
70 http.Error(w, s.tr(r, "err.oauthState"), http.StatusBadRequest)
52 return
71 return
53 }
72 }
73 nonceCookie, err := r.Cookie("bluegit_oauth_nonce")
74 nonce := ""
75 if err == nil {
76 nonce = nonceCookie.Value
77 }
78 pkceCookie, err := r.Cookie("bluegit_oauth_pkce")
79 verifier := ""
80 if err == nil {
81 verifier = pkceCookie.Value
82 }
54 http.SetCookie(w, &http.Cookie{Name: "bluegit_oauth_state", Value: "", Path: "/", MaxAge: -1})
83 http.SetCookie(w, &http.Cookie{Name: "bluegit_oauth_state", Value: "", Path: "/", MaxAge: -1})
55 id, err := s.Auth.Exchange(r.Context(), r.URL.Query().Get("code"), s.Cfg.RedirectURI())
84 http.SetCookie(w, &http.Cookie{Name: "bluegit_oauth_nonce", Value: "", Path: "/", MaxAge: -1})
85 http.SetCookie(w, &http.Cookie{Name: "bluegit_oauth_pkce", Value: "", Path: "/", MaxAge: -1})
86 id, err := s.Auth.Exchange(r.Context(), r.URL.Query().Get("code"), s.Cfg.RedirectURI(), nonce, verifier)
56 if err != nil {
87 if err != nil {
57 s.Log.Error("oauth", "err", err)
88 s.Log.Error("oauth", "err", err)
58 s.redirect(w, r, "/", "", s.tr(r, "err.oauthFail"))
89 s.redirect(w, r, "/", "", s.tr(r, "err.oauthFail"))
packaging/bluegit.yml +4 −0
@@ -23,6 +23,10 @@ auth:
23 23 client_secret_file: /etc/bluegit/client_secret
24 24 redirect_path: /auth/callback
25 25 user_agent: BlueGitAccountClient/0.1
26 # Alternatief: Microsoft Entra ID (OIDC, één tenant). Zie docs/AUTH.md.
27 # mode: entra
28 # tenant_id: 00000000-0000-0000-0000-000000000000
29 # client_id: 11111111-1111-1111-1111-111111111111
26 30
27 31 git:
28 32 binary: git
@@ -23,6 +23,10 @@ auth:
23 client_secret_file: /etc/bluegit/client_secret
23 client_secret_file: /etc/bluegit/client_secret
24 redirect_path: /auth/callback
24 redirect_path: /auth/callback
25 user_agent: BlueGitAccountClient/0.1
25 user_agent: BlueGitAccountClient/0.1
26 # Alternatief: Microsoft Entra ID (OIDC, één tenant). Zie docs/AUTH.md.
27 # mode: entra
28 # tenant_id: 00000000-0000-0000-0000-000000000000
29 # client_id: 11111111-1111-1111-1111-111111111111
26
30
27git:
31git:
28 binary: git
32 binary: git