Перейти к содержимому
Localtonet Localtonet Панель управления

Единый вход через Microsoft

Нужен Баланс HTTP-туннели

Помощь по этой странице
На этой странице 6 разделов
  1. Перед началом
  2. Шаги
  3. Зарегистрируйте приложение в Microsoft Entra
  4. Добавьте провайдера в Localtonet
  5. Включите его для туннеля
  6. Проверьте
  7. Типы учётных записей и эндпоинты
  8. Что Localtonet читает из Microsoft
  9. Устранение неполадок
  10. Связанные страницы

Позвольте посетителям входить с рабочей или учебной учётной записью Microsoft Entra ID либо личной учётной записью Microsoft, прежде чем они смогут открыть HTTP-туннель. Вы регистрируете приложение в Microsoft Entra, добавляете его в Localtonet как провайдера, а затем включаете для туннеля.

Перед началом #

  • HTTP-туннель и Баланс на вашем аккаунте. См. обзор единого входа.
  • Доступ к Microsoft Entra admin center с ролью, которая может регистрировать приложения. Минимальной Microsoft называет Application Developer.
  • Решение о том, кто может входить: только ваша организация, любая организация или также личные учётные записи. От него зависят два из адресов, которые вы вводите в Localtonet. См. Типы учётных записей и эндпоинты.

Шаги #

  1. Зарегистрируйте приложение в Microsoft Entra #

    Собственные руководства Microsoft: Register an app in Microsoft Entra ID, Add a redirect URI и Add app credentials. Вкратце:

    1. В Microsoft Entra admin center перейдите в Entra ID › App registrations и выберите New registration.
    2. Введите Name. Посетители увидят его при входе.
    3. В разделе Supported account types выберите, кто может использовать приложение, затем нажмите Register.
    4. На странице Overview скопируйте Application (client) ID. Для приложения с одним клиентом (single-tenant) скопируйте также Directory (tenant) ID.
    5. В разделе Manage откройте Authentication, нажмите Add Redirect URI, выберите платформу Web, введите приведённый ниже redirect URI и нажмите Configure.
    6. Откройте Certificates & secrets › Client secrets и нажмите New client secret. Добавьте описание, выберите срок действия и нажмите Add. Сразу скопируйте Value секрета: после ухода со страницы Microsoft больше никогда его не показывает.
    Redirect URI (платформа: Web)
    http://auth.localtonet.com/auth/callback

    Срок действия client secret ограничен. Microsoft ограничивает его срок жизни 24 месяцами. Когда он истекает, вход перестаёт работать, пока вы не создадите новый секрет и не сохраните его в провайдере Localtonet.

  2. Добавьте провайдера в Localtonet #

    Откройте Мои туннели › HTTP и выберите SSO вверху страницы. В диалоге SSO-провайдеры выберите Добавить провайдера.

    ПолеЗначение
    Название провайдераЛюбое название, например Company Microsoft. Вы увидите его в настройках туннеля.
    Тип провайдераMicrosoft. При смене типа сохранённого провайдера поле Client ID очищается, поэтому введите client ID и client secret заново.
    АктивенВключено
    Client IDApplication (client) ID из Microsoft Entra.
    Client SecretValue секрета, а не 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Нет.

    При желании заполните Правила доступа по эл. почте, затем выберите Сохранить провайдера.

  3. Включите его для туннеля #

    В разделе Ваши туннели выберите Настройки у туннеля, затем Управлять рядом с SSO-провайдеры. В диалоге Единый вход (SSO) включите Требовать вход и переключатель вашего провайдера Microsoft. Выберите Сохранить.

    Списки в разделе Кто может войти и Пути входа необязательны. Они описаны в обзоре.

  4. Проверьте #

    Откройте 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 tenantsorganizationsРабочие или учебные учётные записи любой организации.
Any Entra ID Tenant + Personal Microsoft accountsОставьте commonРабочие или учебные учётные записи и личные учётные записи Microsoft.
Personal accounts onlyconsumersЛичные учётные записи 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 отклонило учётную запись. Проверьте Правила доступа по эл. почте у провайдера и Кто может войти у туннеля, а также есть ли у учётной записи адрес электронной почты. После исправления правила подождите минуту и перезагрузите страницу.

Поддержка