emilsoftware-utilities 2.0.0-dev.8 → 2.0.0-dev.80

package/dist/accessi-module/security/authCookies.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAccessiAuthCookieOptions = resolveAccessiAuthCookieOptions;
+exports.parseAccessiCookieHeader = parseAccessiCookieHeader;
+exports.isAccessiUnsafeMethod = isAccessiUnsafeMethod;
+exports.isAccessiCsrfExemptPath = isAccessiCsrfExemptPath;
+exports.setAccessiAuthCookies = setAccessiAuthCookies;
+exports.clearAccessiAuthCookies = clearAccessiAuthCookies;
+exports.applyAccessiAuthCookies = applyAccessiAuthCookies;
+exports.hideAccessiLoginTokens = hideAccessiLoginTokens;
+exports.getAccessiAccessTokenFromCookie = getAccessiAccessTokenFromCookie;
+exports.getAccessiRefreshTokenFromCookie = getAccessiRefreshTokenFromCookie;
+exports.createAccessiAuthCookieMiddleware = createAccessiAuthCookieMiddleware;
+exports.isValidAccessiCookieName = isValidAccessiCookieName;
+exports.accessiCookieNames = accessiCookieNames;
+const crypto_1 = require("crypto");
+const jsonwebtoken_1 = require("jsonwebtoken");
+const COOKIE_NAME = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+const DEFAULTS = {
+    secure: true,
+    sameSite: 'lax',
+    accessTokenName: 'accessi_access',
+    refreshTokenName: 'accessi_refresh',
+    csrfTokenName: 'accessi_csrf',
+    accessPath: '/api/accessi',
+    refreshPath: '/api/accessi/auth',
+    csrfPath: '/',
+    csrfHeaderName: 'x-csrf-token',
+    csrf: 'double-submit',
+    exposeTokens: false,
+    refreshFromCookie: true,
+};
+/** Percorsi pubblici che non richiedono il token CSRF (non hanno ancora una sessione). */
+const CSRF_EXEMPT_PATHS = [
+    '/api/accessi/auth/login',
+    '/api/accessi/auth/refresh',
+    '/api/accessi/auth/confirm-reset-password',
+    '/api/accessi/auth/two-factor/verify',
+    '/api/accessi/auth/two-factor/resend',
+    '/api/accessi/auth/bootstrap-admin',
+    '/api/accessi/email/',
+    '/api/accessi/federated-auth/exchange',
+    '/api/accessi/user/register',
+];
+const UNSAFE_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
+/** Risolve la configurazione dei cookie; `undefined` quando la modalita e disattivata. */
+function resolveAccessiAuthCookieOptions(options) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const raw = options.authCookie;
+    if (!raw || raw.enabled === false)
+        return undefined;
+    return Object.assign(Object.assign({ secure: raw.secure !== false, sameSite: (_a = raw.sameSite) !== null && _a !== void 0 ? _a : DEFAULTS.sameSite }, (raw.domain ? { domain: raw.domain } : {})), { accessTokenName: (_b = raw.accessTokenName) !== null && _b !== void 0 ? _b : DEFAULTS.accessTokenName, refreshTokenName: (_c = raw.refreshTokenName) !== null && _c !== void 0 ? _c : DEFAULTS.refreshTokenName, csrfTokenName: (_d = raw.csrfTokenName) !== null && _d !== void 0 ? _d : DEFAULTS.csrfTokenName, accessPath: (_e = raw.accessPath) !== null && _e !== void 0 ? _e : DEFAULTS.accessPath, refreshPath: (_f = raw.refreshPath) !== null && _f !== void 0 ? _f : DEFAULTS.refreshPath, csrfPath: (_g = raw.csrfPath) !== null && _g !== void 0 ? _g : DEFAULTS.csrfPath, csrfHeaderName: ((_h = raw.csrfHeaderName) !== null && _h !== void 0 ? _h : DEFAULTS.csrfHeaderName).toLowerCase(), csrf: (_j = raw.csrf) !== null && _j !== void 0 ? _j : DEFAULTS.csrf, exposeTokens: raw.exposeTokens === true, refreshFromCookie: raw.refreshFromCookie !== false });
+}
+/** Legge i cookie senza aggiungere la dipendenza `cookie-parser`. */
+function parseAccessiCookieHeader(header) {
+    const cookies = {};
+    if (!header)
+        return cookies;
+    for (const part of header.split(';')) {
+        const separator = part.indexOf('=');
+        if (separator < 0)
+            continue;
+        const name = part.slice(0, separator).trim();
+        if (!name)
+            continue;
+        const rawValue = part.slice(separator + 1).trim();
+        try {
+            cookies[name] = decodeURIComponent(rawValue);
+        }
+        catch (_a) {
+            cookies[name] = rawValue;
+        }
+    }
+    return cookies;
+}
+/** True per richieste che modificano stato (dove serve il CSRF). */
+function isAccessiUnsafeMethod(method) {
+    return UNSAFE_METHODS.has(method.toUpperCase());
+}
+/** True per gli endpoint pubblici esenti da CSRF. */
+function isAccessiCsrfExemptPath(path) {
+    return CSRF_EXEMPT_PATHS.some((exempt) => exempt.endsWith('/') ? path.startsWith(exempt) : path === exempt);
+}
+function tokenMaxAgeSeconds(token) {
+    if (!token)
+        return undefined;
+    const decoded = (0, jsonwebtoken_1.decode)(token);
+    if (!decoded || typeof decoded === 'string')
+        return undefined;
+    const exp = Number(decoded.exp);
+    if (!Number.isFinite(exp))
+        return undefined;
+    return Math.max(0, Math.floor(exp - Date.now() / 1000));
+}
+function serializeCookie(name, value, options) {
+    const parts = [`${name}=${encodeURIComponent(value)}`, `Path=${options.path}`];
+    if (options.domain)
+        parts.push(`Domain=${options.domain}`);
+    if (options.maxAgeSeconds !== undefined)
+        parts.push(`Max-Age=${options.maxAgeSeconds}`);
+    if (options.httpOnly)
+        parts.push('HttpOnly');
+    if (options.secure)
+        parts.push('Secure');
+    const sameSite = { strict: 'Strict', lax: 'Lax', none: 'None' }[options.sameSite];
+    parts.push(`SameSite=${sameSite}`);
+    return parts.join('; ');
+}
+function appendCookie(res, cookie) {
+    res.append('Set-Cookie', cookie);
+}
+/** Imposta i cookie access, refresh e (se assente) CSRF. */
+function setAccessiAuthCookies(res, config, tokens) {
+    if (tokens.access) {
+        appendCookie(res, serializeCookie(config.accessTokenName, tokens.access, Object.assign(Object.assign(Object.assign({ path: config.accessPath }, (tokenMaxAgeSeconds(tokens.access) !== undefined
+            ? { maxAgeSeconds: tokenMaxAgeSeconds(tokens.access) }
+            : {})), { httpOnly: true, secure: config.secure, sameSite: config.sameSite }), (config.domain ? { domain: config.domain } : {}))));
+    }
+    if (tokens.refresh) {
+        appendCookie(res, serializeCookie(config.refreshTokenName, tokens.refresh, Object.assign(Object.assign(Object.assign({ path: config.refreshPath }, (tokenMaxAgeSeconds(tokens.refresh) !== undefined
+            ? { maxAgeSeconds: tokenMaxAgeSeconds(tokens.refresh) }
+            : {})), { httpOnly: true, secure: config.secure, sameSite: config.sameSite }), (config.domain ? { domain: config.domain } : {}))));
+    }
+}
+/** Cancella i cookie di sessione (logout/revoca). */
+function clearAccessiAuthCookies(res, config) {
+    for (const [name, path] of [
+        [config.accessTokenName, config.accessPath],
+        [config.refreshTokenName, config.refreshPath],
+        [config.csrfTokenName, config.csrfPath],
+    ]) {
+        appendCookie(res, serializeCookie(name, '', Object.assign({ path, maxAgeSeconds: 0, httpOnly: name !== config.csrfTokenName, secure: config.secure, sameSite: config.sameSite }, (config.domain ? { domain: config.domain } : {}))));
+    }
+}
+function accessiTokenValue(token) {
+    if (typeof token === 'string')
+        return token === '' ? undefined : token;
+    return token === null || token === void 0 ? void 0 : token.value;
+}
+/**
+ * Prepara la risposta di login/refresh: imposta i cookie e rimuove i token dal
+ * body quando la modalita cookie non prevede `exposeTokens`.
+ */
+function applyAccessiAuthCookies(res, config, result) {
+    if (!config)
+        return result;
+    setAccessiAuthCookies(res, config, {
+        access: accessiTokenValue(result.token),
+        refresh: accessiTokenValue(result.refreshToken),
+    });
+    hideAccessiLoginTokens(config, result);
+    return result;
+}
+/** Rimuove i token dal `LoginResult` quando la modalita cookie li nasconde. */
+function hideAccessiLoginTokens(config, result) {
+    if (!config || config.exposeTokens)
+        return;
+    delete result.token;
+    delete result.refreshToken;
+}
+/** Legge l'access token dal cookie (per test e per host senza middleware). */
+function getAccessiAccessTokenFromCookie(header, config) {
+    return parseAccessiCookieHeader(header)[config.accessTokenName];
+}
+/** Legge il refresh token dal cookie. */
+function getAccessiRefreshTokenFromCookie(header, config) {
+    return parseAccessiCookieHeader(header)[config.refreshTokenName];
+}
+function safeEqual(left, right) {
+    const a = Buffer.from(left);
+    const b = Buffer.from(right);
+    return a.length === b.length && (0, crypto_1.timingSafeEqual)(a, b);
+}
+function csrfError(res) {
+    res.status(403).json({
+        severity: 'error',
+        status: 403,
+        statusCode: 2,
+        code: 'AUTH_CSRF_INVALID',
+        error: 'AUTH_CSRF_INVALID',
+        message: 'Token CSRF mancante o non valido.',
+    });
+}
+/**
+ * Middleware della modalita cookie.
+ *
+ * - copia l'access token dal cookie nell'header `Authorization`, cosi guard,
+ *   middleware e controller esistenti funzionano senza modifiche;
+ * - garantisce un cookie CSRF double-submit leggibile dal client;
+ * - blocca le richieste autenticate via cookie che modificano stato senza
+ *   l'header CSRF, salvo endpoint pubblici di bootstrap della sessione.
+ */
+function createAccessiAuthCookieMiddleware(options, isAccessiRoute) {
+    const config = resolveAccessiAuthCookieOptions(options);
+    if (!config)
+        return undefined;
+    return (req, res, next) => {
+        if (!isAccessiRoute(req.path)) {
+            next();
+            return;
+        }
+        const cookies = parseAccessiCookieHeader(req.headers.cookie);
+        let csrfToken = cookies[config.csrfTokenName];
+        if (!csrfToken && config.csrf === 'double-submit') {
+            csrfToken = (0, crypto_1.randomBytes)(32).toString('base64url');
+            appendCookie(res, serializeCookie(config.csrfTokenName, csrfToken, Object.assign({ path: config.csrfPath, httpOnly: false, secure: config.secure, sameSite: config.sameSite }, (config.domain ? { domain: config.domain } : {}))));
+        }
+        if (config.csrf === 'double-submit' && csrfToken) {
+            // Rende il token leggibile anche a una SPA su altra origine (via CORS,
+            // con `Access-Control-Expose-Headers: X-CSRF-Token`).
+            res.setHeader('X-CSRF-Token', csrfToken);
+        }
+        const accessToken = cookies[config.accessTokenName];
+        const hasAuthorization = typeof req.headers.authorization === 'string'
+            && req.headers.authorization.trim() !== '';
+        if (accessToken && !hasAuthorization) {
+            req.headers.authorization = `Bearer ${accessToken}`;
+            if (config.csrf === 'double-submit'
+                && isAccessiUnsafeMethod(req.method)
+                && !isAccessiCsrfExemptPath(req.path)) {
+                const headerValue = req.headers[config.csrfHeaderName];
+                const provided = Array.isArray(headerValue) ? headerValue[0] : headerValue;
+                if (!csrfToken || !provided || !safeEqual(provided, csrfToken)) {
+                    csrfError(res);
+                    return;
+                }
+            }
+        }
+        next();
+    };
+}
+/** True se il nome cookie e valido per l'header `Set-Cookie`. */
+function isValidAccessiCookieName(name) {
+    return COOKIE_NAME.test(name);
+}
+/** Helpers per le combinazioni di cookie supportate (usati dalla validazione). */
+function accessiCookieNames(config) {
+    return [config.accessTokenName, config.refreshTokenName, config.csrfTokenName];
+}
+//# sourceMappingURL=authCookies.js.map

