Развертывание соединителя для архивации данных Twitter

В этой статье описывается процесс развертывания соединителя, который использует службу импорта Microsoft 365 для импорта данных из учетной записи Twitter вашей организации в Microsoft 365. Общие сведения об этом процессе и список предварительных требований, необходимых для развертывания соединителя Twitter, см. в статье Настройка соединителя для архивации данных Twitter.

Шаг 1. Создание приложения в Microsoft Entra ID

  1. Перейдите по адресу https://portal.azure.com и войдите с учетными данными учетной записи глобального администратора.

    Важно!

    Microsoft рекомендует использовать роли с наименьшим количеством разрешений. Минимизация числа пользователей с ролью глобального администратора помогает повысить безопасность организации. Дополнительные сведения о ролях и разрешениях Microsoft Purview.

    Снимок экрана: страница портал Azure входа для учетных данных глобального администратора.

  2. В области навигации слева выберите Microsoft Entra ID.

    Снимок экрана: левая область навигации с выбранным Microsoft Entra ID в портал Azure.

  3. В области навигации слева выберите Регистрация приложений (предварительная версия) и выберите Создать регистрацию.

    Снимок экрана: страница Microsoft Entra ID Регистрация приложений с параметром

  4. Зарегистрируйте приложение. В разделе URI перенаправления (необязательно) выберите Интернет в раскрывающемся списке Тип приложения, а затем введите https://portal.azure.com в поле для URI.

    Снимок экрана: параметры регистрации приложения, на котором показан URI перенаправления, настроенный для портал Azure.

  5. Скопируйте идентификатор приложения (клиента) и идентификатор каталога (клиента) и сохраните их в текстовом файле или в другом безопасном расположении. Эти идентификаторы будут использоваться на последующих шагах.

    Снимок экрана: страница обзора приложения с идентификатором приложения (клиента) и идентификатором каталога (клиента).

  6. Перейдите в раздел Сертификаты & секреты для нового приложения и в разделе Секреты клиента выберите Новый секрет клиента.

    Снимок экрана: страница

  7. Создайте новый секрет. В поле описания введите секрет и выберите срок действия.

    Снимок экрана: форма секрета клиента с полем описания и параметрами срока действия.

  8. Скопируйте значение секрета и сохраните его в текстовый файл или другое место хранения. Это Microsoft Entra секрет приложения, который вы будете использовать на последующих шагах.

    Снимок экрана: значение секрета клиента, отображаемое для копирования и сохранения.

Шаг 2. Развертывание веб-службы соединителя из GitHub в учетную запись Azure

  1. Перейдите на этот сайт GitHub и выберите Развернуть в Azure.

    Снимок экрана: страница репозитория GitHub с выделенной кнопкой

  2. После выбора параметра Развернуть в Azure вы будете перенаправлены на портал Azure со страницей пользовательского шаблона. Введите основные сведения исведения о параметрах , а затем выберите Купить.

    Снимок экрана: страница портал Azure пользовательского шаблона с полями

    • Подписки: Выберите свою Azure подписку, в которой вы хотите развернуть веб-службу соединителя Twitter.
    • Группа ресурсов: Выберите или создайте новую группу ресурсов. Группа ресурсов — это контейнер, содержащий связанные ресурсы для решения Azure.
    • Расположение: Выберите расположение.
    • Имя веб-приложения: Укажите уникальное имя веб-приложения соединителя. Имя должно содержать от 3 до 18 символов. Это имя используется для создания URL-адреса службы приложений Azure. Например, если указать имя веб-приложения twitterconnector, url-адрес службы приложений Azure будет twitterconnector.azurewebsites.net.
    • tenantId: Идентификатор клиента организации Microsoft 365, скопированный после создания приложения соединителя Twitter в Microsoft Entra ID на шаге 1.
    • APISecretKey: В качестве секрета можно ввести любое значение. Это значение используется для доступа к веб-приложению соединителя на шаге 5.
  3. После успешного развертывания страница выглядит следующим образом:

    Снимок экрана: портал Azure с успешным развертыванием веб-службы соединителя.

