Connectum API Reference / @connectum/auth / parseAuthHeaders

Function: parseAuthHeaders()

parseAuthHeaders(headers): AuthContext | undefined

Defined in: packages/auth/src/headers.ts:91

Parse AuthContext from request headers.

Deserializes auth context from standard headers set by an upstream service or gateway. Returns undefined if required headers are missing.

WARNING: Only use this in trusted environments (behind mTLS, mesh, etc.). For untrusted environments, use createTrustedHeadersReader() instead.

Parameters

headers

Headers

Request headers to parse

Returns

AuthContext | undefined

Parsed AuthContext or undefined if headers are missing

Example

import { parseAuthHeaders } from '@connectum/auth';

const context = parseAuthHeaders(req.header);
if (context) {
  console.log(`Authenticated as ${context.subject}`);
}