OAuth2 Password Grant

目的

OAuth2 Resource Owner Password Grant — ユーザーのユーザー名とパスワードを使用した認証。ユーザーがアプリを信頼して認証情報を預けるファーストパーティアプリケーションに適しています。

使用するタイミング

ファーストパーティアプリケーション（モバイル、Web）
Keycloak および類似の Identity Provider との統合
API が OAuth2 Password Grant をサポートしている場合

設定

yaml

specs:
  - domain: jokes
    llm_title: Dad Joke API
    base_url: https://icanhazdadjoke.com
    collections:
      - llm_title: Jokes
        location: https://raw.githubusercontent.com/mmadfox/swag2mcp/main/specs/dadjoke.yaml
    auth:
      type: oauth2-pwd
      config:
        client_id: "$(CLIENT_ID)"
        client_secret: "$(CLIENT_SECRET)"
        username: "$(USERNAME)"
        password: "$(PASSWORD)"
        token_url: "https://auth.example.com/oauth/token"
        scopes:
          - openid
          - profile
        request_format: form

パラメーター

パラメーター	必須	説明
`client_id`	はい	クライアント識別子
`username`	はい	ユーザー名
`password`	はい	パスワード
`token_url`	はい	トークンエンドポイント URL
`client_secret`	いいえ	クライアントシークレット（オプション、パブリッククライアント用）
`scopes`	いいえ	権限のリスト（オプション）
`request_format`	いいえ	リクエスト形式: `form`（デフォルト、`application/x-www-form-urlencoded`）または `json`（`application/json`）

注意点

client_secret はオプション — パブリッククライアント がサポートされています（例：Keycloak）
swag2mcp はトークンが期限切れになると自動的に更新します
トークンは期限までキャッシュされます
client_id、client_secret、username、password は環境変数に $(VAR) 構文をサポートしています
request_format: json はトークンリクエストを JSON ボディで送信します — トークンエンドポイントが Content-Type: application/json を必要とする場合に使用します

OAuth2 Password Grant ​

目的 ​

使用するタイミング ​

設定 ​

パラメーター ​

注意点 ​

OAuth2 Password Grant

目的

使用するタイミング

設定

パラメーター

注意点