Перейти до основного вмісту

Використання Casdoor як OAuth2 сервера в ShowDoc

Використання Casdoor для аутентифікації в ShowDoc

ShowDoc - це онлайн-інструмент для документації API та технічної документації, який ідеально підходить для ІТ-команд. 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.