Руководство по настройке Jumio для работы с Azure Active Directory B2C

В этом руководстве описано, как интегрировать Azure Active Directory B2C (Azure AD B2C) с Jumio, службой проверки идентификации, которая обеспечивает автоматическую проверку идентификаторов в режиме реального времени для защиты данных клиентов.

Предварительные требования

Чтобы приступить к работе, вам потребуется:

• Подписка Azure

  • Если у вас ее нет, получите бесплатную учетную запись Azure.

• Клиент Azure AD B2C, связанный с вашей подпиской Azure.

Описание сценария

Интеграция с Jumio предусматривает перечисленные ниже компоненты.

• Azure AD B2C — сервер авторизации, который проверяет учетные данные пользователя, также известный как поставщик удостоверений (IdP).
• Jumio — проверка сведений об идентификаторе пользователя
• Промежуточный REST API — используйте его для реализации интеграции Azure AD B2C и Jumio
• Хранилище BLOB-объектов Azure — используйте его для получения пользовательских файлов пользовательского интерфейса для Azure AD политик B2C

Принцип работы системы показан на схеме архитектуры ниже.

1. Пользователь входит в систему или регистрируется и создает учетную запись. Azure Active Directory B2C собирает атрибуты пользователя.
2. Azure AD B2C вызывает API среднего уровня и передает атрибуты пользователя.
3. API среднего уровня преобразует пользовательские атрибуты в формат API Jumio и отправляет атрибуты в Jumio.
4. Jumio обрабатывает атрибуты и возвращает результаты в API среднего уровня.
5. API среднего уровня обрабатывает результаты и отправляет соответствующую информацию в Azure AD B2C.
6. Azure AD B2C получает информацию. Если ответ завершается сбоем, появляется сообщение об ошибке. Если ответ выполнен успешно, пользователь проходит проверку подлинности и записывается в каталог.

Создание учетной записи Jumio

Чтобы создать учетную запись Jumio, перейдите на страницу контактов jumio.com.

Настройка Azure AD B2C для работы с Jumio

После создания учетной записи Jumio используйте ее для настройки Azure AD B2C.

Развертывание API

Разверните код в службе Azure из samples/Jumio/API/Jumio.Api/. Вы можете опубликовать код из Visual Studio.

Развертывание сертификата клиента

Сертификат клиента помогает защитить вызов API Jumio.

1. Создайте самозаверяющий сертификат с помощью приведенного ниже примера кода PowerShell.

   $cert = New-SelfSignedCertificate -Type Custom -Subject "CN=Demo-SigningCertificate" -TextExtension @("2.5.29.37={text}1.3.6.1.5.5.7.3.3") -KeyUsage DigitalSignature -KeyAlgorithm RSA -KeyLength 2048 -NotAfter (Get-Date).AddYears(2) -CertStoreLocation "Cert:\CurrentUser\My"
   $cert.Thumbprint
   $pwdText = "Your password"
   $pwd = ConvertTo-SecureString -String $pwdText -Force -AsPlainText
   Export-PfxCertificate -Cert $Cert -FilePath "{your-local-path}\Demo-SigningCertificate.pfx" -Password $pwd.
   
   

2. Сертификат экспортируется в расположение, указанное для {your-local-path}.

3. Сведения об импорте сертификата в Служба приложений Azure см. в разделе Отправка закрытого сертификата.

Создание ключа подписывания или шифрования

1. Создайте случайную строку длиной более 64 символов (только буквы и цифры).

   Например: C9CB44D98642A7062A0D39B94B6CDC1E54276F2E7CFFBF44288CEE73C08A8A65.

2. Создать такую строку можно с помощью приведенного ниже сценария PowerShell.

-join ((0x30..0x39) + ( 0x41..0x5A) + ( 0x61..0x7A) + ( 65..90 ) | Get-Random -Count 64  | % {[char]$_})

Настройка API

Вы можете настроить параметры приложения в Служба приложений Azure, не проверяя их в репозитории. Для REST API необходимо указать перечисленные ниже параметры:

Развертывание пользовательского интерфейса

1. Настройте контейнер хранилища BLOB-объектов в своей учетной записи хранения.
2. Сохраните файлы пользовательского интерфейса из /samples/Jumio/UI/ в контейнере больших двоичных объектов.

Изменение файлов пользовательского интерфейса

1. В файлах пользовательского интерфейса перейдите в раздел /samples/Jumio/UI/ocean_blue/.
2. Откройте каждый HTML-файл.
3. Найдите и замените {your-ui-blob-container-url} URL-адресом контейнера BLOB-объектов.
4. Найдите и замените {your-intermediate-api-url} промежуточным URL-адресом службы приложения API.

Настройка политики Azure Active Directory B2C

1. Перейдите к Azure AD политике B2C в разделе /samples/Jumio/Policies/.
2. Чтобы скачать начальный пакет LocalAccounts, воспользуйтесь инструкциями в разделе Начальный пакет настраиваемой политики.
3. Настройте политику для клиента Azure Active Directory B2C.

Тестирование потока пользователя

1. Откройте клиент Azure AD B2C.
2. В разделе Политики выберите Identity Experience Framework.
3. Выберите созданный SignUpSignIn.
4. Выберите Выполнить поток пользователя.
5. В поле Приложение выберите зарегистрированное приложение (например, JWT).
6. URL-адрес ответа: выберите URL-адрес перенаправления.
7. Выберите Выполнить поток пользователя.
8. Завершите процесс регистрации.
9. Создайте учетную запись.
10. После создания атрибута пользователя вызывается Jumio.

Дальнейшие действия

• Пользовательские политики в Azure AD B2C
• Начало работы с настраиваемыми политиками в Azure AD B2C