Настройка средства Администратор AccessHub с помощью Azure Active Directory B2C
В этом руководстве описано, как интегрировать Azure Active Directory B2C (Azure AD B2C) с TheAccessHub Администратор Tool из N8 Identity N8ID. Решение предназначено для миграции учетной записи клиента и администрирования запросов на обслуживание клиентов (CSR).
Используйте это решение в следующих сценариях:
- У вас есть сайт, и вы хотите перейти на Azure AD B2C.
- Однако миграция учетной записи клиента является сложной задачей, включая пароли.
- Вам потребуется средство CSR для администрирования Azure AD учетных записей B2C.
- Делегированное администрирование CSR является обязательным требованием.
- Вы хотите синхронизировать и объединять данные из репозиториев в Azure AD B2C.
Предварительные требования
Чтобы приступить к работе, вам потребуется:
Подписка Azure
- Если у вас ее нет, вы можете получить бесплатную учетную запись Azure.
- Клиент Azure AD B2C, связанный с вашей подпиской Azure.
- Среда средства Администратор AccessHub
- См. раздел N8 Identity/contact for a new environment (Удостоверение или контакт N8 ) для новой среды.
- Необязательное действие:
- Сведения о подключении и учетных данных для баз данных или протоколов LDAP, из которых требуется перенести данные клиентов
- Настроенная среда Azure AD B2C для пользовательских политик для интеграции TheAccessHub Администратор Tool в поток политики регистрации.
Описание сценария
Средство Администратор TheAccessHub выполняется в подписке N8ID Azure или клиентской подписке. Принцип работы системы показан на схеме архитектуры ниже.
- Пользователь переходит на страницу входа, создает учетную запись и вводит сведения. Azure Active Directory B2C собирает атрибуты пользователя.
- Azure AD B2C вызывает средство Администратор TheAccessHub и передает атрибуты пользователя.
- Средство Администратор AccessHub проверяет базу данных на наличие текущих сведений о пользователе.
- Пользовательские записи синхронизируются из базы данных в TheAccessHub Администратор Tool.
- Средство Администратор AccessHub предоставляет доступ к данным с делегированным администратором CSR или службы технической поддержки.
- Средство Администратор AccessHub синхронизирует записи пользователей с Azure AD B2C.
- На основе ответа TheAccessHub Администратор Tool Azure AD B2C отправляет пользователям настраиваемое приветственное сообщение электронной почты.
Создание глобального администратора в арендаторе Azure AD B2C
Разрешения Средства Администратор AccessHub действуют от имени глобального администратора для чтения сведений о пользователе и внесения изменений в клиент Azure AD B2C. Изменения, внесенные обычными администраторами, не повлияют на взаимодействие TheAccessHub Администратор Tool с клиентом.
Чтобы создать глобального администратора, выполните следующие действия.
- В портал Azure войдите в клиент Azure AD B2C с правами администратора.
- Перейдите в раздел Microsoft Entra идентификаторы>пользователей.
- Выберите пункт New User (Новый пользователь).
- Используйте команду Создать пользователя, чтобы создать обычного пользователя каталога, а не клиента.
- В форме сведений об удостоверении:
- Введите имя пользователя, например theaccesshub.
- Введите имя учетной записи, например Учетная запись службы TheAccessHub.
- Выберите Показать пароль.
- Скопируйте и сохраните исходный пароль.
- Чтобы назначить роль глобального администратора, в поле Пользователь выберите текущую роль пользователя.
- Выберите запись Глобальный администратор.
- Нажмите кнопку создания.
Подключение средства Администратор AccessHub к клиенту Azure AD B2C
Средство Администратор AccessHub использует API Graph Майкрософт для чтения и внесения изменений в каталог. Этот API действует как глобальный администратор клиента. Используйте следующие инструкции, чтобы добавить необходимые разрешения.
Чтобы авторизовать средство администрирования TheAccessHub для доступа к каталогу, выполните следующие действия.
- Используйте учетные данные N8 Identity, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Системный администратор>Azure AD B2C Config (Конфигурация Azure AD B2C).
- Выберите команду Авторизовать подключение.
- В новом окне выполните вход с помощью учетной записи глобального администратора. При первом входе с новой учетной записью службы может появиться запрос на сброс пароля.
- Следуйте инструкциям и выберите Принять.
Настройка нового пользователя CSR с помощью корпоративного удостоверения
Создайте пользователя CSR или службы технической поддержки, который обращается к TheAccessHub Администратор Tool с учетными данными корпоративного Microsoft Entra.
Чтобы настроить для пользователя CSR или helpdesk единый вход, выполните следующие действия.
- Используйте учетные данные N8 Identity, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Manager Tools(Средства диспетчера)>Управление коллегами.
- Выберите Добавить коллегу.
- Выберите для поля Colleague Type (Тип коллеги) значение Azure Administrator (Администратор Azure).
- Чтобы получить сведения о профиле, выберите домашнюю организацию, чтобы контролировать, у кого есть разрешения на управление этим пользователем.
- В поле Идентификатор входа или Azure AD Имя пользователя введите имя участника-пользователя из учетной записи Microsoft Entra пользователя.
- На вкладке Роли TheAccessHub выберите управляемую роль службы технической поддержки .
- Нажмите кнопку Submit (Отправить).
Примечание
Роль службы поддержки предоставляет доступ к представлению Управление коллегами . Поместите пользователя в группу или сделайте его владелец организации.
Настройка нового пользователя CSR с новым удостоверением
Создайте пользователя CSR или службы технической поддержки для доступа к theAccessHub Администратор Tool с новыми локальными учетными данными. Этот пользователь предназначен для организаций, которые не используют идентификатор Microsoft Entra.
См. раздел AccessHub Администратор Tool: Add Коллега Administrator без единого входа.
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Manager Tools(Средства диспетчера)>Управление коллегами.
- Выберите Добавить коллегу.
- Выберите для поля Colleague Type (Тип коллеги) значение Локальный администратор.
- Чтобы получить сведения о профиле, выберите домашнюю организацию, чтобы контролировать, у кого есть разрешения на управление этим пользователем.
- На вкладке Роли TheAccessHub выберите управляемую роль службы технической поддержки .
- Скопируйте атрибуты Идентификатор входа/адрес электронной почты и Одноразовый пароль. Предоставьте их новому пользователю для входа в TheAccessHub Администратор Tool.
- Нажмите кнопку Submit (Отправить).
Примечание
Роль службы поддержки предоставляет доступ к представлению Управление коллегами . Поместите пользователя в группу или сделайте его владелец организации.
Настройка секционированного администрирования CSR
В theAccessHub Администратор Tool разрешения на управление пользователями клиентов и CSR/helpdesk управляются через иерархию организации. У коллег и клиентов есть домашняя организация. В качестве владельцев организации можно назначить коллег или группы коллег.
Владельцы организации могут управлять и изменять коллег и клиентов в организациях или суборганизациях, которыми они владеют. Чтобы несколько коллег управляли набором пользователей, создайте группу с несколькими участниками. Затем назначьте группу в качестве владелец организации. Все участники группы могут управлять коллегами и клиентами в организации.
Создание группы
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите на страницу Организация > Управление группами.
- Выберите Добавить группу.
- Введите значения для параметров Имя группы, Описание группы и Владелец группы.
- Найдите и выберите поля для коллег, которые будут членами группы.
- Выберите Добавить.
- Участники группы отображаются в нижней части страницы. Выберите X в строке, чтобы удалить элемент.
- Нажмите кнопку Submit (Отправить).
Создание организации
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите в раздел Управление организациями>.
- Выберите Добавить организацию.
- Введите значения для параметра Название организации, Владелец организации и Родительская организация.
- Нажмите кнопку Submit (Отправить).
Примечание
Согласуйте название организации с данными клиента. При загрузке данных о коллеге и клиенте и вводе имени организации в загрузке коллега отображается в организации. Владелец управляет клиентами и коллегами в организации и подорганизациях. Родительская организация несет ответственность за организацию.
Изменение иерархии с помощью древовидной структуры
Используйте эту функцию для визуализации управления коллегами и группами.
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите в к пункту Manager Tools(Средства диспетчера)>Представление в виде дерева.
- Чтобы изменить иерархию, перетащите организации в родительские организации.
- Щелкните Сохранить.
Настройка приветственного уведомления
Если вы используете theAccessHub Администратор Tool для переноса пользователей из одного решения в Azure AD B2C, вы можете настроить уведомление о приветственном приветствие пользователя. Уведомление отправляется пользователям во время миграции и может содержать ссылку для установки нового пароля в каталоге Azure AD B2C.
Для настройки уведомления выполните следующие действия.
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Системный администратор>Уведомления.
- Выберите шаблон Создать коллегу
- Выберите Изменить.
- Внесите необходимые изменения в сообщение и шаблон. Поле Шаблон поддерживает HTML и может отправлять уведомления в формате HTML.
- Щелкните Сохранить.
Перенос данных из внешних источников данных в Azure AD B2C
С помощью инструмента TheAccessHub Администратор можно импортировать данные из различных баз данных, LDAP и .csv файлов, а затем отправить эти данные в клиент Azure AD B2C. Вы загружаете данные, чтобы перенести их в тип коллеги пользователя Azure AD B2C в TheAccessHub Администратор Tool.
Совет
Если источником данных является не Azure, данные походят в theAccessHub Администратор Tool и Azure AD B2C. Если внешний источник данных не является .csv файлом на компьютере, настройте источник данных перед загрузкой данных. Выполните следующие действия, чтобы создать источник данных и загрузить данные.
Настройка источника данных
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Системный администратор>Источники данных.
- Выберите команду Добавить источник данных.
- Укажите значения для полей Имя и Тип для источника данных.
- Введите данные формы для баз данных:
- Тип: База данных
- Тип базы данных: выберите поддерживаемую базу данных.
-
URL-адрес подключения: введите строку подключения JDBC, например
jdbc:postgresql://myhost.com:5432/databasename
- Имя пользователя: имя пользователя для доступа к базе данных.
- Пароль: пароль для доступа к базе данных
-
Запрос: SQL-запрос для извлечения сведений о клиенте, например
SELECT * FROM mytable;
' - Выберите Проверить подключение. Появится пример данных, подтверждающий, что подключение работает.
- Введите данные формы для LDAP:
- Тип: LDAP
-
Узел: имя узла или IP-адрес компьютера, на котором выполняется сервер LDAP, например
mysite.com
- Порт, номер порта, в котором сервер LDAP прослушивает
- SSL, установите флажок для средства Администратор TheAccessHub для связи с LDAP с помощью SSL (рекомендуется)
- Имя входа: различающееся имя учетной записи пользователя (DN) для входа и выполнения поиска LDAP
- Пароль: пароль пользователя
- Базовое DN: DN в верхней части иерархии, в которой выполняется поиск.
- Фильтр: строка фильтра LDAP для получения записей клиентов.
- Атрибуты: разделенный запятыми список атрибутов из записей клиента для передачи в TheAccessHub Администратор Tool
- Нажмите Проверить подключение. Появится пример данных, подтверждающий, что подключение работает.
- Введите данные для OneDrive. Тип: OneDrive для бизнеса.
- Выберите команду Авторизовать подключение.
- В новом окне появится запрос на вход в OneDrive. Войдите с доступом на чтение к учетной записи OneDrive. Средство Администратор AccessHub считывает .csv загрузки файлов.
- Следуйте инструкциям и нажмите кнопку Принять.
- Щелкните Сохранить.
Синхронизация данных из источника данных в Azure AD B2C
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Системный администратор>Синхронизация данных.
- Выберите пункт New Load (Новая загрузка).
- Тип коллеги: Azure AD пользователя B2C.
- выберите значение Источник. В диалоговом окне выберите источник данных. Если вы создали источник данных OneDrive, выберите файл.
- Чтобы создать новые учетные записи клиентов, измените первую политику , если коллега не найден в TheAccessHub THEN: Do Nothing (Если коллега не найден в TheAccessHub THEN: Do Nothing).
- Чтобы обновить учетные записи клиентов, измените вторую политику, ЕСЛИ источник и данные TheAccessHub несоответствие ТО: ничего не делать.
- Выберите Далее.
- В конфигурации Search-Mapping определите корреляцию нагрузки и записей с клиентами в TheAccessHub Администратор Tool.
- Выберите источник идентифицирующие атрибуты. Сопоставление атрибутов TheAccessHub Администратор Tool с одинаковыми значениями. При совпадении запись переопределяется. В противном случае создается новый клиент.
- Последовательность количества проверок. Например, сначала проверка адрес электронной почты, а затем имя и фамилию.
- В расположенном слева меню выберите пункт Сопоставление данных.
- В конфигурации сопоставления данных назначьте атрибуты TheAccessHub Администратор Tool для заполнения из исходных атрибутов. Несопоставленные атрибуты остаются неизменными для клиентов. Если сопоставить атрибут
org_name
с текущим значением организации, созданные клиенты будут входить в организацию. - Выберите Далее.
- Чтобы эта нагрузка была повторяющейся, выберите Ежедневно/ Еженедельно или Ежемесячно. В противном случае оставьте значение по умолчанию Сейчас.
- Нажмите кнопку Submit (Отправить).
- Для расписания "Сейчас " в синхронизацию данных добавляется новая запись.
- Если проверка составляет 100 процентов, выберите новую запись, чтобы увидеть результат. Для запланированных загрузок записи отображаются по истечении запланированного времени.
- Если ошибок нет, выберите Выполнить. В противном случае, чтобы удалить нагрузку, в меню Дополнительно выберите Удалить.
- При возникновении ошибок можно вручную обновить записи. В каждой записи выберите Обновить и внесите исправления.
- Если синхронизация данных составляет 100 процентов, клиенты отображаются или получают изменения в Azure AD B2C.
Совет
При наличии нескольких ошибок можно продолжить работу с ошибками и устранить их позже. В средстве Администратор TheAccessHub используйте средства поддержки.
Синхронизация данных заказчиков Azure AD B2C
Средство Администратор AccessHub может синхронизировать сведения о клиентах из Azure AD B2C в TheAccessHub Администратор Tool в виде однократной или текущей операции. Эта операция гарантирует, что администраторы CSR или службы технической поддержки будут видеть актуальные сведения о клиентах.
Для синхронизации данных из Azure AD B2C в средство администрирования TheAccessHub сделайте следующее.
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Системный администратор>Синхронизация данных.
- Выберите пункт New Load (Новая загрузка).
- Тип коллеги: Azure AD пользователя B2C.
- В поле Параметры оставьте значения по умолчанию.
- Выберите Далее.
- Для поиска сопоставления & данных оставьте значения по умолчанию. Исключение. Если сопоставить атрибут
org_name
с текущим значением организации, в организации появятся созданные клиенты. - Выберите Далее.
- Чтобы загрузка была повторяющейся, выберите ежедневное или еженедельное или ежемесячное расписание. В противном случае оставьте значение по умолчанию Сейчас . Рекомендуется повторять.
- Нажмите кнопку Submit (Отправить).
- Если вы выбрали кнопку Сейчас, в синхронизации данных появится новая запись. После проверки на 100 процентов выберите новую запись, чтобы увидеть результат нагрузки. Для запланированных загрузок записи отображаются по истечении запланированного времени.
- Если ошибок нет, выберите Выполнить. В противном случае, чтобы удалить нагрузку, в меню Дополнительно выберите Удалить.
- При возникновении ошибок вручную обновите каждую запись и выберите Обновить.
- Если синхронизация данных составляет 100 процентов, инициируются изменения.
Совет
При наличии нескольких ошибок можно продолжить работу с ошибками и устранить их позже. В средстве Администратор AccessHub используйте средства поддержки.
Настройка политики Azure AD B2C
Если время от времени вы синхронизируете TheAccessHub Администратор Tool, оно может быть не обновлено с Azure AD B2C. Вы можете использовать API средства Администратор TheAccessHub и Azure AD политики B2C для информирования TheAccessHub Администратор Tool об изменениях. Для этого решения требуются технические знания настраиваемых политик Azure AD B2C.
Создание безопасных учетных данных для вызова API средства Администратор TheAccessHub
Для пользовательских политик регистрации следующие действия позволяют безопасному сертификату уведомлять TheAccessHub Администратор Tool о новых учетных записях.
- Используйте учетные данные N8ID, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Системный администратор>Admin Tools(Средства администрирования)>API Security (Безопасность API).
- Выберите Создать.
- Скопируйте значение Пароль сертификата.
- Для сертификата клиента выберите Скачать.
- Чтобы добавить сертификат клиента в Azure AD B2C, используйте инструкцию в разделе Проверка подлинности сертификата клиента HTTPS.
Получение примеров настраиваемой политики
- Используйте учетные данные N8 Identity, предоставленные для входа в TheAccessHub Администратор Tool.
- Перейдите к пункту Системный администратор>Admin Tools(Средства администрирования)>Azure B2C Policies (Политики Azure B2C).
- Укажите домен арендатора Azure AD B2C и два идентификатора Identity Experience Framework из своей конфигурации Identity Experience Framework.
- Щелкните Сохранить.
- Нажмите кнопку Скачать для скачивания ZIP-файла с базовыми политиками, добавляющими заказчиков в средство администрирования TheAccessHub во время их регистрации.
- Используйте инструкции из статьи Создание потоков пользователей для разработки пользовательских политик в Azure AD B2C.