Шаг 3. Создание приложения Twitter

  1. Перейдите по адресу https://developer.twitter.com, войдите с учетными данными для учетной записи разработчика для вашей организации и выберите Приложения.

    Снимок экрана: домашняя страница портала разработчика Twitter с параметром

  2. Выберите Создать приложение.

    Снимок экрана: страница приложений на портале разработчика Twitter с возможностью создания нового приложения.

  3. В разделе Сведения о приложении введите сведения о приложении.

    Снимок экрана: форма сведений о приложении Twitter для ввода сведений о приложении.

  4. На панели мониторинга разработчика Twitter выберите только что созданное приложение, а затем выберите Сведения.

    Снимок экрана: панель мониторинга разработчика Twitter с сведениями о приложении и идентификатором приложения.

  5. На вкладке Ключи и маркеры в разделе Ключи API потребителя скопируйте ключ API и секретный ключ API и сохраните их в текстовый файл или другое место хранения. Затем нажмите кнопку Создать , чтобы создать маркер доступа и секрет маркера доступа и скопируйте их в текстовый файл или другое место хранения.

    Снимок экрана: страница

    Выберите Создать , чтобы создать маркер доступа и секрет маркера доступа, а затем скопируйте их в текстовый файл или другое место хранения.

  6. Перейдите на вкладку Разрешения и настройте разрешения, как показано на следующем снимке экрана:

    Снимок экрана: вкладка

  7. После сохранения параметров разрешений перейдите на вкладку Сведения о приложении , а затем выберите Изменить > сведения.

    Снимок экрана: страница сведений о приложении Twitter с выбранным параметром

  8. Выполните следующие задачи.

    • Установите флажок, чтобы разрешить приложению-соединителю вход в Twitter.
    • Добавьте URI перенаправления OAuth в следующем формате: <connectorserviceuri>/Views/TwitterOAuth, где значение connectorserviceuri — это AZURE URL-адрес службы приложений для вашей организации.

    Снимок экрана: параметры приложения Twitter с включенным разрешением на вход и настроенным URI перенаправления OAuth.

Приложение для разработчиков Twitter теперь готово к использованию.

Шаг 4. Настройка веб-приложения соединителя

  1. Перейдите по адресу https://<AzureAppResourceName>.azurewebsites.net (где AzureAppResourceName — это имя ресурса приложения Azure, имя которого вы назвали на шаге 2). Домашняя страница приложения выглядит следующим образом:

    Снимок экрана: домашняя страница веб-приложения соединителя, размещенного Azure.

  2. Выберите Настроить , чтобы отобразить страницу входа.

    Снимок экрана: страница входа в веб-приложение соединителя, открытая с помощью параметра Настроить.

  3. В поле Идентификатор клиента введите или вставьте идентификатор клиента Microsoft Entra (идентификатор каталога (клиента) из регистрации приложения Microsoft Entra). В поле пароля введите или вставьте значение APISecretKey из параметров шаблона развертывания Azure, а затем выберите Задать параметры конфигурации, чтобы отобразить страницу сведений о конфигурации.

    Снимок экрана: страница входа с полями идентификатора клиента и секретного ключа API.

  4. Введите следующие параметры конфигурации:

    • Ключ API Twitter: Ключ API для приложения Twitter, созданного на шаге 3.
    • Секретный ключ API Twitter: Секретный ключ API для приложения Twitter, созданного на шаге 3.
    • Маркер доступа Twitter: Маркер доступа, созданный на шаге 3.
    • Секрет маркера доступа Twitter: Секрет маркера доступа, созданный на шаге 3.
    • Microsoft Entra идентификатор приложения: идентификатор приложения Microsoft Entra, созданного на шаге 1.
    • Microsoft Entra секрет приложения. Значение секрета клиента приложения Microsoft Entra, созданного во время регистрации приложения в Microsoft Entra ID.
  5. Нажмите кнопку Сохранить , чтобы сохранить параметры соединителя.

Шаг 5. Настройка соединителя Twitter

  1. Войдите на портал Microsoft Purview.

  2. Выберите Параметры Соединители>данных.

  3. Выберите Мои соединители, а затем — Добавить соединитель.

  4. В списке выберите Twitter.

  5. На странице Условия обслуживания выберите Принять.

  6. На странице Добавление учетных данных для приложения соединителя введите следующие сведения, а затем выберите Проверить подключение.

    • В поле Имя введите имя соединителя, например дескриптор справки Twitter.
    • В поле URL-адрес соединителя введите или вставьте URL-адрес службы приложений Azure.
    • В поле Пароль введите или вставьте значение APISecretKey из параметров шаблона развертывания Azure.
    • В поле идентификатор приложение Azure введите или вставьте значение идентификатора приложения приложение Azure (также называемого идентификатором клиента), полученного на шаге 1.
  7. После успешной проверки подключения нажмите кнопку Далее.

  8. На странице Авторизация импорта данных Microsoft 365 введите или вставьте APISecretKey еще раз, а затем выберите Войти в веб-приложение.

  9. Выберите Вход с помощью Twitter.

  10. На странице входа в Twitter войдите, используя учетные данные для учетной записи Twitter вашей организации. После входа на странице Twitter отображается следующее сообщение "Задание соединителя Twitter успешно настроено".

  11. Нажмите кнопку Продолжить , чтобы завершить настройку соединителя Twitter.

  12. На странице Установка фильтров можно применить фильтр для первоначального импорта элементов определенного возраста. Выберите возраст и нажмите кнопку Далее.

  13. На странице Выбор расположения хранилища введите адрес электронной почты почтового ящика Microsoft 365, в который импортируются элементы Twitter, и нажмите кнопку Далее.

  14. Нажмите кнопку Далее , чтобы просмотреть параметры соединителя, а затем нажмите кнопку Готово , чтобы завершить настройку соединителя.