跳到主内容

Using Casdoor as an OAuth2 server in ShowDoc

ShowDoc is an API and technical documentation platform with Markdown support. It supports OAuth2 for sign-in. This guide configures Casdoor as the OAuth2 server.

Step 1: Create a Casdoor application​

In Casdoor, add an application (e.g. ShowDoc). Note Client ID and Client secret. Leave the callback URL empty for now; set it after configuring ShowDoc (step 3).

create_application.png

步骤2：配置ShowDoc​

Enable OAuth2 login in ShowDoc. Set the callback URL (as shown in the example), client ID, and client secret from step 1.

showdoc_oauth2.png

Authorize path, AccessToken path, and User info path are required. Use:

Authorize path:   /login/oauth/authorize
AccessToken path:   /api/login/oauth/access_token
User info path:   /api/get-account

步骤3：在Casdoor中配置回调URL​

返回到步骤1中的应用编辑页面，并添加你在ShowDoc中填写的回调URL。

showdoc_callbackurl.png

步骤4：尝试使用ShowDoc​

你应该在登录页面上看到以下内容：

showdoc_login.png

When setup is complete, click Casdoor SSO to sign in via Casdoor.