1
0
mirror of https://github.com/juanfont/headscale.git synced 2026-02-23 13:50:36 +01:00
juanfont.headscale/docs/ref
Lukas Wolfsteiner b07bd37f39 feat(oidc): add use_email_as_username option to fall back to email claim
Some OIDC providers (e.g. Google OAuth) do not send the
preferred_username claim when the profile scope is requested,
causing the username in Headscale to be blank.

Add oidc.use_email_as_username config option (default: false) that,
when enabled, uses the email claim as the username if
preferred_username is not available. When preferred_username is
present, it is always used regardless of this setting.

- Add UseEmailAsUsername to OIDCConfig with viper wiring
- Extend FromClaim() to accept useEmailAsUsername parameter
- Add 5 test cases covering fallback enabled/disabled, priority,
  empty email, and unverified email scenarios
- Update docs, config example, and Google OAuth guidance

Fixes #3071.

Cheers!
2026-02-09 02:15:40 +01:00
..
integration Add headscale-piying web UI to docs 2026-01-14 12:56:05 +01:00
acls.md Add a page to describe supported registration methods 2026-01-28 15:52:57 +01:00
api.md Use registration key instead of machine key 2026-01-28 15:52:57 +01:00
configuration.md Document HEADSCALE_CONFIG 2025-05-16 19:33:00 +02:00
debug.md Document how to disable the metrics interfaces 2026-01-16 14:54:04 +01:00
derp.md Describe how to remove a DERP region 2025-09-09 11:05:30 +02:00
dns.md Misc typos and spelling 2025-09-17 16:32:29 +02:00
oidc.md feat(oidc): add use_email_as_username option to fall back to email claim 2026-02-09 02:15:40 +01:00
registration.md Add a page to describe supported registration methods 2026-01-28 15:52:57 +01:00
routes.md Fix ownership description for auto approved routers/exits 2026-01-16 14:54:04 +01:00
tags.md Add a tags page and describe a few common operations 2026-01-28 15:52:57 +01:00
tls.md Fix config param name in TLS doc 2025-07-13 12:56:25 +02:00