package/dist/accessi-module/security/authCookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authCookies.js","sourceRoot":"","sources":["../../../src/accessi-module/security/authCookies.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes, timingSafeEqual } from 'crypto';\nimport type { NextFunction, Request, Response } from 'express';\nimport type * as jwt from 'jsonwebtoken';\nimport { decode as decodeJwt } from 'jsonwebtoken';\nimport type { AccessiOptions } from '../AccessiModule';\n\n/** Modalita di autenticazione via cookie httpOnly. */\nexport interface AccessiAuthCookieOptions {\n  /** Default `true`: la sola presenza dell'oggetto abilita la modalita cookie. */\n  enabled?: boolean;\n  /** `Secure` sui cookie. Default `true`; disattivare solo in sviluppo locale HTTP. */\n  secure?: boolean;\n  /** Default `lax`. Per SPA su altro dominio serve `none` insieme a `secure: true`. */\n  sameSite?: 'strict' | 'lax' | 'none';\n  /** Dominio dei cookie, opzionale. */\n  domain?: string;\n  /** Nome del cookie con l'access token. Default `accessi_access`. */\n  accessTokenName?: string;\n  /** Nome del cookie con il refresh token. Default `accessi_refresh`. */\n  refreshTokenName?: string;\n  /** Nome del cookie CSRF leggibile dal client. Default `accessi_csrf`. */\n  csrfTokenName?: string;\n  /** Path del cookie access. Default `/api/accessi`. */\n  accessPath?: string;\n  /** Path del cookie refresh. Default `/api/accessi/auth`. */\n  refreshPath?: string;\n  /** Path del cookie CSRF. Default `/`. */\n  csrfPath?: string;\n  /** Header CSRF richiesto. Default `x-csrf-token`. */\n  csrfHeaderName?: string;\n  /** `double-submit` (default) oppure `off` per host che gestiscono CSRF altrove. */\n  csrf?: 'double-submit' | 'off';\n  /**\n   * Restituisce comunque i token nel body JSON. Default `false`: in modalita\n   * cookie i token restano solo negli header httpOnly.\n   */\n  exposeTokens?: boolean;\n  /** Legge il refresh token dal cookie quando il body non lo contiene. Default `true`. */\n  refreshFromCookie?: boolean;\n}\n\nexport type AccessiAuthCookieSetting = AccessiAuthCookieOptions;\n\nexport interface ResolvedAccessiAuthCookieOptions {\n  secure: boolean;\n  sameSite: 'strict' | 'lax' | 'none';\n  domain?: string;\n  accessTokenName: string;\n  refreshTokenName: string;\n  csrfTokenName: string;\n  accessPath: string;\n  refreshPath: string;\n  csrfPath: string;\n  csrfHeaderName: string;\n  csrf: 'double-submit' | 'off';\n  exposeTokens: boolean;\n  refreshFromCookie: boolean;\n}\n\nexport interface AccessiAuthTokenPair {\n  access?: string;\n  refresh?: string;\n}\n\nconst COOKIE_NAME = /^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/;\n\nconst DEFAULTS = {\n  secure: true,\n  sameSite: 'lax' as const,\n  accessTokenName: 'accessi_access',\n  refreshTokenName: 'accessi_refresh',\n  csrfTokenName: 'accessi_csrf',\n  accessPath: '/api/accessi',\n  refreshPath: '/api/accessi/auth',\n  csrfPath: '/',\n  csrfHeaderName: 'x-csrf-token',\n  csrf: 'double-submit' as const,\n  exposeTokens: false,\n  refreshFromCookie: true,\n};\n\n/** Percorsi pubblici che non richiedono il token CSRF (non hanno ancora una sessione). */\nconst CSRF_EXEMPT_PATHS = [\n  '/api/accessi/auth/login',\n  '/api/accessi/auth/refresh',\n  '/api/accessi/auth/confirm-reset-password',\n  '/api/accessi/auth/two-factor/verify',\n  '/api/accessi/auth/two-factor/resend',\n  '/api/accessi/auth/bootstrap-admin',\n  '/api/accessi/email/',\n  '/api/accessi/federated-auth/exchange',\n  '/api/accessi/user/register',\n];\n\nconst UNSAFE_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);\n\n/** Risolve la configurazione dei cookie; `undefined` quando la modalita e disattivata. */\nexport function resolveAccessiAuthCookieOptions(\n  options: Pick<AccessiOptions, 'authCookie'>,\n): ResolvedAccessiAuthCookieOptions | undefined {\n  const raw = options.authCookie;\n  if (!raw || raw.enabled === false) return undefined;\n\n  return {\n    secure: raw.secure !== false,\n    sameSite: raw.sameSite ?? DEFAULTS.sameSite,\n    ...(raw.domain ? { domain: raw.domain } : {}),\n    accessTokenName: raw.accessTokenName ?? DEFAULTS.accessTokenName,\n    refreshTokenName: raw.refreshTokenName ?? DEFAULTS.refreshTokenName,\n    csrfTokenName: raw.csrfTokenName ?? DEFAULTS.csrfTokenName,\n    accessPath: raw.accessPath ?? DEFAULTS.accessPath,\n    refreshPath: raw.refreshPath ?? DEFAULTS.refreshPath,\n    csrfPath: raw.csrfPath ?? DEFAULTS.csrfPath,\n    csrfHeaderName: (raw.csrfHeaderName ?? DEFAULTS.csrfHeaderName).toLowerCase(),\n    csrf: raw.csrf ?? DEFAULTS.csrf,\n    exposeTokens: raw.exposeTokens === true,\n    refreshFromCookie: raw.refreshFromCookie !== false,\n  };\n}\n\n/** Legge i cookie senza aggiungere la dipendenza `cookie-parser`. */\nexport function parseAccessiCookieHeader(header: string | undefined): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!header) return cookies;\n  for (const part of header.split(';')) {\n    const separator = part.indexOf('=');\n    if (separator < 0) continue;\n    const name = part.slice(0, separator).trim();\n    if (!name) continue;\n    const rawValue = part.slice(separator + 1).trim();\n    try {\n      cookies[name] = decodeURIComponent(rawValue);\n    } catch {\n      cookies[name] = rawValue;\n    }\n  }\n  return cookies;\n}\n\n/** True per richieste che modificano stato (dove serve il CSRF). */\nexport function isAccessiUnsafeMethod(method: string): boolean {\n  return UNSAFE_METHODS.has(method.toUpperCase());\n}\n\n/** True per gli endpoint pubblici esenti da CSRF. */\nexport function isAccessiCsrfExemptPath(path: string): boolean {\n  return CSRF_EXEMPT_PATHS.some((exempt) =>\n    exempt.endsWith('/') ? path.startsWith(exempt) : path === exempt,\n  );\n}\n\nfunction tokenMaxAgeSeconds(token: string | undefined): number | undefined {\n  if (!token) return undefined;\n  const decoded = decodeJwt(token) as jwt.JwtPayload | string | null;\n  if (!decoded || typeof decoded === 'string') return undefined;\n  const exp = Number(decoded.exp);\n  if (!Number.isFinite(exp)) return undefined;\n  return Math.max(0, Math.floor(exp - Date.now() / 1000));\n}\n\nfunction serializeCookie(\n  name: string,\n  value: string,\n  options: {\n    path: string;\n    maxAgeSeconds?: number;\n    httpOnly?: boolean;\n    secure: boolean;\n    sameSite: 'strict' | 'lax' | 'none';\n    domain?: string;\n  },\n): string {\n  const parts = [`${name}=${encodeURIComponent(value)}`, `Path=${options.path}`];\n  if (options.domain) parts.push(`Domain=${options.domain}`);\n  if (options.maxAgeSeconds !== undefined) parts.push(`Max-Age=${options.maxAgeSeconds}`);\n  if (options.httpOnly) parts.push('HttpOnly');\n  if (options.secure) parts.push('Secure');\n  const sameSite = { strict: 'Strict', lax: 'Lax', none: 'None' }[options.sameSite];\n  parts.push(`SameSite=${sameSite}`);\n  return parts.join('; ');\n}\n\nfunction appendCookie(res: Pick<Response, 'append'>, cookie: string): void {\n  res.append('Set-Cookie', cookie);\n}\n\n/** Imposta i cookie access, refresh e (se assente) CSRF. */\nexport function setAccessiAuthCookies(\n  res: Pick<Response, 'append'>,\n  config: ResolvedAccessiAuthCookieOptions,\n  tokens: AccessiAuthTokenPair,\n): void {\n  if (tokens.access) {\n    appendCookie(res, serializeCookie(config.accessTokenName, tokens.access, {\n      path: config.accessPath,\n      ...(tokenMaxAgeSeconds(tokens.access) !== undefined\n        ? { maxAgeSeconds: tokenMaxAgeSeconds(tokens.access) }\n        : {}),\n      httpOnly: true,\n      secure: config.secure,\n      sameSite: config.sameSite,\n      ...(config.domain ? { domain: config.domain } : {}),\n    }));\n  }\n  if (tokens.refresh) {\n    appendCookie(res, serializeCookie(config.refreshTokenName, tokens.refresh, {\n      path: config.refreshPath,\n      ...(tokenMaxAgeSeconds(tokens.refresh) !== undefined\n        ? { maxAgeSeconds: tokenMaxAgeSeconds(tokens.refresh) }\n        : {}),\n      httpOnly: true,\n      secure: config.secure,\n      sameSite: config.sameSite,\n      ...(config.domain ? { domain: config.domain } : {}),\n    }));\n  }\n}\n\n/** Cancella i cookie di sessione (logout/revoca). */\nexport function clearAccessiAuthCookies(\n  res: Pick<Response, 'append'>,\n  config: ResolvedAccessiAuthCookieOptions,\n): void {\n  for (const [name, path] of [\n    [config.accessTokenName, config.accessPath],\n    [config.refreshTokenName, config.refreshPath],\n    [config.csrfTokenName, config.csrfPath],\n  ] as const) {\n    appendCookie(res, serializeCookie(name, '', {\n      path,\n      maxAgeSeconds: 0,\n      httpOnly: name !== config.csrfTokenName,\n      secure: config.secure,\n      sameSite: config.sameSite,\n      ...(config.domain ? { domain: config.domain } : {}),\n    }));\n  }\n}\n\nexport interface AccessiAuthTokenValue {\n  value?: string;\n}\n\n/** Forma comune dei risultati di auth: stringa o `TokenResult` di Accessi. */\nexport interface AccessiAuthResultLike {\n  token?: string | AccessiAuthTokenValue;\n  refreshToken?: string | AccessiAuthTokenValue;\n}\n\nfunction accessiTokenValue(token: string | AccessiAuthTokenValue | undefined): string | undefined {\n  if (typeof token === 'string') return token === '' ? undefined : token;\n  return token?.value;\n}\n\n/**\n * Prepara la risposta di login/refresh: imposta i cookie e rimuove i token dal\n * body quando la modalita cookie non prevede `exposeTokens`.\n */\nexport function applyAccessiAuthCookies<T extends AccessiAuthResultLike>(\n  res: Pick<Response, 'append'>,\n  config: ResolvedAccessiAuthCookieOptions | undefined,\n  result: T,\n): T {\n  if (!config) return result;\n  setAccessiAuthCookies(res, config, {\n    access: accessiTokenValue(result.token),\n    refresh: accessiTokenValue(result.refreshToken),\n  });\n  hideAccessiLoginTokens(config, result);\n  return result;\n}\n\n/** Rimuove i token dal `LoginResult` quando la modalita cookie li nasconde. */\nexport function hideAccessiLoginTokens(\n  config: ResolvedAccessiAuthCookieOptions | undefined,\n  result: { token?: unknown; refreshToken?: unknown },\n): void {\n  if (!config || config.exposeTokens) return;\n  delete result.token;\n  delete result.refreshToken;\n}\n\n/** Legge l'access token dal cookie (per test e per host senza middleware). */\nexport function getAccessiAccessTokenFromCookie(\n  header: string | undefined,\n  config: ResolvedAccessiAuthCookieOptions,\n): string | undefined {\n  return parseAccessiCookieHeader(header)[config.accessTokenName];\n}\n\n/** Legge il refresh token dal cookie. */\nexport function getAccessiRefreshTokenFromCookie(\n  header: string | undefined,\n  config: ResolvedAccessiAuthCookieOptions,\n): string | undefined {\n  return parseAccessiCookieHeader(header)[config.refreshTokenName];\n}\n\nfunction safeEqual(left: string, right: string): boolean {\n  const a = Buffer.from(left);\n  const b = Buffer.from(right);\n  return a.length === b.length && timingSafeEqual(a, b);\n}\n\nfunction csrfError(res: Response): void {\n  res.status(403).json({\n    severity: 'error',\n    status: 403,\n    statusCode: 2,\n    code: 'AUTH_CSRF_INVALID',\n    error: 'AUTH_CSRF_INVALID',\n    message: 'Token CSRF mancante o non valido.',\n  });\n}\n\n/**\n * Middleware della modalita cookie.\n *\n * - copia l'access token dal cookie nell'header `Authorization`, cosi guard,\n *   middleware e controller esistenti funzionano senza modifiche;\n * - garantisce un cookie CSRF double-submit leggibile dal client;\n * - blocca le richieste autenticate via cookie che modificano stato senza\n *   l'header CSRF, salvo endpoint pubblici di bootstrap della sessione.\n */\nexport function createAccessiAuthCookieMiddleware(\n  options: Pick<AccessiOptions, 'authCookie'>,\n  isAccessiRoute: (path: string) => boolean,\n): ((req: Request, res: Response, next: NextFunction) => void) | undefined {\n  const config = resolveAccessiAuthCookieOptions(options);\n  if (!config) return undefined;\n\n  return (req: Request, res: Response, next: NextFunction): void => {\n    if (!isAccessiRoute(req.path)) {\n      next();\n      return;\n    }\n\n    const cookies = parseAccessiCookieHeader(req.headers.cookie);\n    let csrfToken = cookies[config.csrfTokenName];\n    if (!csrfToken && config.csrf === 'double-submit') {\n      csrfToken = randomBytes(32).toString('base64url');\n      appendCookie(res, serializeCookie(config.csrfTokenName, csrfToken, {\n        path: config.csrfPath,\n        httpOnly: false,\n        secure: config.secure,\n        sameSite: config.sameSite,\n        ...(config.domain ? { domain: config.domain } : {}),\n      }));\n    }\n    if (config.csrf === 'double-submit' && csrfToken) {\n      // Rende il token leggibile anche a una SPA su altra origine (via CORS,\n      // con `Access-Control-Expose-Headers: X-CSRF-Token`).\n      res.setHeader('X-CSRF-Token', csrfToken);\n    }\n\n    const accessToken = cookies[config.accessTokenName];\n    const hasAuthorization = typeof req.headers.authorization === 'string'\n      && req.headers.authorization.trim() !== '';\n    if (accessToken && !hasAuthorization) {\n      req.headers.authorization = `Bearer ${accessToken}`;\n\n      if (\n        config.csrf === 'double-submit'\n        && isAccessiUnsafeMethod(req.method)\n        && !isAccessiCsrfExemptPath(req.path)\n      ) {\n        const headerValue = req.headers[config.csrfHeaderName];\n        const provided = Array.isArray(headerValue) ? headerValue[0] : headerValue;\n        if (!csrfToken || !provided || !safeEqual(provided, csrfToken)) {\n          csrfError(res);\n          return;\n        }\n      }\n    }\n\n    next();\n  };\n}\n\n/** True se il nome cookie e valido per l'header `Set-Cookie`. */\nexport function isValidAccessiCookieName(name: string): boolean {\n  return COOKIE_NAME.test(name);\n}\n\n/** Helpers per le combinazioni di cookie supportate (usati dalla validazione). */\nexport function accessiCookieNames(config: ResolvedAccessiAuthCookieOptions): string[] {\n  return [config.accessTokenName, config.refreshTokenName, config.csrfTokenName];\n}\n"]}

package/dist/accessi-module/security/authenticatedToken.d.ts

@@ -1,11 +1,31 @@
 import { StatoRegistrazione } from '../Dtos/StatoRegistrazione';
+/** Stato autorevole minimo riletto dal database per ogni verifica JWT. */
 export interface AccessiAuthenticatedUserSnapshot {
     codiceUtente: number;
     email?: string;
     statoRegistrazione: StatoRegistrazione;
     flagSuper: boolean;
-    flagAdminConfigurator: boolean;
+    flagAdmin: boolean;
+    flagDueFattori?: boolean;
+    passwordlessLoginEnabled?: boolean;
+    passwordLoginEnabled?: boolean;
 }
-export declare function resolveCodiceUtenteFromTokenPayload(decoded: unknown): number | undefined;
+/** Shared, strict Bearer parsing for the Nest guard and Express middleware. */
+export declare function extractAccessiBearerToken(header: unknown): string | undefined;
+/** Estrae il codice utente sia dai JWT Accessi moderni sia dai payload legacy compatibili. */
+export declare function resolveCodiceUtenteFromTokenPayload(decoded: unknown, expectedType?: 'access' | 'refresh'): number | undefined;
+/**
+ * Mantiene le claim estranee al modulo ma sovrascrive il profilo con valori correnti e autorevoli dal database.
+ * `tokenPayload` conserva il payload verificato originale per audit o integrazioni che ne abbiano necessita.
+ */
 export declare function buildAuthenticatedTokenPayload(decoded: unknown, utente: AccessiAuthenticatedUserSnapshot): Record<string, unknown>;
-export declare function isAuthenticatedUserEnabledForJwt(utente: AccessiAuthenticatedUserSnapshot | null | undefined): boolean;
+/**
+ * Riconosce i token emessi dalla console per l'accesso temporaneo "Login as".
+ * L'attore ha gia completato l'autenticazione amministrativa, quindi il token
+ * non richiede un ulteriore codice email anche se il target ha la 2FA attiva.
+ */
+export declare function isLoginAsTokenPayload(decoded: unknown): boolean;
+/** Enabling 2FA invalidates sessions which have not completed the required verification. */
+export declare function isAccessiTokenAllowedForUser(decoded: unknown, user: AccessiAuthenticatedUserSnapshot): boolean;
+/** Un JWT puo essere usato soltanto da utenti nello stato confermato, indipendentemente dalla sua scadenza. */
+export declare function isAuthenticatedUserEnabledForJwt(utente: AccessiAuthenticatedUserSnapshot | null | undefined): utente is AccessiAuthenticatedUserSnapshot;

package/dist/accessi-module/security/authenticatedToken.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractAccessiBearerToken = extractAccessiBearerToken;
 exports.resolveCodiceUtenteFromTokenPayload = resolveCodiceUtenteFromTokenPayload;
 exports.buildAuthenticatedTokenPayload = buildAuthenticatedTokenPayload;
+exports.isLoginAsTokenPayload = isLoginAsTokenPayload;
+exports.isAccessiTokenAllowedForUser = isAccessiTokenAllowedForUser;
 exports.isAuthenticatedUserEnabledForJwt = isAuthenticatedUserEnabledForJwt;
 const StatoRegistrazione_1 = require("../Dtos/StatoRegistrazione");
 function normalizeBooleanFlag(value) {
@@ -10,9 +13,18 @@ function normalizeBooleanFlag(value) {
 function isRecord(value) {
     return typeof value === 'object' && value !== null;
 }
-function resolveCodiceUtenteFromTokenPayload(decoded) {
+/** Shared, strict Bearer parsing for the Nest guard and Express middleware. */
+function extractAccessiBearerToken(header) {
     var _a;
-    if (!isRecord(decoded)) {
+    if (typeof header !== 'string')
+        return undefined;
+    return (_a = /^Bearer[ \t]+([^\s]+)$/i.exec(header.trim())) === null || _a === void 0 ? void 0 : _a[1];
+}
+/** Estrae il codice utente sia dai JWT Accessi moderni sia dai payload legacy compatibili. */
+function resolveCodiceUtenteFromTokenPayload(decoded, expectedType = 'access') {
+    var _a;
+    // `typ` obbligatorio: un token senza tipo non e un token Accessi valido.
+    if (!isRecord(decoded) || decoded.typ !== expectedType) {
         return undefined;
     }
     const userData = isRecord(decoded.userData) ? decoded.userData : undefined;
@@ -22,17 +34,45 @@ function resolveCodiceUtenteFromTokenPayload(decoded) {
             ? userData.utente
             : undefined;
     const codiceUtente = Number((_a = utente === null || utente === void 0 ? void 0 : utente.codiceUtente) !== null && _a !== void 0 ? _a : decoded.codiceUtente);
-    if (!Number.isFinite(codiceUtente) || codiceUtente <= 0) {
+    if (!Number.isSafeInteger(codiceUtente) || codiceUtente <= 0) {
         return undefined;
     }
     return codiceUtente;
 }
+/**
+ * Mantiene le claim estranee al modulo ma sovrascrive il profilo con valori correnti e autorevoli dal database.
+ * `tokenPayload` conserva il payload verificato originale per audit o integrazioni che ne abbiano necessita.
+ */
 function buildAuthenticatedTokenPayload(decoded, utente) {
     const basePayload = isRecord(decoded) ? Object.assign({}, decoded) : {};
     const userData = isRecord(basePayload.userData) ? Object.assign({}, basePayload.userData) : {};
-    const normalizedUser = Object.assign(Object.assign({}, utente), { flagSuper: normalizeBooleanFlag(utente.flagSuper), flagAdminConfigurator: normalizeBooleanFlag(utente.flagAdminConfigurator) });
-    return Object.assign(Object.assign({}, basePayload), { utente: normalizedUser, userData: Object.assign(Object.assign({}, userData), { utente: normalizedUser }), tokenPayload: decoded });
+    const normalizedUser = Object.assign(Object.assign({}, utente), { flagSuper: normalizeBooleanFlag(utente.flagSuper), flagAdmin: normalizeBooleanFlag(utente.flagAdmin), flagDueFattori: normalizeBooleanFlag(utente.flagDueFattori), passwordlessLoginEnabled: normalizeBooleanFlag(utente.passwordlessLoginEnabled) });
+    return Object.assign(Object.assign({}, basePayload), { codiceUtente: normalizedUser.codiceUtente, email: normalizedUser.email, statoRegistrazione: normalizedUser.statoRegistrazione, flagSuper: normalizedUser.flagSuper, flagAdmin: normalizedUser.flagAdmin, flagDueFattori: normalizedUser.flagDueFattori, passwordlessLoginEnabled: normalizedUser.passwordlessLoginEnabled, passwordLoginEnabled: normalizedUser.passwordLoginEnabled, utente: normalizedUser, userData: Object.assign(Object.assign({}, userData), { utente: normalizedUser }), tokenPayload: decoded });
+}
+/**
+ * Riconosce i token emessi dalla console per l'accesso temporaneo "Login as".
+ * L'attore ha gia completato l'autenticazione amministrativa, quindi il token
+ * non richiede un ulteriore codice email anche se il target ha la 2FA attiva.
+ */
+function isLoginAsTokenPayload(decoded) {
+    if (!isRecord(decoded) || decoded.loginAs !== true)
+        return false;
+    return Array.isArray(decoded.amr) && decoded.amr.includes('login_as');
+}
+/** Enabling 2FA invalidates sessions which have not completed the required verification. */
+function isAccessiTokenAllowedForUser(decoded, user) {
+    if (!isRecord(decoded))
+        return false;
+    if (isLoginAsTokenPayload(decoded))
+        return true;
+    const methods = Array.isArray(decoded.amr) ? decoded.amr : [];
+    if (user.flagDueFattori && !methods.includes('otp'))
+        return false;
+    if (methods.includes('passwordless') && (!user.flagDueFattori || !user.passwordlessLoginEnabled))
+        return false;
+    return true;
 }
+/** Un JWT puo essere usato soltanto da utenti nello stato confermato, indipendentemente dalla sua scadenza. */
 function isAuthenticatedUserEnabledForJwt(utente) {
     return (utente === null || utente === void 0 ? void 0 : utente.statoRegistrazione) === StatoRegistrazione_1.StatoRegistrazione.CONF;
 }

package/dist/accessi-module/security/authenticatedToken.js.map

@@ -1 +1 @@
-{"version":3,"file":"authenticatedToken.js","sourceRoot":"","sources":["../../../src/accessi-module/security/authenticatedToken.ts"],"names":[],"mappings":";;AAkBA,kFAkBC;AAED,wEAsBC;AAED,4EAIC;AAlED,mEAAgE;AAUhE,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG,CAAC;AACxD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAgB,mCAAmC,CAAC,OAAgB;;IAClE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QACrC,CAAC,CAAC,OAAO,CAAC,MAAM;QAChB,CAAC,CAAC,QAAQ,CAAC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,CAAC;YAC1B,CAAC,CAAC,QAAQ,CAAC,MAAM;YACjB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,YAAY,GAAG,MAAM,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,YAAY,mCAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAgB,8BAA8B,CAC5C,OAAgB,EAChB,MAAwC;IAExC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAM,OAAO,EAAG,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAM,WAAW,CAAC,QAAQ,EAAG,CAAC,CAAC,EAAE,CAAC;IAEnF,MAAM,cAAc,mCACf,MAAM,KACT,SAAS,EAAE,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,EACjD,qBAAqB,EAAE,oBAAoB,CAAC,MAAM,CAAC,qBAAqB,CAAC,GAC1E,CAAC;IAEF,uCACK,WAAW,KACd,MAAM,EAAE,cAAc,EACtB,QAAQ,kCACH,QAAQ,KACX,MAAM,EAAE,cAAc,KAExB,YAAY,EAAE,OAAO,IACrB;AACJ,CAAC;AAED,SAAgB,gCAAgC,CAC9C,MAA2D;IAE3D,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,kBAAkB,MAAK,uCAAkB,CAAC,IAAI,CAAC;AAChE,CAAC","sourcesContent":["import { StatoRegistrazione } from '../Dtos/StatoRegistrazione';\r\n\r\nexport interface AccessiAuthenticatedUserSnapshot {\r\n  codiceUtente: number;\r\n  email?: string;\r\n  statoRegistrazione: StatoRegistrazione;\r\n  flagSuper: boolean;\r\n  flagAdminConfigurator: boolean;\r\n}\r\n\r\nfunction normalizeBooleanFlag(value: unknown): boolean {\r\n  return value === true || value === 1 || value === '1';\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n  return typeof value === 'object' && value !== null;\r\n}\r\n\r\nexport function resolveCodiceUtenteFromTokenPayload(decoded: unknown): number | undefined {\r\n  if (!isRecord(decoded)) {\r\n    return undefined;\r\n  }\r\n\r\n  const userData = isRecord(decoded.userData) ? decoded.userData : undefined;\r\n  const utente = isRecord(decoded.utente)\r\n    ? decoded.utente\r\n    : isRecord(userData?.utente)\r\n      ? userData.utente\r\n      : undefined;\r\n\r\n  const codiceUtente = Number(utente?.codiceUtente ?? decoded.codiceUtente);\r\n  if (!Number.isFinite(codiceUtente) || codiceUtente <= 0) {\r\n    return undefined;\r\n  }\r\n\r\n  return codiceUtente;\r\n}\r\n\r\nexport function buildAuthenticatedTokenPayload(\r\n  decoded: unknown,\r\n  utente: AccessiAuthenticatedUserSnapshot,\r\n): Record<string, unknown> {\r\n  const basePayload = isRecord(decoded) ? { ...decoded } : {};\r\n  const userData = isRecord(basePayload.userData) ? { ...basePayload.userData } : {};\r\n\r\n  const normalizedUser = {\r\n    ...utente,\r\n    flagSuper: normalizeBooleanFlag(utente.flagSuper),\r\n    flagAdminConfigurator: normalizeBooleanFlag(utente.flagAdminConfigurator),\r\n  };\r\n\r\n  return {\r\n    ...basePayload,\r\n    utente: normalizedUser,\r\n    userData: {\r\n      ...userData,\r\n      utente: normalizedUser,\r\n    },\r\n    tokenPayload: decoded,\r\n  };\r\n}\r\n\r\nexport function isAuthenticatedUserEnabledForJwt(\r\n  utente: AccessiAuthenticatedUserSnapshot | null | undefined,\r\n): boolean {\r\n  return utente?.statoRegistrazione === StatoRegistrazione.CONF;\r\n}\r\n"]}
+{"version":3,"file":"authenticatedToken.js","sourceRoot":"","sources":["../../../src/accessi-module/security/authenticatedToken.ts"],"names":[],"mappings":";;AAuBA,8DAGC;AAGD,kFAsBC;AAMD,wEAgCC;AAOD,sDAGC;AAGD,oEAOC;AAGD,4EAIC;AApHD,mEAAgE;AAchE,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG,CAAC;AACxD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,SAAgB,yBAAyB,CAAC,MAAe;;IACvD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,MAAA,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,0CAAG,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,8FAA8F;AAC9F,SAAgB,mCAAmC,CACjD,OAAgB,EAChB,eAAqC,QAAQ;;IAE7C,yEAAyE;IACzE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,KAAK,YAAY,EAAE,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QACrC,CAAC,CAAC,OAAO,CAAC,MAAM;QAChB,CAAC,CAAC,QAAQ,CAAC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,CAAC;YAC1B,CAAC,CAAC,QAAQ,CAAC,MAAM;YACjB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,YAAY,GAAG,MAAM,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,YAAY,mCAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,8BAA8B,CAC5C,OAAgB,EAChB,MAAwC;IAExC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAM,OAAO,EAAG,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAM,WAAW,CAAC,QAAQ,EAAG,CAAC,CAAC,EAAE,CAAC;IAEnF,MAAM,cAAc,mCACf,MAAM,KACT,SAAS,EAAE,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,EACjD,SAAS,EAAE,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,EACjD,cAAc,EAAE,oBAAoB,CAAC,MAAM,CAAC,cAAc,CAAC,EAC3D,wBAAwB,EAAE,oBAAoB,CAAC,MAAM,CAAC,wBAAwB,CAAC,GAChF,CAAC;IAEF,uCACK,WAAW,KACd,YAAY,EAAE,cAAc,CAAC,YAAY,EACzC,KAAK,EAAE,cAAc,CAAC,KAAK,EAC3B,kBAAkB,EAAE,cAAc,CAAC,kBAAkB,EACrD,SAAS,EAAE,cAAc,CAAC,SAAS,EACnC,SAAS,EAAE,cAAc,CAAC,SAAS,EACnC,cAAc,EAAE,cAAc,CAAC,cAAc,EAC7C,wBAAwB,EAAE,cAAc,CAAC,wBAAwB,EACjE,oBAAoB,EAAE,cAAc,CAAC,oBAAoB,EACzD,MAAM,EAAE,cAAc,EACtB,QAAQ,kCACH,QAAQ,KACX,MAAM,EAAE,cAAc,KAExB,YAAY,EAAE,OAAO,IACrB;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjE,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACxE,CAAC;AAED,4FAA4F;AAC5F,SAAgB,4BAA4B,CAAC,OAAgB,EAAE,IAAsC;IACnG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,qBAAqB,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/G,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+GAA+G;AAC/G,SAAgB,gCAAgC,CAC9C,MAA2D;IAE3D,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,kBAAkB,MAAK,uCAAkB,CAAC,IAAI,CAAC;AAChE,CAAC","sourcesContent":["import { StatoRegistrazione } from '../Dtos/StatoRegistrazione';\n\n/** Stato autorevole minimo riletto dal database per ogni verifica JWT. */\nexport interface AccessiAuthenticatedUserSnapshot {\n  codiceUtente: number;\n  email?: string;\n  statoRegistrazione: StatoRegistrazione;\n  flagSuper: boolean;\n  flagAdmin: boolean;\n  flagDueFattori?: boolean;\n  passwordlessLoginEnabled?: boolean;\n  passwordLoginEnabled?: boolean;\n}\n\nfunction normalizeBooleanFlag(value: unknown): boolean {\n  return value === true || value === 1 || value === '1';\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\n/** Shared, strict Bearer parsing for the Nest guard and Express middleware. */\nexport function extractAccessiBearerToken(header: unknown): string | undefined {\n  if (typeof header !== 'string') return undefined;\n  return /^Bearer[ \\t]+([^\\s]+)$/i.exec(header.trim())?.[1];\n}\n\n/** Estrae il codice utente sia dai JWT Accessi moderni sia dai payload legacy compatibili. */\nexport function resolveCodiceUtenteFromTokenPayload(\n  decoded: unknown,\n  expectedType: 'access' | 'refresh' = 'access',\n): number | undefined {\n  // `typ` obbligatorio: un token senza tipo non e un token Accessi valido.\n  if (!isRecord(decoded) || decoded.typ !== expectedType) {\n    return undefined;\n  }\n\n  const userData = isRecord(decoded.userData) ? decoded.userData : undefined;\n  const utente = isRecord(decoded.utente)\n    ? decoded.utente\n    : isRecord(userData?.utente)\n      ? userData.utente\n      : undefined;\n\n  const codiceUtente = Number(utente?.codiceUtente ?? decoded.codiceUtente);\n  if (!Number.isSafeInteger(codiceUtente) || codiceUtente <= 0) {\n    return undefined;\n  }\n\n  return codiceUtente;\n}\n\n/**\n * Mantiene le claim estranee al modulo ma sovrascrive il profilo con valori correnti e autorevoli dal database.\n * `tokenPayload` conserva il payload verificato originale per audit o integrazioni che ne abbiano necessita.\n */\nexport function buildAuthenticatedTokenPayload(\n  decoded: unknown,\n  utente: AccessiAuthenticatedUserSnapshot,\n): Record<string, unknown> {\n  const basePayload = isRecord(decoded) ? { ...decoded } : {};\n  const userData = isRecord(basePayload.userData) ? { ...basePayload.userData } : {};\n\n  const normalizedUser = {\n    ...utente,\n    flagSuper: normalizeBooleanFlag(utente.flagSuper),\n    flagAdmin: normalizeBooleanFlag(utente.flagAdmin),\n    flagDueFattori: normalizeBooleanFlag(utente.flagDueFattori),\n    passwordlessLoginEnabled: normalizeBooleanFlag(utente.passwordlessLoginEnabled),\n  };\n\n  return {\n    ...basePayload,\n    codiceUtente: normalizedUser.codiceUtente,\n    email: normalizedUser.email,\n    statoRegistrazione: normalizedUser.statoRegistrazione,\n    flagSuper: normalizedUser.flagSuper,\n    flagAdmin: normalizedUser.flagAdmin,\n    flagDueFattori: normalizedUser.flagDueFattori,\n    passwordlessLoginEnabled: normalizedUser.passwordlessLoginEnabled,\n    passwordLoginEnabled: normalizedUser.passwordLoginEnabled,\n    utente: normalizedUser,\n    userData: {\n      ...userData,\n      utente: normalizedUser,\n    },\n    tokenPayload: decoded,\n  };\n}\n\n/**\n * Riconosce i token emessi dalla console per l'accesso temporaneo \"Login as\".\n * L'attore ha gia completato l'autenticazione amministrativa, quindi il token\n * non richiede un ulteriore codice email anche se il target ha la 2FA attiva.\n */\nexport function isLoginAsTokenPayload(decoded: unknown): boolean {\n  if (!isRecord(decoded) || decoded.loginAs !== true) return false;\n  return Array.isArray(decoded.amr) && decoded.amr.includes('login_as');\n}\n\n/** Enabling 2FA invalidates sessions which have not completed the required verification. */\nexport function isAccessiTokenAllowedForUser(decoded: unknown, user: AccessiAuthenticatedUserSnapshot): boolean {\n  if (!isRecord(decoded)) return false;\n  if (isLoginAsTokenPayload(decoded)) return true;\n  const methods = Array.isArray(decoded.amr) ? decoded.amr : [];\n  if (user.flagDueFattori && !methods.includes('otp')) return false;\n  if (methods.includes('passwordless') && (!user.flagDueFattori || !user.passwordlessLoginEnabled)) return false;\n  return true;\n}\n\n/** Un JWT puo essere usato soltanto da utenti nello stato confermato, indipendentemente dalla sua scadenza. */\nexport function isAuthenticatedUserEnabledForJwt(\n  utente: AccessiAuthenticatedUserSnapshot | null | undefined,\n): utente is AccessiAuthenticatedUserSnapshot {\n  return utente?.statoRegistrazione === StatoRegistrazione.CONF;\n}\n"]}

package/dist/accessi-module/security/consoleEntry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Ticket di ingresso alla console, monouso e a breve scadenza.
+ *
+ * Serve a passare una sessione gia autenticata (frontend che possiede un JWT Accessi)
+ * alla console amministrativa senza reinserire le credenziali e senza mettere il JWT
+ * nell'URL: il frontend scambia il proprio JWT con un ticket opaco, apre la console
+ * con `#entry=<ticket>` e la console lo scambia con il token originale.
+ *
+ * Il ticket e valido una sola volta, per pochi secondi, ed e legato all'utente che
+ * lo ha richiesto (che deve avere accesso alla console). Lo store di default e in
+ * memoria; in multi-istanza usare `createRedisConsoleEntryStore`.
+ */
+export interface ConsoleEntryRecord {
+    token: string;
+    codiceUtente: number;
+}
+export interface ConsoleEntryTicket {
+    ticket: string;
+    expiresInSeconds: number;
+}
+/** Store pluggable: memoria per single instance, Redis per multi-istanza. */
+export interface ConsoleEntryStore {
+    issue(record: ConsoleEntryRecord, ttlMs: number): Promise<ConsoleEntryTicket>;
+    consume(ticket: string): Promise<ConsoleEntryRecord | null>;
+    /** Health check opzionale per readiness del servizio. */
+    healthCheck?(): Promise<boolean>;
+}
+/** Store in memoria con API sincrona per retrocompatibilita e API async per l'interfaccia. */
+export interface MemoryConsoleEntryStore extends ConsoleEntryStore {
+    issueSync(record: ConsoleEntryRecord, ttlMs?: number): ConsoleEntryTicket;
+    consumeSync(ticket: string): ConsoleEntryRecord | null;
+    clear(): void;
+}
+/** Store in memoria: adatto a sviluppo e a una singola istanza. */
+export declare function createMemoryConsoleEntryStore(maxEntries?: number): MemoryConsoleEntryStore;
+/** Store di default in memoria, usato quando `AccessiOptions.consoleEntry.store` non e configurato. */
+export declare function getDefaultConsoleEntryStore(): ConsoleEntryStore;
+export declare function issueConsoleEntryTicket(record: ConsoleEntryRecord, ttlMs?: number): ConsoleEntryTicket;
+export declare function consumeConsoleEntryTicket(ticket: unknown): ConsoleEntryRecord | null;
+/** Solo per i test: azzera lo store in memoria di default. */
+export declare function clearConsoleEntryTickets(): void;
+/** Client Redis minimale: compatibile con ioredis (`redis.eval(script, numKeys, ...args)`). */
+export interface ConsoleEntryRedisClient {
+    eval(script: string, numKeys: number, ...args: Array<string | number>): Promise<unknown>;
+}
+export interface RedisConsoleEntryStoreOptions {
+    client: ConsoleEntryRedisClient;
+    /** Segreto per cifrare il JWT nel Redis. Non usare il JWT in chiaro. */
+    encryptionKey: string | Buffer;
+    /** Default: `accessi:console-entry:`. */
+    keyPrefix?: string;
+    /** Tentativi in caso di collisione del ticket. Default: 5. */
+    maxIssueAttempts?: number;
+}
+/**
+ * Store Redis per ticket console.
+ *
+ * - il JWT viene cifrato con AES-256-GCM prima di essere scritto;
+ * - `SET ... PX ... NX` evita collisioni;
+ * - il consume usa `GET` + `DEL` atomici in Lua, quindi il ticket e monouso
+ *   anche con piu istanze.
+ */
+export declare function createRedisConsoleEntryStore(options: RedisConsoleEntryStoreOptions): ConsoleEntryStore;