Єдиний вхід через 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, введіть наведений нижче URI переспрямування й натисніть Configure.
- Відкрийте Certificates & secrets › Client secrets і виберіть New client secret. Додайте опис, виберіть строк дії та натисніть Add. Одразу скопіюйте Value секрету: після виходу зі сторінки Microsoft більше ніколи його не покаже.
URI переспрямування (платформа: Web)http://auth.localtonet.com/auth/callbackClient 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. Після збереження він ніколи не відображається. Відкрийте Ендпоінти й 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, а потім натисніть Зберегти провайдера.
-
Увімкніть його для тунелю #
У розділі Ваші тунелі натисніть Налаштування тунелю, потім Керувати поруч із 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. Або вкажіть ідентифікатор свого орендаря в обох ендпоінтах, або змініть застосунок на тип облікових записів із кількома орендарями.
Для типу облікових записів із кількома орендарями або особистих облікових записів у 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 у провайдері та Хто може входити у тунелі, а також чи має обліковий запис адресу електронної пошти взагалі. Після виправлення правила зачекайте хвилину й перезавантажте сторінку.