標準OIDCクライアント

OIDCディスカバリ

CasdoorはOIDCプロトコルを完全に実装しています。 もし既に標準OIDCクライアントライブラリを使用して他のOAuth 2.0アイデンティティプロバイダに接続しているアプリケーションがあり、Casdoorに移行したい場合、OIDCディスカバリを使用すると非常に簡単に切り替えることができます。 CasdoorのOIDCディスカバリURLは以下の通りです：

<your-casdoor-backend-host>/.well-known/openid-configuration

例えば、デモサイトのOIDCディスカバリURLは以下の通りです：https://door.casdoor.com/.well-known/openid-configuration、そしてそれには以下の情報が含まれています：

{
  "issuer": "https://door.casdoor.com",
  "authorization_endpoint": "https://door.casdoor.com/login/oauth/authorize",
  "token_endpoint": "https://door.casdoor.com/api/login/oauth/access_token",
  "userinfo_endpoint": "https://door.casdoor.com/api/userinfo",
  "jwks_uri": "https://door.casdoor.com/.well-known/jwks",
  "introspection_endpoint": "https://door.casdoor.com/api/login/oauth/introspect",
  "response_types_supported": [
    "code",
    "token",
    "id_token",
    "code token",
    "code id_token",
    "token id_token",
    "code token id_token",
    "none"
  ],
  "response_modes_supported": [
    "login",
    "code",
    "link"
  ],
  "grant_types_supported": [
    "password",
    "authorization_code"
  ],
  "subject_types_supported": [
    "public"
  ],
  "id_token_signing_alg_values_supported": [
    "RS256"
  ],
  "scopes_supported": [
    "openid",
    "email",
    "profile",
    "address",
    "phone",
    "offline_access"
  ],
  "claims_supported": [
    "iss",
    "ver",
    "sub",
    "aud",
    "iat",
    "exp",
    "id",
    "type",
    "displayName",
    "avatar",
    "permanentAvatar",
    "email",
    "phone",
    "location",
    "affiliation",
    "title",
    "homepage",
    "bio",
    "tag",
    "region",
    "language",
    "score",
    "ranking",
    "isOnline",
    "isAdmin",
    "isGlobalAdmin",
    "isForbidden",
    "signupApplication",
    "ldap"
  ],
  "request_parameter_supported": true,
  "request_object_signing_alg_values_supported": [
    "HS256",
    "HS384",
    "HS512"
  ]
}

OIDCクライアントライブラリのリスト

以下はGoやJavaのような言語のためのいくつかのOIDCクライアントライブラリのリストです：

OIDCクライアントライブラリ	言語	リンク
go-oidc	Go	https://github.com/coreos/go-oidc
pac4j-oidc	Java	https://www.pac4j.org/docs/clients/openid-connect.html

上記の表は網羅的ではないことに注意してください。 OIDCクライアントライブラリの完全なリストについては、詳細はこちらで確認できます：

1. https://oauth.net/code/
2. https://openid.net/certified-open-id-developer-tools/

OIDC UserInfoフィールド

以下の表は、CasdoorのユーザーテーブルのプロパティからマッピングされるOIDC UserInfoフィールド（/api/userinfo API経由）を示しています：

Casdoorユーザーフィールド	OIDC UserInfoフィールド
Id	sub
originBackend	iss
Aud	aud
Name	preferred_username
DisplayName	name
Email	email
Avatar	picture
Location	address
Phone	phone

UserInfoの定義はこちらで確認できます。