Merge branch 'cursor/entra-login' into stage
Microsoft Entra ID-aanmelden, inclusief PKCE, tokencontroles en instel-docs.
@@ -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
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.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
Het logo is de blauwe ster: [`assets/logo.svg`](assets/logo.svg).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/b42
42
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).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 ID46
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
```yaml59
auth:60
mode: entra61
tenant_id: # Directory (tenant) ID62
client_id: # Application (client) ID63
client_secret_file: /etc/bluegit/client_secret64
redirect_path: /auth/callback65
# issuer alleen voor een andere cloud of een test; leeg =66
# https://login.microsoftonline.com/{tenant_id}/v2.067
```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
## Lokaal81
## Lokaal46
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.git74
## Documentatie110
## Documentatie75
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.@@ -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.Provider93
var provider auth.Provider94
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)@@ -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.com1
# Aanmelden: auth.timfalken.com of Microsoft Entra ID2
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
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.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 doen9
### Wat een site moet doen6
10
7
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.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
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.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_sec25
29
26
BlueGit stuurt op elk server-naar-server-verzoek `User-Agent: BlueGitAccountClient/0.1` en `Accept: application/json`.30
BlueGit stuurt op elk server-naar-server-verzoek `User-Agent: BlueGitAccountClient/0.1` en `Accept: application/json`.27
31
28
## Wat BlueGit bewaart32
### Configuratie (oauth)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
## Configuratie35
33
36
```yaml34
```yaml37
auth:35
auth:@@ -45,7 +43,78 @@ auth:45
43
46
Een leeg `client_secret` valt terug op het bestand, en dat weer op `BLUEGIT_AUTH_CLIENT_SECRET`.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-registratie53
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
```yaml64
auth:65
mode: entra66
tenant_id: 00000000-0000-0000-0000-00000000000067
client_id: 11111111-1111-1111-1111-11111111111168
client_secret: ""69
client_secret_file: /etc/bluegit/client_secret70
redirect_path: /auth/callback71
# issuer alleen zetten voor een andere cloud of een testissuer.72
# Leeg = https://login.microsoftonline.com/{tenant_id}/v2.073
# issuer: https://login.microsoftonline.com/00000000-0000-0000-0000-000000000000/v2.074
```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-gebruiker83
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 fouten96
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 Entra103
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 bewaart110
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-modus116
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
## Export119
## Export51
120
@@ -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); optioneel3
// 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.5
package auth5
package auth6
6
7
import (7
import (@@ -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.30
type Provider interface {32
type Provider interface {31
AuthorizeURL(state, redirectURI string) string33
AuthorizeURL(state, nonce, redirectURI, codeChallenge string) string32
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) error36
Logout(ctx context.Context, accessToken string) error35
}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.58
func (t *TimFalken) AuthorizeURL(state, redirectURI string) string {60
func (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
_ = nonce67
_ = codeChallenge64
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.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
_ = nonce74
_ = codeVerifier69
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)@@ -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
}@@ -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.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
// Exchange bestaat zodat de interface klopt. Dev-login gebruikt hem niet.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
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
}@@ -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 @@1
package auth2
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.Second23
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 string28
TenantID string29
ClientID string30
Secret string31
UserAgent string32
HTTP *http.Client33
34
mu sync.Mutex35
authz string36
token string37
jwks *jwksCache38
jwksURI string39
}40
41
// NewEntra maakt een OIDC-client. issuer is zonder slash aan het eind42
// (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{}, err89
}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{}, err101
}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{}, err116
}117
if body.Error != "" || body.IDToken == "" {118
msg := body.Error119
if body.ErrorDesc != "" {120
msg = body.ErrorDesc121
}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{}, err130
}131
oid := claims.OID132
if oid == "" {133
oid = claims.Sub134
}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{}, err141
}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
}, nil150
}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, nil155
}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 nil160
}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{}, err181
}182
var claims idClaims183
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{}, err214
}215
if err := verifyRS256(raw, key); err != nil {216
return idClaims{}, err217
}218
return claims, nil219
}220
221
func (e *Entra) signingKey(ctx context.Context, kid string) (any, error) {222
if err := e.ensureDiscovery(ctx); err != nil {223
return nil, err224
}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 "", err231
}232
e.mu.Lock()233
defer e.mu.Unlock()234
return e.authz, nil235
}236
237
func (e *Entra) tokenEndpoint(ctx context.Context) (string, error) {238
if err := e.ensureDiscovery(ctx); err != nil {239
return "", err240
}241
e.mu.Lock()242
defer e.mu.Unlock()243
return e.token, nil244
}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 nil251
}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 err257
}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 err279
}280
}281
e.mu.Lock()282
e.authz = doc.AuthorizationEndpoint283
e.token = doc.TokenEndpoint284
e.jwksURI = doc.JWKSURI285
e.mu.Unlock()286
return nil287
}288
289
// oidcEndpointHostOK eist dat authorization, token en jwks op dezelfde host290
// 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 nil307
}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 err318
}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.ErrorDesc326
if msg == "" {327
msg = env.Error328
}329
if msg == "" {330
msg = res.Status331
}332
return fmt.Errorf("auth: %s", msg)333
}334
if dest == nil {335
return nil336
}337
if err := json.Unmarshal(raw, dest); err != nil {338
return fmt.Errorf("auth-antwoord: %w", err)339
}340
return nil341
}342
343
// StableAuthID maakt een positieve int64 uit tenant + object-id.344
// Collisie is theoretisch mogelijk; bij een botsing krijgt de tweede gebruiker345
// 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 uint64349
for i := 0; i < 8; i++ {350
n = n<<8 | uint64(sum[i])351
}352
n &^= 1 << 63353
if n == 0 {354
n = 1355
}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, nil380
}381
382
func sanitizeUsername(raw string) string {383
s := strings.ToLower(strings.TrimSpace(raw))384
var b strings.Builder385
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 out401
}@@ -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 @@1
package auth2
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 *Entra27
key *rsa.PrivateKey28
kid string29
nonce string30
verifier string31
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.URL52
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
return68
}69
tok, err := signIDToken(key, kid, validTokenClaims(issuer, nonce, tenant, clientID, oid))70
if err != nil {71
http.Error(w, err.Error(), 500)72
return73
}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 "", err95
}96
payload, err := json.Marshal(claims)97
if err != nil {98
return "", err99
}100
h := base64.RawURLEncoding.EncodeToString(hdr)101
p := base64.RawURLEncoding.EncodeToString(payload)102
signing := h + "." + p103
if signer == nil {104
return signing + ".", nil105
}106
sig, err := signer(signing)107
if err != nil {108
return "", err109
}110
return signing + "." + sig, nil111
}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.TenantID154
clientID := h.client.ClientID155
oid := "22222222-2222-2222-2222-222222222299"156
issuer := h.client.Issuer157
nonce := h.nonce158
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)), nil253
})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,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 @@1
package auth2
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 string55
mux := http.NewServeMux()56
srv := httptest.NewServer(mux)57
defer srv.Close()58
issuer = srv.URL59
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
return78
}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
return95
}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.URL148
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 "", err189
}190
payload, err := json.Marshal(claims)191
if err != nil {192
return "", err193
}194
h := base64.RawURLEncoding.EncodeToString(hdr)195
p := base64.RawURLEncoding.EncodeToString(payload)196
signing := h + "." + p197
sum := sha256.Sum256([]byte(signing))198
sig, err := rsa.SignPKCS1v15(rand.Reader, key, crypto.SHA256, sum[:])199
if err != nil {200
return "", err201
}202
return signing + "." + base64.RawURLEncoding.EncodeToString(sig), nil203
}@@ -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 @@1
package auth2
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 []string28
29
func (a *jsonAudience) UnmarshalJSON(b []byte) error {30
var one string31
if err := json.Unmarshal(b, &one); err == nil {32
*a = []string{one}33
return nil34
}35
var many []string36
if err := json.Unmarshal(b, &many); err != nil {37
return err38
}39
*a = many40
return nil41
}42
43
func (a jsonAudience) includes(want string) bool {44
for _, v := range a {45
if v == want {46
return true47
}48
}49
return false50
}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 jwtHeader62
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, nil70
}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 nil90
}91
92
func b64url(s string) ([]byte, error) {93
return base64.RawURLEncoding.DecodeString(s)94
}95
96
type jwksCache struct {97
mu sync.Mutex98
fetched time.Time99
keys map[string]*rsa.PublicKey100
uri string101
}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, nil108
}109
c.mu.Unlock()110
if err := c.refresh(ctx, httpc, uri); err != nil {111
return nil, err112
}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, nil120
}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 err126
}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 err135
}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
continue149
}150
pub, err := k.rsaPublic()151
if err != nil {152
continue153
}154
keys[k.Kid] = pub155
}156
if len(keys) == 0 {157
return fmt.Errorf("auth: jwks zonder bruikbare sleutels")158
}159
c.mu.Lock()160
c.keys = keys161
c.uri = uri162
c.fetched = time.Now()163
c.mu.Unlock()164
return nil165
}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, err180
}181
eb, err := b64url(k.E)182
if err != nil {183
return nil, err184
}185
var e int186
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}, nil195
}@@ -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 @@1
package auth2
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), nil17
}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
}@@ -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.Set42
proxies *realip.Set43
}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
type Auth struct {46
type Auth struct {47
Mode string `yaml:"mode"`47
Mode string `yaml:"mode"` // oauth | entra | dev48
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 err262
}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.RedirectPath349
return c.BaseURL + c.Auth.RedirectPath330
}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 nil362
}363
364
func issuerLoopback(host string) bool {365
if strings.EqualFold(host, "localhost") {366
return true367
}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.Issuer376
}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.333
func Example() string {381
func 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_secret402
client_secret_file: /etc/bluegit/client_secret355
redirect_path: /auth/callback403
redirect_path: /auth/callback356
user_agent: BlueGitAccountClient/0.1404
user_agent: BlueGitAccountClient/0.1405
# Alternatief: Microsoft Entra ID (OIDC, één tenant). Zet mode op entra406
# en vul tenant_id + client_id; geheim hetzelfde als hierboven.407
# mode: entra408
# tenant_id: 00000000-0000-0000-0000-000000000000409
# client_id: 11111111-1111-1111-1111-111111111111410
# issuer blijft leeg, tenzij je een andere cloud of testissuer nodig hebt.357
411
358
git:412
git:359
binary: git413
binary: git@@ -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
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.test132
auth:133
mode: entra134
tenant_id: 00000000-0000-0000-0000-000000000001135
client_id: 11111111-1111-1111-1111-111111111111136
`)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.test156
auth:157
mode: entra158
tenant_id: 00000000-0000-0000-0000-000000000001159
client_id: 11111111-1111-1111-1111-111111111111160
issuer: https://login.test.example/t/v2.0161
`)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 string180
want string181
}{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.test225
auth:226
mode: entra227
tenant_id: t1228
client_id: app229
issuer: http://127.0.0.1:8081/t/v2.0230
`)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
func TestSecretFromEnv(t *testing.T) {243
func 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")@@ -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
return17
return17
}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
return23
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
return31
return31
}32
}33
nonce, err := randomState()34
if err != nil {35
http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)36
return37
}38
verifier, err := auth.NewPKCEVerifier()39
if err != nil {40
http.Error(w, s.tr(r, "err.session"), http.StatusInternalServerError)41
return42
}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
40
func (s *Server) callback(w http.ResponseWriter, r *http.Request) {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
http.Error(w, s.tr(r, "err.oauthState"), http.StatusBadRequest)70
http.Error(w, s.tr(r, "err.oauthState"), http.StatusBadRequest)52
return71
return53
}72
}73
nonceCookie, err := r.Cookie("bluegit_oauth_nonce")74
nonce := ""75
if err == nil {76
nonce = nonceCookie.Value77
}78
pkceCookie, err := r.Cookie("bluegit_oauth_pkce")79
verifier := ""80
if err == nil {81
verifier = pkceCookie.Value82
}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"))@@ -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_secret23
client_secret_file: /etc/bluegit/client_secret24
redirect_path: /auth/callback24
redirect_path: /auth/callback25
user_agent: BlueGitAccountClient/0.125
user_agent: BlueGitAccountClient/0.126
# Alternatief: Microsoft Entra ID (OIDC, één tenant). Zie docs/AUTH.md.27
# mode: entra28
# tenant_id: 00000000-0000-0000-0000-00000000000029
# client_id: 11111111-1111-1111-1111-11111111111126
30
27
git:31
git:28
binary: git32
binary: git