Единый вход через Microsoft
Нужен Баланс HTTP-туннели
На этой странице 6 разделов
Позвольте посетителям входить с рабочей или учебной учётной записью Microsoft Entra ID либо личной учётной записью Microsoft, прежде чем они смогут открыть HTTP-туннель. Вы регистрируете приложение в Microsoft Entra, добавляете его в Localtonet как провайдера, а затем включаете для туннеля.
Перед началом #
- HTTP-туннель и Баланс на вашем аккаунте. См. обзор единого входа.
- Доступ к Microsoft Entra admin center с ролью, которая может регистрировать приложения. Минимальной Microsoft называет Application Developer.
- Решение о том, кто может входить: только ваша организация, любая организация или также личные учётные записи. От него зависят два из адресов, которые вы вводите в Localtonet. См. Типы учётных записей и эндпоинты.
Шаги #
-
Зарегистрируйте приложение в Microsoft Entra #
Собственные руководства Microsoft: Register an app in Microsoft Entra ID, Add a redirect URI и Add app credentials. Вкратце:
- В Microsoft Entra admin center перейдите в Entra ID › App registrations и выберите New registration.
- Введите Name. Посетители увидят его при входе.
- В разделе Supported account types выберите, кто может использовать приложение, затем нажмите Register.
- На странице Overview скопируйте Application (client) ID. Для приложения с одним клиентом (single-tenant) скопируйте также Directory (tenant) ID.
- В разделе Manage откройте Authentication, нажмите Add Redirect URI, выберите платформу Web, введите приведённый ниже redirect URI и нажмите Configure.
- Откройте Certificates & secrets › Client secrets и нажмите New client secret. Добавьте описание, выберите срок действия и нажмите Add. Сразу скопируйте Value секрета: после ухода со страницы Microsoft больше никогда его не показывает.
Redirect URI (платформа: Web)http://auth.localtonet.com/auth/callbackСрок действия client secret ограничен. Microsoft ограничивает его срок жизни 24 месяцами. Когда он истекает, вход перестаёт работать, пока вы не создадите новый секрет и не сохраните его в провайдере Localtonet.
-
Добавьте провайдера в Localtonet #
Откройте Мои туннели › HTTP и выберите SSO вверху страницы. В диалоге SSO-провайдеры выберите Добавить провайдера.
Поле Значение Название провайдера Любое название, например Company Microsoft. Вы увидите его в настройках туннеля.Тип провайдера Microsoft. При смене типа сохранённого провайдера поле Client ID очищается, поэтому введите client ID и client secret заново. Активен Включено Client ID Application (client) ID из Microsoft Entra. Client Secret Value секрета, а не Secret ID. После сохранения оно больше не отображается. Откройте Эндпоинты и колбэк. Эти значения заполняются автоматически:
Поле Подставленное значение Менять? Эндпоинт авторизации https://login.microsoftonline.com/common/oauth2/v2.0/authorizeЗамените commonсогласно таблице в следующем разделе.Эндпоинт токена https://login.microsoftonline.com/common/oauth2/v2.0/tokenЗамените commonтем же значением, что и выше.Эндпоинт данных пользователя https://graph.microsoft.com/oidc/userinfoНет. В нём нет тенанта. Путь колбэка /auth/callback/microsoftНет. При желании заполните Правила доступа по эл. почте, затем выберите Сохранить провайдера.
-
Включите его для туннеля #
В разделе Ваши туннели выберите Настройки у туннеля, затем Управлять рядом с SSO-провайдеры. В диалоге Единый вход (SSO) включите Требовать вход и переключатель вашего провайдера Microsoft. Выберите Сохранить.
Списки в разделе Кто может войти и Пути входа необязательны. Они описаны в обзоре.
-
Проверьте #
Откройте URL туннеля в приватном окне браузера. Localtonet показывает Sign in to continue с кнопкой для вашего провайдера. После входа в Microsoft вы возвращаетесь на туннель, и ваша служба загружается.
Типы учётных записей и эндпоинты #
Часть адреса Microsoft после login.microsoftonline.com/ определяет, кто может входить. Она должна соответствовать Supported account types вашего приложения. Эндпоинт авторизации и Эндпоинт токена всегда получают одно и то же значение. Эндпоинт данных пользователя не меняется никогда.
| Supported account types в Microsoft Entra | Использовать вместо common | Кто может войти |
|---|---|---|
| Single tenant only | Ваш Directory (tenant) ID | Пользователи и гости вашего собственного тенанта. |
| Multiple Entra ID tenants | organizations | Рабочие или учебные учётные записи любой организации. |
| Any Entra ID Tenant + Personal Microsoft accounts | Оставьте common | Рабочие или учебные учётные записи и личные учётные записи Microsoft. |
| Personal accounts only | consumers | Личные учётные записи Microsoft. |
Пример для приложения с одним тенантом. Замените <TENANT_ID> своим Directory (tenant) ID:
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfoПриложение с одним тенантом не работает с common. Microsoft отвечает ошибкой AADSTS50194. Либо укажите ID вашего тенанта в обоих эндпоинтах, либо измените приложение на мультитенантный тип учётных записей.
При мультитенантном или личном типе учётных записей войти в Microsoft могут люди за пределами вашей организации. Используйте Разрешённые почтовые домены у провайдера или Кто может войти у туннеля, чтобы допустить только нужных людей.
Что Localtonet читает из Microsoft #
Эндпоинт данных пользователя Microsoft возвращает адрес электронной почты, только если он связан с учётной записью, поэтому учётная запись без адреса электронной почты может не пройти правила, работающие по почте.
Устранение неполадок #
AADSTS50011: the reply URL does not match
Redirect URI в запросе не зарегистрирован для приложения. В сообщении показан отправленный адрес. Он должен точно совпадать с redirect URI на странице Authentication регистрации приложения, на платформе Web, включая регистр букв. Зарегистрируйте ровно http://auth.localtonet.com/auth/callback.
AADSTS50194: the application is not configured as a multitenant application
Приложение однотенантное, но в эндпоинтах по-прежнему стоит common. Замените common своим Directory (tenant) ID в Эндпоинт авторизации и Эндпоинт токена и выберите Сохранить провайдера.
AADSTS700016: the application was not found in the directory
Client ID неверный, или эндпоинты указывают на тенант, в котором приложения не существует. Проверьте Application (client) ID и ID тенанта в эндпоинтах.
AADSTS7000215 или AADSTS7000222: invalid or expired client secret
Создайте новый client secret в разделе Certificates & secrets, вставьте его Value в Client Secret в Localtonet и выберите Сохранить провайдера.
Microsoft запрашивает одобрение администратора
Ваш тенант не позволяет пользователям самостоятельно давать согласие приложениям. Администратор тенанта должен предоставить согласие для приложения в Microsoft Entra admin center.
«403 - Access Denied» после успешного входа в Microsoft
Правило Localtonet отклонило учётную запись. Проверьте Правила доступа по эл. почте у провайдера и Кто может войти у туннеля, а также есть ли у учётной записи адрес электронной почты. После исправления правила подождите минуту и перезагрузите страницу.