@adonis-agora/authkit-server 0.55.0 → 0.55.2

package/build/src/host/impersonation_session.d.ts

@@ -44,8 +44,15 @@ export declare function startImpersonation(ctx: HttpContext, params: StartImpers
  */
 export declare function impersonationState(ctx: HttpContext): ImpersonationState;
 /**
- * Encerra a impersonation: restaura `account_user_id = impersonator`, limpa TODAS
- * as keys de impersonation (impersonator + access token do admin) e regenera a
- * sessão (anti-fixation). No-op quando não há impersonation ativa.
+ * Encerra a impersonation: restaura `account_user_id = impersonator`, remove a
+ * key de impersonation e regenera a sessão (anti-fixation). No-op quando não há
+ * impersonation ativa.
+ *
+ * O `admin_access_token` (a credencial do ADMIN usada como `subject_token` do
+ * token-exchange) é PRESERVADO: ele é do admin — não do alvo — e o admin segue
+ * logado após o stop. Removê-lo forçava um relogin a cada vez que o admin
+ * personificava, saía e tentava personificar de novo (No admin access token in
+ * session). O token segue curto (TTL do access token do RP) e o logout do app
+ * (`ctx.session.clear()` em `AuthRpController.logout`) continua limpando tudo.
  */
 export declare function stopImpersonation(ctx: HttpContext): Promise<void>;

package/build/src/host/impersonation_session.js

@@ -121,9 +121,16 @@ export function impersonationState(ctx) {
     return { active: true, targetId, impersonatorId };
 }
 /**
- * Encerra a impersonation: restaura `account_user_id = impersonator`, limpa TODAS
- * as keys de impersonation (impersonator + access token do admin) e regenera a
- * sessão (anti-fixation). No-op quando não há impersonation ativa.
+ * Encerra a impersonation: restaura `account_user_id = impersonator`, remove a
+ * key de impersonation e regenera a sessão (anti-fixation). No-op quando não há
+ * impersonation ativa.
+ *
+ * O `admin_access_token` (a credencial do ADMIN usada como `subject_token` do
+ * token-exchange) é PRESERVADO: ele é do admin — não do alvo — e o admin segue
+ * logado após o stop. Removê-lo forçava um relogin a cada vez que o admin
+ * personificava, saía e tentava personificar de novo (No admin access token in
+ * session). O token segue curto (TTL do access token do RP) e o logout do app
+ * (`ctx.session.clear()` em `AuthRpController.logout`) continua limpando tudo.
  */
 export async function stopImpersonation(ctx) {
     const impersonatorId = ctx.session.get(IMPERSONATOR_SESSION_KEY);
@@ -139,5 +146,4 @@ export async function stopImpersonation(ctx) {
     // confirmação dele, sobre a conta dele, dentro da janela dele.
     ctx.session.put(ACCOUNT_SESSION_KEY, impersonatorId);
     ctx.session.forget(IMPERSONATOR_SESSION_KEY);
-    ctx.session.forget(ADMIN_ACCESS_TOKEN_SESSION_KEY);
 }

package/build/src/provider/oidc_service.js

@@ -128,6 +128,11 @@ export class OidcService {
                 findAccount: config.findAccount,
                 globalRolesClaim: config.globalRolesClaim,
                 resolveTokenRoles: config.resolveTokenRoles,
+                // Allowlist de roles que autorizam impersonation — a MESMA de
+                // `config.admin.roles` usada pelos guards do console (default
+                // `['ADMIN']`). Permite que um host use papel próprio (ex.: `admin`
+                // minúsculo num store de roles próprio) sem alterar `globalRoles`.
+                adminRoles: config.admin.roles,
                 // Resource indicators (RFC 8707) suportados: o `audience` default + cada
                 // resource declarado. Usado para validar `audience`/`resource` no pedido de
                 // token-exchange — alvos fora desta lista são rejeitados (invalid_target).

package/build/src/provider/token_exchange.d.ts

@@ -14,6 +14,11 @@ export interface TokenExchangeDeps {
      * `target.globalRoles ?? []` (unchanged behavior). Mirrors the mint-time hook used
      * by the authorization-code flow so impersonated tokens source roles from the same
      * authority (e.g. @adonis-agora/authz) or custom store.
+     *
+     * The SAME hook also gates the ACTOR (the admin trying to impersonate): its roles
+     * are resolved through it too, so an app that keeps roles in its own table
+     * (e.g. via `@adonis-agora/authz`) can impersonate without storing roles in the
+     * authkit `globalRoles` column. When omitted, falls back to `actor.globalRoles`.
      */
     resolveTokenRoles?: (account: AuthAccount, context: {
         clientId?: string;
@@ -23,6 +28,14 @@ export interface TokenExchangeDeps {
             orgRole: string;
         } | null;
     }) => string[] | Promise<string[]>;
+    /**
+     * Allowlist de roles que autorizam a impersonation. Default: `['ADMIN']`.
+     * Aceita o papel EXATO (ex.: `'admin'` minúsculo) do app — resolve contra a
+     * MESMA fonte de roles do `resolveTokenRoles`/`globalRoles`, não a um papel
+     * hardcoded. Mantém `adminRole` como alias singular para back-compat.
+     */
+    adminRoles?: string[];
+    /** @deprecated Use `adminRoles` (allowlist). Mantido como alias singular. */
     adminRole?: string;
     /**
      * Resource indicators (RFC 8707) suportados pelo provider. Quando o pedido traz

package/build/src/provider/token_exchange.js

@@ -16,7 +16,7 @@ function intersectScopes(requested, allowed) {
     return out.join(' ');
 }
 export function registerTokenExchange(provider, deps) {
-    const adminRole = deps.adminRole ?? 'ADMIN';
+    const adminRoles = deps.adminRoles ?? (deps.adminRole ? [deps.adminRole] : ['ADMIN']);
     const supportedResources = new Set(deps.supportedResources ?? []);
     const handler = async (ctx) => {
         const { params, client } = ctx.oidc;
@@ -36,7 +36,22 @@ export function registerTokenExchange(provider, deps) {
             throw new errors.InvalidGrant('subject_token was not issued to this client');
         }
         const actor = await deps.findAccount(subjectAt.accountId);
-        if (!actor || !(actor.globalRoles ?? []).includes(adminRole)) {
+        if (!actor) {
+            throw new errors.InvalidGrant('actor not permitted to impersonate');
+        }
+        // Resolve as roles do ATOR pela MESMA fonte do claim (resolveTokenRoles
+        // quando o host configura — ex.: roles em tabela própria via
+        // `@adonis-agora/authz`), com fallback pro `globalRoles` do store. Sem isso
+        // um host que não grava roles na coluna `globalRoles` do authkit nunca
+        // conseguiria impersonar (o gate bateria sempre em `[]`). Mesmo padrão do
+        // console (`resolveAccountRoles` em `host/account_roles.ts`).
+        const actorRoles = deps.resolveTokenRoles
+            ? await deps.resolveTokenRoles(actor, {
+                clientId: client?.clientId,
+                activeOrg: null,
+            })
+            : (actor.globalRoles ?? []);
+        if (!actorRoles.some((r) => adminRoles.includes(r))) {
             throw new errors.InvalidGrant('actor not permitted to impersonate');
         }
         const targetId = params.requested_subject;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/authkit-server",
-  "version": "0.55.0",
+  "version": "0.55.2",
   "description": "AdonisJS OIDC/OAuth2 provider (Identity Provider) toolkit: ejectable auth server with sessions, rate-limiting, MFA/TOTP, audit log, federated logout and OpenTelemetry metrics.",
   "license": "MIT",
   "author": "dudousxd",