В этой статье мы покажем, как использовать Logto в качестве провайдера удостоверений OpenID Connect (OIDC) для Outline.
Самое лучшее в том, что и Logto, и Outline являются открытым исходным кодом. В этой статье мы покажем, как использовать Logto в качестве OpenID Connect (OIDC) провайдера удостоверений для Outline.
Чтобы начать, убедитесь, что у вас есть следующее:
Если вы размещаете Logto самостоятельно, обратитесь к документации Logto "Начало работы" для настройки вашей инстанции Logto.
Откройте консоль Logto, введя URL https://cloud.logto.io/, если вы используете Logto Cloud, или конечную точку, которую вы настроили для самохостинга.
Затем перейдите на вкладку "Приложения" и нажмите "Создать приложение".
В появившемся модальном окне выберите "Традиционный веб" и введите имя приложения, например "Outline". Затем нажмите "Создать приложение".
Вы будете перенаправлены на страницу с учебником в Logto. Нажмите "Пропустить" в правом верхнем углу, чтобы перейти на страницу с подробной информацией о приложении.
В разделе "Redirect URIs" введите следующее значение:
Например, если вы размещаете Outline на http://localhost:3000, значение должно быть:
Нажмите кнопку "Сохранить изменения" внизу. После успешного сохранения оставьте эту страницу открытой, так как она будет полезна для настройки Outline.
Следуйте шагам, описанным в руководстве по размещению Outline, пока не достигнете шага настройки аутентификации. Поскольку Outline по умолчанию поддерживает совместимые с OIDC провайдеры аутентификации, вы легко найдете большинство необходимых значений настроек на странице с деталями приложения Logto.
Обратитесь к следующей таблице для получения необходимых данных настройки:
| Переменная окружения Outline | Имя, отображаемое в Logto |
|---|---|
| OIDC_CLIENT_ID | ID приложения |
| OIDC_CLIENT_SECRET | Секрет приложения |
| OIDC_AUTH_URI | Конечная точка авторизации |
| OIDC_TOKEN_URI | Конечная точка для токена |
| OIDC_USERINFO_URI | Конечная точка информации о пользователе |
Вот еще одна таблица, содержащая дополнительные переменные:
| Переменная окружения Outline | Описание |
|---|---|
| OIDC_USERNAME_CLAIM | Установить на username |
| OIDC_DISPLAY_NAME | Необязательный - настраивайте по желанию |
| OIDC_SCOPES | Оставьте по умолчанию; не нужно настраивать |
Поскольку Outline требует предоставления электронной почты пользователя, необходимо настроить вход по электронной почте или социальный вход, который предоставляет надежный адрес электронной почты, например, вход через Google.
См. Настройка коннекторов, чтобы узнать больше о настройке коннекторов в Logto.
Запустите инстанцию Outline и получите доступ к ее конечной точке. Вы должны увидеть кнопку в центре с надписью "Продолжить с OpenID Connect"; это можно настроить, установив переменную окружения OIDC_DISPLAY_NAME.
Нажмите на кнопку, и вы будете перенаправлены на процесс входа в Logto.
Если все настроено правильно, после завершения процесса входа или регистрации в Logto вы будете перенаправлены обратно в Outline. Затем вы сможете увидеть свою личную информацию в нижнем левом углу страницы.
Если у вас возникнут какие-либо проблемы во время интеграции, не стесняйтесь обратиться к нам по электронной почте [email protected] или присоединиться к нашему серверу Discord!