Repository Public
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