ベース URL
XID は ID プロバイダーです。インスタンスドメインは OIDC 発行者、API ベース URL、Hosted Auth ベース URL、コンソールベース URL です。組織はポリシー、ブランド設定、メンバーシップ、リソース分離を提供します。
まずインスタンスドメインから /.well-known/openid-configuration を読み込みます。ディスカバリードキュメントは、その発行者の認可、トークン、ユーザー情報、ログアウト、JWKS エンドポイントをアプリに提供します。
| 画面 | パス | 使用 |
|---|---|---|
| OIDC ディスカバリー | /.well-known/openid-configuration |
リライングパーティを設定する前に発行者メタデータを読み取ります。 |
| 認可 | /authorize |
ユーザーを統合 Hosted Auth フローへリダイレクトします。 |
| トークン | /token |
認可コードまたはリフレッシュトークンを交換します。 |
| ユーザー情報 | /userinfo |
有効なアクセストークンのクレームを読み取ります。 |
| 管理 API | /v1/* |
バックエンドから組織リソースを管理します。 |
最小構成の統合
- OIDC アプリケーションを作成し、完全一致のリダイレクト URI 値を登録します。
- ブラウザーとネイティブクライアントには PKCE S256 付きの認可コードフローを使用します。
- 発行者と JWKS URI に対して ID トークンとアクセストークンを検証します。
- リフレッシュトークンはサーバー側、または安全なネイティブ認証情報ストアに保存します。
認可リクエスト
sequenceDiagram participant Browser participant RP participant XID RP->>Browser: /authorize + PKCE S256 Browser->>XID: /authorize + PKCE S256 XID->>Browser: /sign-in Browser->>XID: WebAuthn / SSO XID->>Browser: code Browser->>RP: code RP->>XID: /token + PKCE S256 XID->>RP: ID token + access token
const authorizeUrl = new URL('https://xid.dev/authorize')
authorizeUrl.searchParams.set('client_id', clientId)
authorizeUrl.searchParams.set('redirect_uri', redirectUri)
authorizeUrl.searchParams.set('response_type', 'code')
authorizeUrl.searchParams.set('scope', 'openid profile email')
authorizeUrl.searchParams.set('code_challenge', codeChallenge)
authorizeUrl.searchParams.set('code_challenge_method', 'S256')