Доменная авторизация через площадку
Контроллер домена не всегда стоит рядом с сервером IDENTYX: он может находиться внутри площадки — удалённой сети, до которой прямого маршрута нет. Чтобы такой домен можно было использовать для входа и синхронизации пользователей, в карточке LDAP-домена есть поле «Площадка»: выбрав площадку, вы указываете, что подключаться к контроллеру домена нужно не напрямую, а через неё.
В разделе описано, как привязать LDAP-домен к площадке, какие требования предъявляются к адресу контроллера домена, что нужно сделать для работы LDAPS через площадку, как читать сообщения проверки подключения и что происходит с входом и синхронизацией, когда площадка недоступна. Общие настройки LDAP-доменов описаны на странице LDAP/Active Directory.
- Когда это нужно
- Поле «Площадка» в карточке домена
- Адрес контроллера домена внутри площадки
- Настройка шаг за шагом
- LDAPS через площадку: сертификат удостоверяющего центра
- Проверка подключения при сохранении
- Синхронизация пользователей домена на площадке
- Вход пользователя
- Откуда берётся список площадок
- Решение проблем
- Рекомендации
Когда это нужно
Обычный LDAP-домен настраивается в расчёте на то, что сервер IDENTYX может обратиться к контроллеру домена сам: указан адрес, есть маршрут, есть открытый порт. С площадкой это условие не выполняется: площадка — это удалённая сеть, до узлов которой прямого сетевого пути нет, а строить до неё отдельный канал ради одной службы каталога не хочется. Задачу решает шлюз площадки: он работает внутри её сети, сам выходит на связь, и обращения к контроллеру домена идут через него по уже установленному соединению.
IDENTYX
│
▼
шлюз площадки — внутри её сети
│
▼
контроллер домена на площадке
Шлюз площадки заводят и обслуживают в приложении INFRAX — там же, где заводят сами площадки. IDENTYX только пользуется готовой площадкой: настроить или починить её шлюз отсюда нельзя.
Через площадку выполняются все обращения к контроллеру домена: проверка подключения при сохранении карточки, проверка области синхронизации, сама синхронизация пользователей и проверка пароля при входе.
Если поле «Площадка» оставлено пустым, домен работает ровно как раньше: прямое подключение к контроллеру домена, прежние правила заполнения поля «Адрес КД» и прежние тексты ошибок. Единственное исключение касается LDAPS и описано в разделе про сертификат удостоверяющего центра.
Поле «Площадка» в карточке домена
Поле находится в разделе Интеграции → Ldap домены → карточка домена → вкладка «Основные настройки» → блок «Идентификация домена», сразу под полем «Адрес КД». Это выпадающий список; пока площадка не выбрана, в нём показана подпись «Без площадки — контроллер домена доступен напрямую».
Подсказка под полем меняется в зависимости от выбора:
- Площадка не выбрана — «Оставьте пустым, если контроллер домена доступен напрямую, без площадки». IDENTYX подключается к контроллеру домена сам, по адресу из поля «Адрес КД»
- Площадка выбрана — «Подключение пойдёт через шлюз площадки — напрямую этот контроллер домена недоступен». Все обращения к контроллеру домена идут через шлюз выбранной площадки
У списка есть крестик очистки: он снимает площадку и возвращает домен к прямому подключению. Значение вписать вручную нельзя — площадка выбирается только из готового списка.
Поле показывается, только если список площадок не пуст либо площадка у домена уже сохранена. На установке без площадок блока в карточке нет вовсе. Отсюда следует практическое ограничение: если список площадок пуст, а у домена площадка была, то после нажатия крестика поле сразу исчезнет из формы и вернуть площадку через интерфейс уже не получится.
Если сохранённой у домена площадки больше нет в списке, карточка сообщает об этом дважды: в выпадающем списке появляется пункт «Площадка не найдена (<ключ площадки>)», а под полем красным выводится предупреждение «Площадка не найдена в справочнике — вход через этот домен работать не будет». Пока список площадок ещё загружается, предупреждение не показывается.
В списке доменов (Интеграции → Ldap домены) колонки с площадкой нет — площадка видна только внутри карточки домена.
Адрес контроллера домена внутри площадки
Как только у домена выбрана площадка, требования к полю «Адрес КД» становятся строже. Подсказка под полем меняется на «Контроллер домена стоит внутри площадки, поэтому здесь нужен его IP-адрес (имена при подключении через площадку не разрешаются). Порт определяется флагом LDAPS и в адресе не указывается».
| Требование | Домен без площадки | Домен на площадке |
|---|---|---|
| Формат адреса | IP-адрес или DNS-имя | Только IP-адрес (IPv4 или IPv6) — тот, по которому контроллер домена адресуется внутри сети площадки |
| Порт в адресе | Можно указать | Не указывается: порт задаётся флагом «LDAPS (порт 636)» — 636 при включённом флаге, 389 при снятом |
| Нестандартный порт контроллера домена | Поддерживается | Задать нельзя |
Проверка выполняется в момент обращения к контроллеру домена — то есть при сохранении карточки, при проверке области синхронизации, при каждом проходе синхронизации и при входе пользователя. Тексты отказов:
- «Домен привязан к площадке «<название>», поэтому в поле «Адрес КД» нужен IP-адрес контроллера домена внутри площадки: имена при подключении через площадку не разрешаются. Сейчас указано «<введённое значение>»»
- «Для домена на площадке порт контроллера домена задаётся флагом LDAPS и равен 636, а в адресе указан 389. Подключение через площадку открывает путь внутрь её сети, поэтому произвольный порт назначения здесь не запрашивается.»
Если домен раньше работал напрямую и в поле «Адрес КД» было записано DNS-имя, то после выбора площадки домен перестанет работать, пока имя не будет заменено на IP-адрес контроллера домена внутри площадки. Меняйте адрес и площадку одновременно.
Всплывающая подсказка самого поля «Адрес КД» остаётся прежней — «IP адрес или DNS имя контроллера домена» — независимо от того, выбрана площадка или нет. Ориентируйтесь на подпись под полем: именно она отражает действующие требования.
Настройка шаг за шагом
Как привязать домен к площадке
- Убедитесь, что площадка заведена и действует в приложении INFRAX. Площадки со статусом «Ожидает подключения» и «Отозвана» в список не попадают
- Откройте раздел Интеграции → Ldap домены
- Нажмите «Добавить домен» либо откройте карточку существующего домена
- На вкладке «Основные настройки» в блоке «Идентификация домена» заполните «Имя домена»
- В поле «Адрес КД» укажите IP-адрес контроллера домена так, как он адресуется внутри площадки. Порт не дописывайте
- В списке «Площадка» выберите нужную площадку
- В блоке «Учетная запись для подключения» заполните «Логин» и «Пароль» служебной учётной записи. В карточке существующего домена для смены учётных данных включите «Сменить учетную запись»
- Если контроллер домена на площадке слушает LDAPS, включите «LDAPS (порт 636)» — предварительно выполните шаги из раздела про сертификат удостоверяющего центра
- Нажмите «Сохранить». Карточка сразу выполнит проверку подключения
Чтобы вернуть домен к прямому подключению, очистите поле «Площадка» крестиком, приведите «Адрес КД» к адресу, доступному с сервера IDENTYX напрямую, и сохраните карточку.
LDAPS через площадку: сертификат удостоверяющего центра
При работе через площадку IDENTYX подключается не на сам контроллер домена, а на адрес, который открывает путь внутрь сети площадки. Поэтому имя сервера в сертификате не совпадает и не проверяется, и единственным подтверждением подлинности контроллера домена остаётся его удостоверяющий центр, которому администратор доверился явно.
Об этом предупреждает информационная плашка под настройками LDAP: она появляется, как только у домена выбрана площадка и включён флаг «LDAPS (порт 636)».
Что нужно сделать
- Получите сертификат удостоверяющего центра, выпустившего сертификат контроллера домена на площадке, в формате PEM (файл
.pemили.crt) - Положите файл в каталог
/opt/identyx/data/ldap-caна сервере IDENTYX. Если каталога ещё нет, создайте его — автоматически он не создаётся - Перезапустите IDENTYX. Набор доверенных удостоверяющих центров закрепляется в момент первого LDAPS-подключения и дальше не меняется, поэтому без перезапуска новый файл подействует не везде и не сразу — в частности, фоновая синхронизация продолжит работать со старым набором
- В карточке домена включите «LDAPS (порт 636)» и нажмите «Сохранить» — проверка подключения должна пройти
Пока подходящего сертификата нет, подключение отклоняется с требованием положить сертификат УЦ (PEM) в /opt/identyx/data/ldap-ca и перезапустить identyx.
Список доверенных удостоверяющих центров один на все LDAPS-домены. Как только в каталоге появляется хотя бы один сертификат, системный набор публичных удостоверяющих центров больше не используется ни для одного LDAPS-домена. Поэтому обычные LDAPS-домены — в том числе без площадки, — чей удостоверяющий центр в каталог не положен, перестанут подключаться. К их ошибкам добавляется подсказка: «Если контроллер домена отвечает, но соединение не устанавливается, проверьте, что сертификат его удостоверяющего центра лежит в /opt/identyx/data/ldap-ca».
Галочка «Не проверять сертификат (на всю установку)» для домена на площадке в карточке не показывается вовсе. Для доменов без площадки она остаётся (и видна только при включённом флаге «LDAPS (порт 636)»), но действует на весь процесс. Как только галочка поставлена, под ней появляется предупреждение: «Проверка сертификата в identyx общая для всего процесса, поэтому эта галочка отключает её для всех LDAPS-доменов установки. Точечная замена — положить сертификат УЦ этого контроллера домена в /opt/identyx/data/ldap-ca и снять галочку.»
Галочка и заданные сертификаты взаимно исключают друг друга. Если в каталоге уже есть сертификаты, включённая галочка даёт явную ошибку, а не молчаливое послабление: «Галочка «Не проверять сертификат» не действует: в /opt/identyx/data/ldap-ca заданы доверенные удостоверяющие центры, а проверка сертификата в identyx общая для всего процесса. Положите сертификат этого контроллера домена (или его УЦ) туда же — и снимите галочку.»
Если флаг «LDAPS (порт 636)» снят, домен на площадке подключается без шифрования и никаких дополнительных подтверждений или сертификатов не требует.
Проверка подключения при сохранении
Кнопка «Сохранить» внизу карточки домена не просто записывает настройки. Сначала система показывает окно «Сохранение...» и пробует реально подключиться к контроллеру домена служебной учётной записью и получить список пользователей — для домена на площадке это делается через её шлюз. По умолчанию домен записывается только после успешной проверки — но её можно пропустить, подтвердив сохранение вручную (см. ниже).
- Проверка прошла. Открывается окно «Домен успешно сохранен» с текстом «Домен успешно сохранен и протестирован. Подключение к контроллеру домена установлено успешно. Найдено пользователей в домене: <N>»
- Проверка не прошла. Домен не сохраняется молча: открывается окно «Ошибка подключения к LDAP домену» с текстом ошибки и вопросом «Сохранить домен всё равно?», кнопки «Да, сохранить» и «Отмена». По кнопке «Да, сохранить» проверка пропускается, домен записывается и появляется уведомление «Домен сохранен»
Домен можно сохранить и без успешной проверки подключения — это удобно, когда площадка ещё не подключена. Но в списке доменов такой домен ничем не отличается от проверенного. Чтобы узнать текущую причину сбоя, откройте карточку и нажмите «Сохранить» ещё раз.
Единственное, что нельзя обойти подтверждением, — неизвестная площадка. Если у домена сохранена площадка, которой нет в справочнике, сохранение отклоняется сообщением «Площадка не найдена в справочнике: <ключ площадки>», и домен не записывается вовсе. Исключение — установка, на которой справочник площадок пуст совсем (приложение INFRAX не подключено или ещё ничего не публиковало): сказать по пустому справочнику нечего, поэтому проверка пропускается и домен сохраняется, хотя красное предупреждение под полем остаётся.
Сообщения об ошибках подключения
Для домена на площадке тексты различают, на каком именно участке пути возникла проблема. Это разные ситуации, и действия по ним разные.
| Сообщение | Что означает | Что делать |
|---|---|---|
| «Шлюз площадки «<название>» не на связи, поэтому контроллер домена сейчас недоступен» | Шлюз площадки сейчас не на связи: он выключен, недоступен или ещё не подключился. До контроллера домена дело не дошло | Разбирайтесь с площадкой в INFRAX, а не с настройками домена. Пока шлюз площадки не вернётся на связь, домен работать не будет |
| «Шлюз площадки «<название>» на связи, но контроллер домена <адрес> внутри площадки не отвечает» | Шлюз площадки на связи, путь внутрь её сети есть, но по указанному адресу никто не ответил | Проверьте IP-адрес в поле «Адрес КД», работу самого контроллера домена и то, что он доступен с машины, где работает шлюз площадки |
| «Связь с площадками сейчас не работает — дело не в домене и не в его контроллере. Обратитесь к тому, кто разворачивал систему: подробности записаны в журнал» | IDENTYX не может дотянуться до площадок вообще: та часть инсталляции, которая их обслуживает, не отвечает, отказала в служебном запросе или ответила не по форме. Состояние самой площадки при этом неизвестно — она может быть полностью исправна. Текст один на все такие причины: администратору домена они не помогают, а точная причина (адрес, код ответа, путь к файлу) пишется в журнал ошибок | Это сбой инсталляции, а не настроек домена. Обратитесь к тому, кто разворачивал систему; ему нужен журнал ошибок IDENTYX — там строка, начинающаяся с sitelink: |
| «Не удалось открыть путь к контроллеру домена <IP>:<порт> на площадке «<название>»: <ответ>» | Путь к указанному адресу внутри площадки открыть отказались. Частая причина — площадка больше не зарегистрирована | Проверьте состояние площадки в INFRAX и выберите в карточке домена действующую площадку |
| «Площадка не найдена в справочнике: <ключ площадки>» | Площадки, сохранённой у домена, больше нет в списке — её отозвали или удалили в INFRAX | Выберите в поле «Площадка» действующую площадку либо очистите поле и переведите домен на прямое подключение |
Учтите: проверка обращается к живому контроллеру домена, поэтому при недоступной площадке ответа приходится ждать до истечения таймаутов, и окно «Сохранение...» всё это время остаётся на экране.
Синхронизация пользователей домена на площадке
Синхронизация домена, стоящего на площадке, ничем не отличается от обычной: те же настройки на вкладке «Синхронизация», те же кнопки, тот же живой прогресс. Разница только в том, что обращение к контроллеру домена идёт через шлюз площадки. Подробности настройки описаны на странице Автоматическая синхронизация пользователей из LDAP.
Кнопка «Проверить область синхронизации» тоже работает через площадку и при недоступности выдаёт ту же причину с префиксом «Не удалось проверить область синхронизации: ».
Если пароль служебной учётной записи не вводился заново и берётся из сохранённого домена, то менять в этой же проверке адрес контроллера домена или площадку нельзя: «Для проверки области с сохранённым паролем нельзя менять адрес контроллера домена или площадку — укажите пароль заново». Включите «Сменить учетную запись» и введите пароль.
Что происходит, если площадка недоступна
Проход синхронизации завершается ошибкой в самом начале — ещё до того, как из домена что-либо прочитано. Практические последствия:
- Данные пользователей не обновляются — ни имена, ни email
- Пользователи не блокируются. Обработка пропавших выполняется только внутри успешного полного прохода, поэтому недоступность площадки не приводит к массовой блокировке
- Накопленная позиция синхронизации не сдвигается: как только площадка вернётся на связь, очередной проход продолжит с того же места
- Текст ошибки сохраняется и показывается в блоке «Состояние синхронизации» как «Последняя ошибка» с датой и временем
Ошибки фоновой синхронизации нигде не всплывают уведомлением. Увидеть их можно, только открыв карточку домена, перейдя на вкладку «Синхронизация» и нажав «Обновить» в блоке «Состояние синхронизации». Если пользователи такого домена перестали появляться в системе, начинайте разбор именно с этого блока.
Вход пользователя
Для пользователя не меняется ничего. На странице входа он вводит доменный логин в формате домен\пользователь или пользователь@домен и свой доменный пароль, а система проверяет пароль на контроллере домена через шлюз площадки.
Если дотянуться до контроллера домена не удалось, пользователь видит отдельное сообщение: «Вход по доменной учётной записи сейчас недоступен, обратитесь к администратору». Из него понятно, что дело не в пароле, но технических подробностей нет.
Форма входа доступна без аутентификации, поэтому в неё намеренно не выводятся адреса контроллеров домена, названия площадок и признак «площадка на связи». Полная причина записывается в журнал событий безопасности вместе с именем домена и именем пользователя, а администратор может увидеть её же, открыв карточку домена и нажав «Сохранить».
При неверном пароле поведение прежнее — общий отказ в аутентификации, без упоминания площадки.
Откуда берётся список площадок
IDENTYX не ведёт список площадок сам. Его публикует подключённое приложение INFRAX вместе с остальными своими справочниками — как справочник «Площадки». IDENTYX только зеркалит эти данные: заводить, переименовывать и удалять площадки в IDENTYX нельзя.
Каждая публикация заменяет содержимое справочника целиком. Поэтому площадка, исчезнувшая в INFRAX, исчезает и здесь, а привязанный к ней домен начинает показывать «Площадка не найдена в справочнике — вход через этот домен работать не будет».
В список попадают только действующие площадки. Не попадают:
- площадка самой инсталляции (в INFRAX она так и помечена) — до её контроллеров домена и так есть прямой доступ;
- площадки со статусом «Ожидает подключения» — их шлюз ещё ни разу не выходил на связь;
- площадки со статусом «Отозвана» — путь внутрь их сети больше не открывается.
Как посмотреть справочник
- Откройте Интеграции → Приложения
- Откройте карточку приложения и перейдите на вкладку «Справочники»
- В блоке «Справочники приложения» найдите строку «Площадки»
- Нажмите кнопку просмотра (подсказка «Просмотреть содержимое справочника») — откроется окно «Справочник "Площадки"» со списком элементов и счётчиком «Всего элементов». Если площадок нет, выводится «Справочник пуст»
Отдельной страницы «Площадки» в IDENTYX нет. Подробнее о справочниках, которые публикуют приложения, — на странице Словари приложений. Раздел «Приложения» доступен только супер-администратору.
Решение проблем
| Проблема | Возможные причины | Решение |
|---|---|---|
| Нужной площадки нет в списке «Площадка» | У площадки в INFRAX статус «Ожидает подключения» или «Отозвана»; нужна площадка самой инсталляции; справочник ещё не опубликован приложением | Проверьте состояние площадки в INFRAX. В список попадают только действующие площадки; после исправления справочник обновляется автоматически |
| Поля «Площадка» в карточке домена нет вовсе | Список площадок пуст, а у домена площадка не задана | Убедитесь, что приложение INFRAX подключено и в нём есть хотя бы одна действующая площадка |
| Под полем красным: «Площадка не найдена в справочнике — вход через этот домен работать не будет» | Площадка отозвана или удалена в INFRAX после того, как домен был настроен | Выберите действующую площадку либо очистите поле крестиком и переведите домен на прямое подключение. Сохранить домен с несуществующей площадкой не удастся — пока справочник площадок не пуст |
| Домен сохранён, но доменные пользователи не входят, а локальные входят | Домен был записан кнопкой «Да, сохранить» без успешной проверки, и это нигде не помечено | Откройте карточку и нажмите «Сохранить» ещё раз — проверка покажет актуальную причину |
| При сохранении — отказ по содержимому поля «Адрес КД» | В адресе осталось DNS-имя от прямого подключения либо дописан порт | Укажите IP-адрес контроллера домена внутри площадки и уберите порт: его задаёт флаг «LDAPS (порт 636)» — включён 636, снят 389 |
| LDAPS через площадку не подключается | Сертификата удостоверяющего центра нет в каталоге /opt/identyx/data/ldap-ca либо после его добавления IDENTYX не перезапускали |
Положите сертификат УЦ в формате PEM в каталог и перезапустите IDENTYX (см. раздел про сертификат) |
| После добавления сертификата перестали подключаться другие LDAPS-домены | Доверие общее для всей установки: заданные сертификаты вытесняют системный набор публичных удостоверяющих центров | Положите в тот же каталог сертификаты удостоверяющих центров остальных контроллеров домена и перезапустите IDENTYX |
| Синхронизация не проходит, в «Последней ошибке» — текст про шлюз площадки | Шлюз площадки не на связи | Восстановите связь со шлюзом площадки в INFRAX. Восстанавливать что-либо в IDENTYX не нужно: данные не менялись, пользователи не блокировались, позиция синхронизации не сдвинулась |
| Сообщение «Связь с площадками сейчас не работает» | Не работает связь IDENTYX с той частью инсталляции, которая обслуживает площадки | Это сбой инсталляции, а не настроек домена — обратитесь к тому, кто разворачивал систему, и передайте ему журнал ошибок IDENTYX |
Дополнительные типовые ситуации по доменам собраны на странице Устранение неполадок.
Рекомендации
Если планируется LDAPS, положите сертификат удостоверяющего центра в каталог и перезапустите IDENTYX до создания домена. Иначе первое же сохранение упрётся в отказ, а перезапуск придётся планировать отдельно.
Прежде чем разбирать «домен не работает», проверьте состояние площадки в INFRAX. Большая часть отказов — это не настройки домена, а шлюз площадки, который не на связи.
У домена одно поле «Площадка», и все обращения идут через неё. Указывайте адрес того контроллера домена, который стоит именно на этой площадке, и меняйте адрес одновременно с площадкой.
Если площадку отзывают или выводят из эксплуатации в INFRAX, сразу поправьте или отключите привязанные к ней домены. Иначе доменные пользователи узнают об этом первыми — по отказу на входе.
Как настроить автоматическое создание, обновление и блокировку учётных записей домена — на странице Автоматическая синхронизация пользователей из LDAP.