型エイリアス: BearerAuthConfig
type BearerAuthConfig = {
audience?: string;
issuer: string;
requiredScopes?: string[];
showErrorDetails?: boolean;
verifyAccessToken: VerifyAccessTokenFunction;
};
プロパティ
audience?
optional audience: string;
アクセス トークン (アクセス トークン) の期待されるオーディエンス (aud
クレーム)。これは通常、トークンが意図されているリソースサーバー(API)です。指定しない場合、オーディエンスのチェックはスキップされます。
注意: 認可サーバーがリソースインジケーター (RFC 8707) をサポートしていない場合、このフィールドは省略できます。なぜなら、オーディエンスが関連しない場合があるためです。
参照
https://datatracker.ietf.org/doc/html/rfc8707
issuer
issuer: string;
アクセス トークン (アクセス トークン) の期待される発行者 (iss
クレーム)。これはトークンを発行した認可サーバーの URL である必要があります。
requiredScopes?
optional requiredScopes: string[];
アクセス トークン (アクセス トークン) に必要なスコープ (スコープ) の配列。トークンにこれらすべてのスコープが含まれていない場合、エラーがスローされます。
注意: ハンドラーはトークン内の scope
クレームをチェックします。これは認可サーバーの実装によって、スペース区切りの文字列または文字列の配列である場合があります。scope
クレームが存在しない場合、ハンドラーは scopes
クレームがあればそれをチェックします。
showErrorDetails?
optional showErrorDetails: boolean;
レスポンスに詳細なエラー情報を表示するかどうか。これは開発中のデバッグに便利ですが、本番環境では機密情報漏洩を防ぐため無効にするべきです。
デフォルト
false
verifyAccessToken
verifyAccessToken: VerifyAccessTokenFunction;
アクセス トークン (アクセス トークン) を検証するための関数型。
この関数は、トークンが無効な場合は MCPAuthTokenVerificationError をスローし、有効な場合は AuthInfo オブジェクトを返す必要があります。
参照
VerifyAccessTokenFunction を参照してください。