Перейти до вмісту
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, введіть наведений нижче URI переспрямування й натисніть Configure.
    6. Відкрийте Certificates & secrets › Client secrets і виберіть New client secret. Додайте опис, виберіть строк дії та натисніть Add. Одразу скопіюйте Value секрету: після виходу зі сторінки Microsoft більше ніколи його не покаже.
    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. Після збереження він ніколи не відображається.

    Відкрийте Ендпоінти й callback. Ці значення заповнюються автоматично:

    ПолеАвтоматично заповнене значенняЗмінювати?
    Ендпоінт авторизації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Ні. Він не містить орендаря (tenant).
    Шлях callback/auth/callback/microsoftНі.

    За бажанням заповніть Правила доступу за email, а потім натисніть Зберегти провайдера.

  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. Або вкажіть ідентифікатор свого орендаря в обох ендпоінтах, або змініть застосунок на тип облікових записів із кількома орендарями.

Для типу облікових записів із кількома орендарями або особистих облікових записів у Microsoft можуть входити люди поза вашою організацією. Скористайтеся Дозволені домени email у провайдері або Хто може входити у тунелі, щоб допустити лише потрібних вам людей.

Що Localtonet отримує від Microsoft #

Ендпоінт даних користувача Microsoft повертає адресу електронної пошти лише тоді, коли вона пов’язана з обліковим записом, тож обліковий запис без адреси електронної пошти може не пройти правила, що працюють з email.

Усунення несправностей #

AADSTS50011: адреса відповіді не збігається

URI переспрямування із запиту не зареєстровано для застосунку. Повідомлення показує надіслану адресу. Вона має точно збігатися з URI переспрямування на сторінці Authentication реєстрації застосунку на платформі Web, включно з регістром літер. Зареєструйте саме http://auth.localtonet.com/auth/callback.

AADSTS50194: застосунок не налаштовано як багатоорендарний

Застосунок має одного орендаря, але ендпоінти досі містять common. Замініть common вашим Directory (tenant) ID в Ендпоінт авторизації та Ендпоінт токена і натисніть Зберегти провайдера.

AADSTS700016: застосунок не знайдено в каталозі

Client ID неправильний, або ендпоінти вказують на орендаря, у якому цього застосунку немає. Перевірте Application (client) ID та ідентифікатор орендаря в ендпоінтах.

AADSTS7000215 або AADSTS7000222: недійсний чи прострочений client secret

Створіть новий client secret у розділі Certificates & secrets, вставте його Value в Client secret у Localtonet і натисніть Зберегти провайдера.

Microsoft просить схвалення адміністратора

Ваш орендар не дозволяє користувачам самостійно надавати згоду для застосунків. Адміністратор орендаря має надати згоду для застосунку в Microsoft Entra admin center.

«403 - Access Denied» після успішного входу в Microsoft

Правило Localtonet відхилило обліковий запис. Перевірте Правила доступу за email у провайдері та Хто може входити у тунелі, а також чи має обліковий запис адресу електронної пошти взагалі. Після виправлення правила зачекайте хвилину й перезавантажте сторінку.

Підтримка