Saltar al contenido principal

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

Paso 2: Configurar 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

Paso 3: Configurar la URL de Callback en Casdoor​

Regresa a la página de edición de la aplicación en el paso 1 y añade la URL de callback que rellenaste en ShowDoc.

showdoc_callbackurl.png

Paso 4: Haz una Prueba en ShowDoc​

Deberías ver lo siguiente en la página de inicio de sesión:

showdoc_login.png

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