Niklas Ye
a27ff49171
terdut can now sign people in through any OIDC provider (written against Authentik), and let groups at the provider decide who may sign in, which teams they belong to and whether they administer the install. Password login keeps working alongside it; TERDUT_PASSWORD_LOGIN=false turns it off, and is refused at startup unless SSO is configured. With no TERDUT_OIDC_* setting nothing changes, so every existing install behaves as before. Identity is (issuer, subject), never email or username: those are mutable at the provider and a recycled address must not inherit an account. An existing user is linked by email only when the provider marks it verified, or TERDUT_OIDC_TRUST_EMAIL is set, which Authentik needs. Group grants are marked source='oidc' on team_members and users, and the sync changes only those rows. Hand-made memberships and administrators are left alone, and the sync bypasses the last-owner and last-admin guards because the provider is the source of truth for what it grants. Editing managed access by hand is refused with 409, since the next sign-in would undo it. The web UI badges it as SSO and disables the controls. Groups are read only at sign-in, so an SSO session carries a hard ceiling (sessions.max_expires_at, 12h by default) that sliding never extends. There is no refresh token, which means API keys of somebody removed at the provider stay valid until an administrator disables the user. That is accepted and documented, not fixed. A client with no browser, the TUI over SSH, signs in with a device code run by terdut itself (POST /api/oidc/device and /device/token), so the terminal never talks to the provider and ends up with the ordinary terdut_session cookie. Only a browser session can approve a code; an API key cannot. /device?code= sends a signed-out visitor through sign-in and back, which is what oidc_logins.next is for. oauth2 is pinned to v0.36.0: v0.37 needs Go 1.26 and the Dockerfile builds on 1.25. Migrations 011 and 012 add tables and defaulted columns only.
82 lines
2.1 KiB
Go
82 lines
2.1 KiB
Go
// Package oidc signs users in through an OpenID Connect provider and turns the
|
|
// groups it reports into the access terdut grants.
|
|
//
|
|
// The package knows nothing about the database or HTTP handlers: Grants is a
|
|
// pure function of configuration and groups, and Provider is the protocol. The
|
|
// api package joins them to users, teams and sessions.
|
|
package oidc
|
|
|
|
import (
|
|
"git.ryuvia.com/niklas/terdut-server/internal/config"
|
|
)
|
|
|
|
// Role names match models.RoleOwner and RoleMember. They are restated here so
|
|
// the package stays free of the models import; config.Validate has already
|
|
// refused anything else.
|
|
const (
|
|
roleOwner = "owner"
|
|
roleMember = "member"
|
|
)
|
|
|
|
// Grants is the access a set of groups confers.
|
|
type Grants struct {
|
|
// Admitted is false when AllowedGroups is set and the user is in none of
|
|
// them. Nothing else in the struct means anything then.
|
|
Admitted bool
|
|
|
|
// Admin is whether the user is in the admin group.
|
|
Admin bool
|
|
|
|
// Teams maps team name to role. Where several groups grant the same team the
|
|
// highest role wins, so belonging to both a members group and an owners
|
|
// group makes somebody an owner rather than whichever mapping came last.
|
|
Teams map[string]string
|
|
}
|
|
|
|
// ComputeGrants evaluates the configured mappings against groups.
|
|
func ComputeGrants(cfg config.OIDC, groups []string) Grants {
|
|
in := make(map[string]bool, len(groups))
|
|
for _, g := range groups {
|
|
in[g] = true
|
|
}
|
|
|
|
g := Grants{Teams: map[string]string{}}
|
|
|
|
g.Admitted = len(cfg.AllowedGroups) == 0
|
|
for _, allowed := range cfg.AllowedGroups {
|
|
if in[allowed] {
|
|
g.Admitted = true
|
|
break
|
|
}
|
|
}
|
|
if !g.Admitted {
|
|
return g
|
|
}
|
|
|
|
g.Admin = cfg.AdminGroup != "" && in[cfg.AdminGroup]
|
|
|
|
for _, m := range cfg.GroupMappings {
|
|
if !in[m.Group] {
|
|
continue
|
|
}
|
|
if rank(m.Role) > rank(g.Teams[m.Team]) {
|
|
g.Teams[m.Team] = m.Role
|
|
}
|
|
}
|
|
return g
|
|
}
|
|
|
|
// rank orders roles; an unknown or absent role ranks lowest.
|
|
func rank(role string) int {
|
|
switch role {
|
|
case roleOwner:
|
|
return 2
|
|
case roleMember:
|
|
return 1
|
|
}
|
|
return 0
|
|
}
|
|
|
|
// HigherRole reports whether role a outranks role b.
|
|
func HigherRole(a, b string) bool { return rank(a) > rank(b) }
|