В этом руководстве описан процесс регистрации приложения Azure AD, чтобы BuiltWith мог проходить аутентификацию в вашем экземпляре Dynamics 365 и автоматически обновлять данные о потенциальных клиентах. Вам потребуются права администратора Azure Active Directory и права системного администратора Dynamics 365.
Шаг 1 — Зарегистрируйте новое приложение в Azure Active Directory.
Войдите на портал portal.azure.com , используя свою учетную запись администратора Azure. В левом меню выберите Azure Active Directory , затем выберите «Регистрация приложений» и нажмите «+ Новая регистрация» .
Введите имя, например, BuiltWith Integration . В разделе «Поддерживаемые типы учетных записей» выберите «Учетные записи только в этом организационном каталоге (один клиент)» . Оставьте поле «URI переадресации» пустым и нажмите «Зарегистрировать» .
На странице обзора приложения скопируйте идентификатор приложения (клиента) и идентификатор каталога (арендатора) — оба понадобятся вам при вводе учетных данных в BuiltWith.
Шаг 2 — Настройка разрешений API для Dynamics 365
При регистрации приложения нажмите «Разрешения API» в левом меню, затем нажмите «+ Добавить разрешение ». Выберите Dynamics CRM (найдите его в разделе «API, используемые моей организацией», если он отсутствует в списке). Выберите «Делегированные разрешения» , установите флажок «user_impersonation» и нажмите «Добавить разрешения» .
Шаг 3 — Создайте секретный ключ клиента.
В разделе регистрации приложения нажмите «Сертификаты и секреты» . В разделе «Секреты клиента» нажмите «+ Новый секрет клиента» , введите описание, например, BuiltWith , выберите срок действия и нажмите «Добавить» .
Сразу же скопируйте секретное значение (длинную строку в столбце «Значение», а не секретный идентификатор). Это значение отображается только один раз и будет скрыто после того, как вы покинете страницу.
Шаг 4 — Предоставьте согласие администратора
Вернитесь к настройкам разрешений API в разделе регистрации вашего приложения и нажмите «Предоставить согласие администратора». Нажмите «Да» для подтверждения. После предоставления согласия в столбце «Статус» рядом с каждым разрешением должна появиться зеленая галочка.
Шаг 5 — Добавьте приложение в качестве пользователя приложения Dynamics 365.
Перейдите на сайт admin.powerplatform.microsoft.com и выберите свою среду. Перейдите в раздел «Настройки» → «Пользователи + разрешения» → «Пользователи приложений» и нажмите «+ Новый пользователь приложения» .
Нажмите «+ Добавить приложение» , найдите зарегистрированное имя вашего приложения (BuiltWith Integration) и выберите его. Выберите ваше подразделение и нажмите «Создать» .
Откройте созданного пользователя приложения и назначьте ему роль безопасности «Продавец» или пользовательскую роль, которая включает доступ на чтение и запись к сущности «Лид». Минимум, роль должна включать права на создание, чтение, запись, добавление и добавление в сущность «Лид».
Шаг 6 — Введите учетные данные в BuiltWith
Вернитесь на страницу подключения BuiltWith Dynamics 365 и заполните следующие поля:
Идентификатор клиента — идентификатор приложения (клиента), скопированный на шаге 1.
Секретный ключ клиента — значение секрета, скопированное на шаге 3 (а не идентификатор секрета).
Идентификатор арендатора — идентификатор каталога (арендатора), скопированный на шаге 1.
URL-адрес Dynamics 365 — это URL-адрес вашего экземпляра Dynamics 365, например, https://yourorg.crm.dynamics.com. Его можно найти в центре администрирования Power Platform в разделе «Среды» → «Ваша среда» → «URL-адрес среды».
Нажмите «Сохранить» . BuiltWith проверит учетные данные с помощью тестового вызова к вашему экземпляру Dynamics 365. После подтверждения процесс обогащения лидов начнется автоматически.
Если вы видите ошибку аутентификации, убедитесь, что на шаге 4 было предоставлено согласие администратора и что пользователю приложения назначена правильная роль безопасности на шаге 5.