Saltar al contenido principal

Usando Casdoor como un Servidor OAuth2 en ShowDoc

Usando Casdoor para Autenticación en ShowDoc​

ShowDoc es una herramienta de documentación técnica y documentación de API en línea que es perfecta para equipos de TI. ShowDoc facilita el uso de la sintaxis Markdown para escribir hermosos documentos de API, documentos de diccionario de datos, documentos técnicos, documentos de Excel en línea y más.

ShowDoc admite autenticación de terceros, incluyendo OAuth2. Aquí hay un tutorial para lograr esto.

Paso 1: Crear una Aplicación Casdoor​

Ve a tu Casdoor y añade una nueva aplicación llamada ShowDoc. Aquí hay un ejemplo de cómo crear la aplicación ShowDoc en Casdoor.

create_application.png

Por favor, recuerda el client ID y el client Secret para el siguiente paso.

información

Por favor, no rellenes la URL de callback en este paso. La URL depende de las configuraciones en ShowDoc en el siguiente paso. Volveremos para establecer una URL de callback correcta más tarde.

Paso 2: Configurar ShowDoc​

Primero, habilita el botón de inicio de sesión OAuth2. Luego, rellena la URL de callback como se muestra en el ejemplo. Rellena el client ID y el client secret que se recordaron en el paso anterior.

showdoc_oauth2.png

Se requieren Authorize path, AccessToken path y User info path. Puedes rellenarlos como se muestra a continuación.

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

¡Felicidades! Has completado todos los pasos. Presiona el botón 'Casdoor SSO' y serás redirigido a la página de inicio de sesión de Casdoor.