Skip to content

Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active

3.7 KB
Raw Blame
import { TokenExchangeMethodEnum } from 'librechat-data-provider';

type ClientAuthMethod = 'client_secret_basic' | 'client_secret_post' | 'none';

/** Unordered roster of auth methods we can handle — order is irrelevant; server's list controls priority */
const SUPPORTED_AUTH_METHODS: ReadonlySet<string> = new Set<ClientAuthMethod>([
  'client_secret_basic',
  'client_secret_post',
  'none',
]);

/** Maps a user-facing `TokenExchangeMethodEnum` to an OAuth auth method string. */
export function getForcedTokenEndpointAuthMethod(
  tokenExchangeMethod?: TokenExchangeMethodEnum,
): 'client_secret_basic' | 'client_secret_post' | undefined {
  if (tokenExchangeMethod === TokenExchangeMethodEnum.DefaultPost) {
    return 'client_secret_post';
  }
  if (tokenExchangeMethod === TokenExchangeMethodEnum.BasicAuthHeader) {
    return 'client_secret_basic';
  }
  return undefined;
}

/**
 * Selects the auth method to request during dynamic client registration.
 *
 * Priority:
 * 1. Forced override from `tokenExchangeMethod` config
 * 2. First credential-based method from server's advertised list (skips `none` per RFC 7591 —
 *    `none` declares a public client, which is incorrect for DCR with a generated secret)
 * 3. `none` if the server only advertises `none`
 * 4. Server's first listed method (unsupported exotic method — best-effort)
 * 5. Falls through to `undefined` (caller keeps its default)
 */
export function selectRegistrationAuthMethod(
  serverAdvertised: string[] | undefined,
  tokenExchangeMethod?: TokenExchangeMethodEnum,
): string | undefined {
  const forced = getForcedTokenEndpointAuthMethod(tokenExchangeMethod);
  if (forced) {
    return forced;
  }

  if (!serverAdvertised?.length) {
    return undefined;
  }

  const credentialPreferred = serverAdvertised.find(
    (m) => SUPPORTED_AUTH_METHODS.has(m) && m !== 'none',
  );
  if (credentialPreferred) {
    return credentialPreferred;
  }

  const serverPreferred = serverAdvertised.find((m) => SUPPORTED_AUTH_METHODS.has(m));
  return serverPreferred ?? serverAdvertised[0];
}

/**
 * Resolves the auth method for token endpoint requests (refresh, pre-configured flows).
 *
 * Priority:
 * 1. Forced override from `tokenExchangeMethod` config
 * 2. Preferred method from client registration response (`clientInfo.token_endpoint_auth_method`)
 * 3. First match from server's advertised methods
 */
export function resolveTokenEndpointAuthMethod(options: {
  tokenExchangeMethod?: TokenExchangeMethodEnum;
  tokenAuthMethods: string[];
  preferredMethod?: string;
}): 'client_secret_basic' | 'client_secret_post' | undefined {
  const forced = getForcedTokenEndpointAuthMethod(options.tokenExchangeMethod);
  const preferredMethod = forced ?? options.preferredMethod;

  if (preferredMethod === 'client_secret_basic' || preferredMethod === 'client_secret_post') {
    return preferredMethod;
  }

  if (options.tokenAuthMethods.includes('client_secret_basic')) {
    return 'client_secret_basic';
  }
  if (options.tokenAuthMethods.includes('client_secret_post')) {
    return 'client_secret_post';
  }
  return undefined;
}

/**
 * Infers the client auth method from request state when `clientInfo.token_endpoint_auth_method`
 * is not set. Used inside the fetch wrapper to determine how credentials were applied by the SDK.
 *
 * Per RFC 8414 Section 2, defaults to `client_secret_basic` for confidential clients.
 */
export function inferClientAuthMethod(
  hasAuthorizationHeader: boolean,
  hasBodyClientId: boolean,
  hasBodyClientSecret: boolean,
  hasClientSecret: boolean,
): ClientAuthMethod {
  if (hasAuthorizationHeader) {
    return 'client_secret_basic';
  }
  if (hasBodyClientId || hasBodyClientSecret) {
    return 'client_secret_post';
  }
  if (hasClientSecret) {
    return 'client_secret_basic';
  }
  return 'none';
}