함수: fetchServerConfig()

function fetchServerConfig(issuer: string, config: ServerMetadataConfig): Promise<AuthServerConfig>;

발급자 (Issuer) 및 인가 서버 유형에 따라 서버 구성을 가져옵니다.

이 함수는 서버 유형에 따라 well-known URL을 자동으로 결정합니다. OAuth 및 OpenID Connect 서버는 메타데이터 엔드포인트에 대해 서로 다른 규칙을 가지고 있기 때문입니다.

매개변수

issuer

string

인가 (Authorization) 서버의 발급자 (Issuer) URL입니다.

config

ServerMetadataConfig

서버 유형과 선택적 트랜스파일 함수가 포함된 구성 객체입니다.

반환값

Promise<AuthServerConfig>

서버 구성으로 resolve되는 promise입니다.

참고

• 내부 구현에 대해서는 fetchServerConfigByWellKnownUrl 을(를) 참고하세요.
• OAuth 2.0 인가 (Authorization) 서버 메타데이터 명세는 https://www.rfc-editor.org/rfc/rfc8414 를 참고하세요.
• OpenID Connect Discovery 명세는 https://openid.net/specs/openid-connect-discovery-1_0.html 를 참고하세요.

예시

import { fetchServerConfig } from 'mcp-auth';
// OAuth 서버 구성을 가져옵니다
// 이는 `https://auth.logto.io/.well-known/oauth-authorization-server/oauth`에서 메타데이터를 가져옵니다
const oauthConfig = await fetchServerConfig('https://auth.logto.io/oauth', { type: 'oauth' });

// OpenID Connect 서버 구성을 가져옵니다
// 이는 `https://auth.logto.io/oidc/.well-known/openid-configuration`에서 메타데이터를 가져옵니다
const oidcConfig = await fetchServerConfig('https://auth.logto.io/oidc', { type: 'oidc' });

예외

fetch 작업이 실패할 경우 예외가 발생합니다.

예외

서버 메타데이터가 유효하지 않거나 MCP 명세와 일치하지 않을 경우 예외가 발생합니다.