SPB Git

Repository Public

webauthn.go 18.8 KB 497 lines go

1/**2 * =============================================================================3 *                  SP BOUCHER | INFRASTRUCTURE & AUTOMATION4 *             ARTIFICIAL INTELLIGENCE • FINANCE • ENGINEERING5 * =============================================================================6 *7 * Project          : MacLustr Command Center (MCC)8 * File             : services/internal/identity/webauthn.go9 * Module           : services10 * Repository       : https://git.spboucher.ai/maclustr-command-center11 * Project Website  : https://clustr.spboucher.ai12 * Created          : 2026-11-1813 * Last Modified    : 2026-11-1814 *15 * Author           : Simon-Pierre Boucher16 * Position         : Professor of Finance17 * Institution      : Université du Québec en Outaouais (UQO)18 * Organization     : SP Boucher19 * Website          : https://spboucher.ai20 * Git              : https://git.spboucher.ai21 *22 * Preferred Contact: admin@spboucher.ai23 * Technical Contact: dev@spboucher.ai24 * Security/Admin   : admin@spboucher.ai25 *26 * Copyright (c) 202627 * Simon-Pierre Boucher28 * All rights reserved where applicable. This file is governed by the29 * applicable project license, copyright notices and relevant law.30 * Existing third-party rights and notices remain unaffected.31 *32 * License          : None specified (no license file in this repository)33 *34 * Do not embed credentials, private keys, access tokens,35 * certificates or confidential personal information.36 *37 * =============================================================================38 * END OF SP BOUCHER SOURCE HEADER39 * =============================================================================40 */4142package identity4344import (45	"bytes"46	"context"47	"encoding/json"48	"errors"49	"time"5051	"github.com/go-webauthn/webauthn/protocol"52	"github.com/go-webauthn/webauthn/webauthn"53	"github.com/google/uuid"54	"github.com/jackc/pgx/v5"5556	"clustr.spboucher.ai/mcc/internal/audit"57	"clustr.spboucher.ai/mcc/internal/httpx"58	"clustr.spboucher.ai/mcc/internal/ids"59)6061// waUser adapts a User and its active credentials to the library.62type waUser struct {63	User64	creds []webauthn.Credential65}6667func (u waUser) WebAuthnID() []byte                         { return u.WebAuthnHandle }68func (u waUser) WebAuthnName() string                       { return u.Handle }69func (u waUser) WebAuthnDisplayName() string                { return u.DisplayName }70func (u waUser) WebAuthnCredentials() []webauthn.Credential { return u.creds }7172type rowQuerier interface {73	Query(ctx context.Context, sql string, args ...any) (pgx.Rows, error)74	QueryRow(ctx context.Context, sql string, args ...any) pgx.Row75}7677func loadCredentials(ctx context.Context, q rowQuerier, userID uuid.UUID) ([]webauthn.Credential, error) {78	rows, err := q.Query(ctx, `select credential from passkeys where user_id=$1 and revoked_at is null order by created_at`, userID)79	if err != nil {80		return nil, err81	}82	return pgx.CollectRows(rows, func(r pgx.CollectableRow) (webauthn.Credential, error) {83		var raw []byte84		var c webauthn.Credential85		if err := r.Scan(&raw); err != nil {86			return c, err87		}88		return c, json.Unmarshal(raw, &c)89	})90}9192type challengeRow struct {93	ID        uuid.UUID94	Kind      string95	UserID    *uuid.UUID96	SessionID *uuid.UUID97	TxID      *uuid.UUID98	Data      challengeData99}100101// challengeData is what we keep between begin and finish.102type challengeData struct {103	Session webauthn.SessionData `json:"session"`104	// Registration on invitation: the identity being created.105	NewHandle      string `json:"new_handle,omitempty"`106	NewDisplayName string `json:"new_display_name,omitempty"`107	NewUserHandle  []byte `json:"new_user_handle,omitempty"`108}109110func (s *Service) storeChallenge(ctx context.Context, kind string, userID, sessionID, txID *uuid.UUID, data challengeData) (uuid.UUID, error) {111	id := ids.New()112	raw, err := json.Marshal(data)113	if err != nil {114		return id, err115	}116	now := s.now()117	_, err = s.pool.Exec(ctx, `insert into webauthn_challenges(id,kind,user_id,session_id,invitation_tx,data,created_at,expires_at)118		values ($1,$2::challenge_kind,$3,$4,$5,$6,$7,$8)`, id, kind, userID, sessionID, txID, raw, now, now.Add(challengeTTL))119	return id, err120}121122// consumeChallenge atomically marks a challenge used. A challenge can be123// consumed exactly once, whatever the outcome of the verification that124// follows: a failed attempt burns it.125func (s *Service) consumeChallenge(ctx context.Context, id uuid.UUID, kind string) (*challengeRow, error) {126	c := challengeRow{ID: id, Kind: kind}127	var raw []byte128	err := s.pool.QueryRow(ctx, `update webauthn_challenges set consumed_at=$3129		where id=$1 and kind=$2::challenge_kind and consumed_at is null and expires_at > $3130		returning user_id, session_id, invitation_tx, data`, id, kind, s.now()).Scan(&c.UserID, &c.SessionID, &c.TxID, &raw)131	if errors.Is(err, pgx.ErrNoRows) {132		return nil, ErrChallenge133	} else if err != nil {134		return nil, err135	}136	if err := json.Unmarshal(raw, &c.Data); err != nil {137		return nil, err138	}139	// The library enforces its own expiry from SessionData; keep both clocks aligned for tests.140	c.Data.Session.Expires = time.Now().Add(time.Minute)141	return &c, nil142}143144func requireUV(o *protocol.PublicKeyCredentialRequestOptions) error {145	o.UserVerification = protocol.VerificationRequired146	return nil147}148149// ── Authentication ─────────────────────────────────────────────────────────150151// BeginAuthentication starts a username-less (discoverable credential) sign-in.152func (s *Service) BeginAuthentication(ctx context.Context) (uuid.UUID, *protocol.CredentialAssertion, error) {153	opts, sd, err := s.wa.BeginDiscoverableLogin(requireUV)154	if err != nil {155		return uuid.Nil, nil, err156	}157	id, err := s.storeChallenge(ctx, "authentication", nil, nil, nil, challengeData{Session: *sd})158	return id, opts, err159}160161// FinishAuthentication verifies the assertion and opens a session.162func (s *Service) FinishAuthentication(ctx context.Context, challengeID uuid.UUID, credential []byte, client ClientInfo, meta ReqMeta) (*AuthResult, error) {163	if !client.valid() {164		return nil, httpx.Validation("client.kind must be web, macos or ios.")165	}166	ch, err := s.consumeChallenge(ctx, challengeID, "authentication")167	if err != nil {168		return nil, err169	}170	parsed, err := protocol.ParseCredentialRequestResponseBody(bytes.NewReader(credential))171	if err != nil {172		return nil, s.rejectAuth(ctx, meta, nil, "malformed assertion")173	}174	var found *waUser175	_, cred, err := s.wa.ValidatePasskeyLogin(func(rawID, userHandle []byte) (webauthn.User, error) {176		u, err := scanUser(s.pool.QueryRow(ctx, `select `+userCols+` from users u where u.webauthn_handle=$1`, userHandle))177		if err != nil {178			return nil, err179		}180		creds, err := loadCredentials(ctx, s.pool, u.ID)181		if err != nil {182			return nil, err183		}184		found = &waUser{User: u, creds: creds}185		return found, nil186	}, ch.Data.Session, parsed)187	if err != nil || found == nil {188		var uid *uuid.UUID189		if found != nil {190			uid = &found.ID191		}192		return nil, s.rejectAuth(ctx, meta, uid, "assertion verification failed")193	}194	if found.DisabledAt != nil {195		return nil, s.rejectAuth(ctx, meta, &found.ID, "account disabled")196	}197	if !cred.Flags.UserVerified {198		return nil, s.rejectAuth(ctx, meta, &found.ID, "user verification missing")199	}200	if cred.Authenticator.CloneWarning {201		// Signature counter went backwards: possible cloned authenticator. Refuse and leave the stored counter untouched.202		return nil, s.rejectAuth(ctx, meta, &found.ID, "signature counter regression (possible cloned authenticator)")203	}204205	tx, err := s.pool.Begin(ctx)206	if err != nil {207		return nil, err208	}209	defer tx.Rollback(ctx)210	passkeyID, err := s.touchPasskey(ctx, tx, found.ID, cred)211	if err != nil {212		return nil, err213	}214	res, err := s.issueSession(ctx, tx, found.User, &passkeyID, client, meta)215	if err != nil {216		return nil, err217	}218	if err := s.audit(ctx, tx, &res.Session, meta, "auth.login", "user", found.ID.String(), audit.Success, "",219		map[string]any{"client": client.Kind, "passkey_id": passkeyID.String()}); err != nil {220		return nil, err221	}222	return res, tx.Commit(ctx)223}224225func (s *Service) rejectAuth(ctx context.Context, meta ReqMeta, userID *uuid.UUID, reason string) error {226	target := ""227	if userID != nil {228		target = userID.String()229	}230	s.audit(ctx, s.pool, nil, meta, "auth.login", "user", target, audit.Denied, reason, nil)231	return ErrCredential232}233234func (s *Service) touchPasskey(ctx context.Context, tx pgx.Tx, userID uuid.UUID, cred *webauthn.Credential) (uuid.UUID, error) {235	raw, err := json.Marshal(cred)236	if err != nil {237		return uuid.Nil, err238	}239	var id uuid.UUID240	err = tx.QueryRow(ctx, `update passkeys set sign_count=$3, backup_state=$4, credential=$5, last_used_at=$6241		where user_id=$1 and credential_id=$2 and revoked_at is null returning id`,242		userID, cred.ID, int64(cred.Authenticator.SignCount), cred.Flags.BackupState, raw, s.now()).Scan(&id)243	if errors.Is(err, pgx.ErrNoRows) {244		return id, ErrCredential // revoked between verification and now245	}246	return id, err247}248249// ── Step-up ────────────────────────────────────────────────────────────────250251func (s *Service) BeginStepUp(ctx context.Context, sess *Session) (uuid.UUID, *protocol.CredentialAssertion, error) {252	creds, err := loadCredentials(ctx, s.pool, sess.User.ID)253	if err != nil {254		return uuid.Nil, nil, err255	}256	if len(creds) == 0 {257		return uuid.Nil, nil, ErrCredential258	}259	opts, sd, err := s.wa.BeginLogin(waUser{User: sess.User, creds: creds}, requireUV)260	if err != nil {261		return uuid.Nil, nil, err262	}263	id, err := s.storeChallenge(ctx, "stepup", &sess.User.ID, &sess.ID, nil, challengeData{Session: *sd})264	return id, opts, err265}266267// FinishStepUp verifies a fresh assertion by the session's own user and268// refreshes the session's authenticated_at.269func (s *Service) FinishStepUp(ctx context.Context, sess *Session, challengeID uuid.UUID, credential []byte, meta ReqMeta) (time.Time, error) {270	ch, err := s.consumeChallenge(ctx, challengeID, "stepup")271	if err != nil {272		return time.Time{}, err273	}274	fail := func(reason string) (time.Time, error) {275		s.audit(ctx, s.pool, sess, meta, "auth.stepup", "session", sess.ID.String(), audit.Denied, reason, nil)276		return time.Time{}, ErrCredential277	}278	// The challenge is bound to the session that requested it.279	if ch.SessionID == nil || *ch.SessionID != sess.ID || ch.UserID == nil || *ch.UserID != sess.User.ID {280		return fail("challenge belongs to another session")281	}282	parsed, err := protocol.ParseCredentialRequestResponseBody(bytes.NewReader(credential))283	if err != nil {284		return fail("malformed assertion")285	}286	creds, err := loadCredentials(ctx, s.pool, sess.User.ID)287	if err != nil {288		return time.Time{}, err289	}290	cred, err := s.wa.ValidateLogin(waUser{User: sess.User, creds: creds}, ch.Data.Session, parsed)291	if err != nil || !cred.Flags.UserVerified || cred.Authenticator.CloneWarning {292		return fail("assertion verification failed")293	}294	tx, err := s.pool.Begin(ctx)295	if err != nil {296		return time.Time{}, err297	}298	defer tx.Rollback(ctx)299	if _, err := s.touchPasskey(ctx, tx, sess.User.ID, cred); err != nil {300		return time.Time{}, err301	}302	if err := s.markStepUp(ctx, tx, sess.ID); err != nil {303		return time.Time{}, err304	}305	if err := s.audit(ctx, tx, sess, meta, "auth.stepup", "session", sess.ID.String(), audit.Success, "", nil); err != nil {306		return time.Time{}, err307	}308	now := s.now()309	sess.AuthenticatedAt = now310	return now, tx.Commit(ctx)311}312313// ── Registration ───────────────────────────────────────────────────────────314315func registrationOptions(exclude []webauthn.Credential) webauthn.RegistrationOption {316	return func(o *protocol.PublicKeyCredentialCreationOptions) error {317		required := true318		o.AuthenticatorSelection = protocol.AuthenticatorSelection{319			ResidentKey: protocol.ResidentKeyRequirementRequired, RequireResidentKey: &required,320			UserVerification: protocol.VerificationRequired,321		}322		o.Attestation = protocol.PreferNoAttestation323		// ES256 and RS256 only.324		var params []protocol.CredentialParameter325		for _, p := range o.Parameters {326			if p.Algorithm == -7 || p.Algorithm == -257 {327				params = append(params, p)328			}329		}330		if len(params) > 0 {331			o.Parameters = params332		}333		for _, c := range exclude {334			o.CredentialExcludeList = append(o.CredentialExcludeList, c.Descriptor())335		}336		return nil337	}338}339340// BeginAddPasskey starts registration of an additional passkey for the341// signed-in user. The caller must have enforced step-up.342func (s *Service) BeginAddPasskey(ctx context.Context, sess *Session) (uuid.UUID, *protocol.CredentialCreation, error) {343	creds, err := loadCredentials(ctx, s.pool, sess.User.ID)344	if err != nil {345		return uuid.Nil, nil, err346	}347	opts, sd, err := s.wa.BeginRegistration(waUser{User: sess.User, creds: creds}, registrationOptions(creds))348	if err != nil {349		return uuid.Nil, nil, err350	}351	id, err := s.storeChallenge(ctx, "registration", &sess.User.ID, &sess.ID, nil, challengeData{Session: *sd})352	return id, opts, err353}354355func (s *Service) FinishAddPasskey(ctx context.Context, sess *Session, challengeID uuid.UUID, credential []byte, label string, meta ReqMeta) (*Passkey, error) {356	ch, err := s.consumeChallenge(ctx, challengeID, "registration")357	if err != nil {358		return nil, err359	}360	if ch.SessionID == nil || *ch.SessionID != sess.ID || ch.TxID != nil {361		return nil, ErrChallenge362	}363	cred, err := s.verifyCreation(waUser{User: sess.User}, ch, credential)364	if err != nil {365		s.audit(ctx, s.pool, sess, meta, "passkey.add", "user", sess.User.ID.String(), audit.Denied, "attestation verification failed", nil)366		return nil, err367	}368	tx, err := s.pool.Begin(ctx)369	if err != nil {370		return nil, err371	}372	defer tx.Rollback(ctx)373	pk, err := s.insertPasskey(ctx, tx, sess.User.ID, cred, label)374	if err != nil {375		return nil, err376	}377	if err := s.audit(ctx, tx, sess, meta, "passkey.add", "passkey", pk.ID.String(), audit.Success, "", nil); err != nil {378		return nil, err379	}380	return pk, tx.Commit(ctx)381}382383func (s *Service) verifyCreation(u waUser, ch *challengeRow, credential []byte) (*webauthn.Credential, error) {384	parsed, err := protocol.ParseCredentialCreationResponseBody(bytes.NewReader(credential))385	if err != nil {386		return nil, ErrCredential387	}388	cred, err := s.wa.CreateCredential(u, ch.Data.Session, parsed)389	if err != nil || !cred.Flags.UserVerified {390		return nil, ErrCredential391	}392	return cred, nil393}394395func (s *Service) insertPasskey(ctx context.Context, tx pgx.Tx, userID uuid.UUID, cred *webauthn.Credential, label string) (*Passkey, error) {396	raw, err := json.Marshal(cred)397	if err != nil {398		return nil, err399	}400	transports := make([]string, 0, len(cred.Transport))401	for _, t := range cred.Transport {402		transports = append(transports, string(t))403	}404	pk := &Passkey{ID: ids.New(), UserID: userID, Label: trunc(label, 60), CreatedAt: s.now(),405		BackupEligible: cred.Flags.BackupEligible, BackupState: cred.Flags.BackupState, Transports: transports}406	_, err = tx.Exec(ctx, `insert into passkeys(id,user_id,credential_id,public_key,aaguid,sign_count,transports,backup_eligible,backup_state,407			attestation_fmt,label,created_at,credential) values ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13)`,408		pk.ID, userID, cred.ID, cred.PublicKey, cred.Authenticator.AAGUID, int64(cred.Authenticator.SignCount), transports,409		pk.BackupEligible, pk.BackupState, cred.AttestationFormat, pk.Label, pk.CreatedAt, raw)410	if isUniqueViolation(err) {411		return nil, httpx.Conflict("credential_exists", "This passkey is already registered.")412	}413	return pk, err414}415416// ── Passkey management ─────────────────────────────────────────────────────417418func (s *Service) ListPasskeys(ctx context.Context, userID uuid.UUID) ([]Passkey, error) {419	rows, err := s.pool.Query(ctx, `select id,user_id,label,created_at,last_used_at,backup_eligible,backup_state,transports,revoked_at420		from passkeys where user_id=$1 and revoked_at is null order by created_at`, userID)421	if err != nil {422		return nil, err423	}424	return pgx.CollectRows(rows, func(r pgx.CollectableRow) (Passkey, error) {425		var p Passkey426		err := r.Scan(&p.ID, &p.UserID, &p.Label, &p.CreatedAt, &p.LastUsedAt, &p.BackupEligible, &p.BackupState, &p.Transports, &p.RevokedAt)427		return p, err428	})429}430431// ListAllPasskeys returns every passkey of a user, revoked ones included432// (administration view), oldest first.433func (s *Service) ListAllPasskeys(ctx context.Context, userID uuid.UUID) ([]Passkey, error) {434	rows, err := s.pool.Query(ctx, `select id,user_id,label,created_at,last_used_at,backup_eligible,backup_state,transports,revoked_at,aaguid435		from passkeys where user_id=$1 order by created_at, id`, userID)436	if err != nil {437		return nil, err438	}439	return pgx.CollectRows(rows, func(r pgx.CollectableRow) (Passkey, error) {440		var p Passkey441		err := r.Scan(&p.ID, &p.UserID, &p.Label, &p.CreatedAt, &p.LastUsedAt, &p.BackupEligible, &p.BackupState, &p.Transports, &p.RevokedAt, &p.AAGUID)442		return p, err443	})444}445446func (s *Service) RenamePasskey(ctx context.Context, sess *Session, id uuid.UUID, label string) error {447	label = trunc(label, 60)448	tag, err := s.pool.Exec(ctx, `update passkeys set label=$3 where id=$1 and user_id=$2 and revoked_at is null`, id, sess.User.ID, label)449	if err == nil && tag.RowsAffected() == 0 {450		return httpx.ErrNotFound451	}452	return err453}454455// RevokePasskey revokes a passkey of ownerID. When allowLast is false (a456// user acting on their own account) the last passkey cannot be removed.457// Sessions opened with that passkey are revoked too.458func (s *Service) RevokePasskey(ctx context.Context, actor *Session, ownerID, passkeyID uuid.UUID, allowLast bool, meta ReqMeta) error {459	tx, err := s.pool.Begin(ctx)460	if err != nil {461		return err462	}463	defer tx.Rollback(ctx)464	// Lock the user's passkeys so two concurrent deletions cannot both pass the "not last" check.465	rows, err := tx.Query(ctx, `select id from passkeys where user_id=$1 and revoked_at is null for update`, ownerID)466	if err != nil {467		return err468	}469	active, err := pgx.CollectRows(rows, pgx.RowTo[uuid.UUID])470	if err != nil {471		return err472	}473	present := false474	for _, id := range active {475		present = present || id == passkeyID476	}477	if !present {478		return httpx.ErrNotFound479	}480	if len(active) <= 1 && !allowLast {481		return ErrLastPasskey482	}483	now := s.now()484	if _, err := tx.Exec(ctx, `update passkeys set revoked_at=$2 where id=$1`, passkeyID, now); err != nil {485		return err486	}487	if _, err := tx.Exec(ctx, `update sessions set revoked_at=$2, revoked_reason='passkey_revoked' where passkey_id=$1 and revoked_at is null and id<>$3`,488		passkeyID, now, actor.ID); err != nil {489		return err490	}491	if err := s.audit(ctx, tx, actor, meta, "passkey.revoke", "passkey", passkeyID.String(), audit.Success, "",492		map[string]any{"user_id": ownerID.String()}); err != nil {493		return err494	}495	return tx.Commit(ctx)496}497
Files main
Menu

Theme