Перейти к основному содержанию

Использование Casdoor в качестве сервера OAuth2 в ShowDoc

Использование Casdoor для аутентификации в ShowDoc

ShowDoc — это онлайн-инструмент для документации API и технической документации, который идеально подходит для IT-команд. ShowDoc упрощает использование синтаксиса Markdown для написания красивых документов API, словарей данных, технических документов, онлайн-документов Excel и многого другого.

ShowDoc поддерживает стороннюю аутентификацию, включая OAuth2. Вот руководство по достижению этого.

Шаг 1: Создайте приложение Casdoor

Перейдите в ваш Casdoor и добавьте новое приложение под названием ShowDoc. Вот пример создания приложения ShowDoc в Casdoor.

create_application.png

Пожалуйста, запомните client ID и client Secret для следующего шага.

информация

Пожалуйста, не заполняйте callback URL на этом шаге. URL зависит от конфигураций в ShowDoc на следующем шаге. Мы вернемся, чтобы установить правильный callback URL позже.

Шаг 2: Настройте ShowDoc

Сначала включите кнопку входа через OAuth2. Затем заполните callback URL, как показано в примере. Заполните client ID и client secret, которые были запомнены на предыдущем шаге.

showdoc_oauth2.png

Требуются Authorize path, AccessToken path и User info path. Вы можете заполнить их, как показано ниже.

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

Шаг 3: Настройте Callback URL в Casdoor

Вернитесь на страницу редактирования приложения на шаге 1 и добавьте callback URL, который вы заполнили в ShowDoc.

showdoc_callbackurl.png

Шаг 4: Попробуйте войти в ShowDoc

На странице входа вы должны увидеть следующее:

showdoc_login.png

Поздравляем! Вы выполнили все шаги. Нажмите кнопку 'Casdoor SSO', и вы будете перенаправлены на страницу входа Casdoor.