@absolutejs/auth 0.75.0 → 0.75.2

package/README.md

@@ -281,8 +281,11 @@ const authPlugin = await auth({
 		resource: 'https://api.example.com',
 		scopes: ['documents:read', 'documents:write'],
 		verifyCredential: createOidcAgentCredentialVerifier({
+			// Atomically insert a hash of jkt + jti; return false on conflict.
+			consumeDpopJti: replayStore.consume,
 			issuer: 'https://auth.example.com',
 			publicJwk: signingKey.publicJwk,
+			requireDpop: true,
 			resource: 'https://api.example.com'
 		})
 	},
@@ -300,6 +303,16 @@ registration. Approval through the existing RFC 8628 device flow creates the
 user-to-agent delegation. The agent can then use RFC 8693 token exchange to get
 a narrowed, audience-bound access token for the protected API.
 
+When `requireDpop` is enabled, the adapter accepts only an RFC 9449-bound
+access token using the `DPoP` authorization scheme, verifies its per-request
+proof and `ath` token hash, and requires the proof key to match `cnf.jkt`.
+Provide `consumeDpopJti` as an atomic shared-store insertion in clustered
+deployments; returning `false` rejects a replay. Proofs without `jti`, proofs
+whose JWK contains private key material, oversized identifiers, and `htu`
+claims containing query or fragment components fail closed. Resource servers
+that require RFC 9449 nonces can use the nonce helpers exported by
+`@absolutejs/auth/oidc` to issue a separate resource nonce challenge.
+
 ```ts
 app.get('/documents', ({ protectAgent }) =>
 	protectAgent(['documents:read'], (agent) => ({

package/dist/agents/config.d.ts

@@ -25,6 +25,9 @@ export type AgentAuthConfig = {
     oauthGuide?: AgentOAuthGuideConfig;
     authorizationServer: string;
     delegationStore: AgentDelegationStore;
+    /** Advertise RFC 9728 `dpop_bound_access_tokens_required`. Keep this aligned
+     * with a credential verifier configured with `requireDpop: true`. */
+    dpopBoundAccessTokensRequired?: boolean;
     logoUri?: string;
     metadataRoute?: RouteString;
     /** Authorization-server route prefix. Defaults to `/oauth2`; used to derive
@@ -39,11 +42,12 @@ export type AgentAuthConfig = {
     scopes: string[];
     verifyCredential: AgentCredentialVerifier;
 };
-export declare const agentProtectedResourceMetadata: (config: Pick<AgentAuthConfig, "authorizationServer" | "logoUri" | "resource" | "resourceName" | "scopes">) => {
+export declare const agentProtectedResourceMetadata: (config: Pick<AgentAuthConfig, "authorizationServer" | "dpopBoundAccessTokensRequired" | "logoUri" | "resource" | "resourceName" | "scopes">) => {
     resource: string;
     scopes_supported: string[];
     resource_name?: string | undefined;
     resource_logo_uri?: string | undefined;
+    dpop_bound_access_tokens_required?: boolean | undefined;
     authorization_servers: string[];
     bearer_methods_supported: string[];
 };

package/dist/agents/index.js

@@ -186,6 +186,7 @@ var DEFAULT_AGENT_RESOURCE_METADATA_ROUTE = "/.well-known/oauth-protected-resour
 var agentProtectedResourceMetadata = (config) => ({
   authorization_servers: [config.authorizationServer],
   bearer_methods_supported: ["header"],
+  ...config.dpopBoundAccessTokensRequired === true ? { dpop_bound_access_tokens_required: true } : {},
   ...config.logoUri === undefined ? {} : { resource_logo_uri: config.logoUri },
   ...config.resourceName === undefined ? {} : { resource_name: config.resourceName },
   resource: config.resource,
@@ -1349,6 +1350,7 @@ var validateClientIdMetadataDocument = (document, expectedClientId) => {
 // src/oidc/dpop.ts
 init_constants();
 var DEFAULT_MAX_AGE_MS = 60000;
+var MAX_JTI_LENGTH = 128;
 var SECONDS_TO_MS = 1000;
 var NONCE_WINDOW_SECONDS = 120;
 var NONCE_WINDOW_MS = NONCE_WINDOW_SECONDS * MILLISECONDS_IN_A_SECOND;
@@ -1389,17 +1391,38 @@ var verifyDpopNonce = async ({
   const candidates = await Promise.all(Array.from({ length: NONCE_PREVIOUS_WINDOWS_ACCEPTED + 1 }, (_, offset) => hmacSha256(secret, String(currentWindow - offset))));
   return candidates.some((expected) => expected === nonce);
 };
-var decodeHeader = (segment) => JSON.parse(Buffer.from(segment, "base64url").toString("utf8"));
-var normalizeHtu = (value) => {
+var decodeHeader = (segment) => {
+  try {
+    const value = JSON.parse(Buffer.from(segment, "base64url").toString("utf8"));
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+  } catch {
+    return;
+  }
+};
+var normalizeHtu = (value, proofClaim = false) => {
   try {
     const url = new URL(String(value));
+    if (url.username || url.password || proofClaim && (url.search.length > 0 || url.hash.length > 0))
+      return;
     return `${url.origin}${url.pathname}`;
   } catch {
-    return "";
+    return;
   }
 };
+var isPublicEs256Jwk = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return false;
+  const kty = Reflect.get(value, "kty");
+  const crv = Reflect.get(value, "crv");
+  const xCoordinate = Reflect.get(value, "x");
+  const yCoordinate = Reflect.get(value, "y");
+  const privateComponent = Reflect.get(value, "d");
+  const alg = Reflect.get(value, "alg");
+  return kty === "EC" && crv === "P-256" && typeof xCoordinate === "string" && xCoordinate.length > 0 && typeof yCoordinate === "string" && yCoordinate.length > 0 && privateComponent === undefined && (alg === undefined || alg === "ES256");
+};
 var verifyDpopProof = async ({
   accessToken,
+  consumeJti,
   htm,
   htu,
   isUsedJti,
@@ -1409,14 +1432,20 @@ var verifyDpopProof = async ({
 }) => {
   if (proof === undefined)
     return;
-  const [headerSegment] = proof.split(".");
+  const segments = proof.split(".");
+  if (segments.length !== 3)
+    return;
+  const [headerSegment] = segments;
   if (headerSegment === undefined)
     return;
   const header = decodeHeader(headerSegment);
-  if (header?.typ !== "dpop+jwt" || header.alg !== "ES256" || header.jwk === undefined) {
+  const publicJwk = header === undefined ? undefined : Reflect.get(header, "jwk");
+  if (header === undefined || Reflect.get(header, "typ") !== "dpop+jwt" || Reflect.get(header, "alg") !== "ES256" || !isPublicEs256Jwk(publicJwk)) {
     return;
   }
-  const verified = await verifyJwt(proof, header.jwk);
+  const verified = await verifyJwt(proof, publicJwk).catch(() => {
+    return;
+  });
   if (verified === undefined)
     return;
   const { payload } = verified;
@@ -1426,14 +1455,19 @@ var verifyDpopProof = async ({
       return;
   }
   const iatMs = typeof payload.iat === "number" ? payload.iat * SECONDS_TO_MS : 0;
-  if (payload.htm !== htm || normalizeHtu(payload.htu) !== normalizeHtu(htu) || iatMs === 0 || Math.abs(now - iatMs) > maxAgeMs) {
+  const claimedHtu = normalizeHtu(payload.htu, true);
+  const expectedHtu = normalizeHtu(htu);
+  const jti = typeof payload.jti === "string" ? payload.jti : undefined;
+  if (payload.htm !== htm || claimedHtu === undefined || expectedHtu === undefined || claimedHtu !== expectedHtu || iatMs === 0 || Math.abs(now - iatMs) > maxAgeMs || jti === undefined || jti.length === 0 || jti.length > MAX_JTI_LENGTH) {
     return;
   }
-  const jti = typeof payload.jti === "string" ? payload.jti : undefined;
-  if (jti !== undefined && isUsedJti !== undefined && await isUsedJti(jti)) {
+  const jkt = await jwkThumbprint(publicJwk);
+  if (isUsedJti !== undefined && await isUsedJti(jti)) {
     return;
   }
-  return { jkt: await jwkThumbprint(header.jwk), jti };
+  if (consumeJti !== undefined && !await consumeJti({ expiresAt: iatMs + maxAgeMs, jkt, jti }))
+    return;
+  return { jkt, jti };
 };
 
 // src/agents/oidcAdapter.ts
@@ -1449,6 +1483,7 @@ var readAudience = (audience) => {
 };
 var createOidcAgentCredentialVerifier = ({
   issuer,
+  consumeDpopJti,
   isUsedDpopJti,
   maxDpopAgeMs,
   publicJwk,
@@ -1477,6 +1512,7 @@ var createOidcAgentCredentialVerifier = ({
         return;
       const proof = await verifyDpopProof({
         accessToken: token,
+        consumeJti: consumeDpopJti,
         htm: request.method,
         htu: request.url,
         isUsedJti: isUsedDpopJti,
@@ -13763,5 +13799,5 @@ export {
   AGENT_CLAIM_GRANT_TYPE
 };
 
-//# debugId=323598F91D83FA7764756E2164756E21
+//# debugId=16DE04B83F43B7D264756E2164756E21
 //# sourceMappingURL=index.js.map