Поделиться через


средство массовой аттестации Клиентское соглашение Майкрософт

Соответствующие роли: глобальный администратор | Агент администрирования

Применимые облака: глобальные

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

Средство массовой аттестации имеет несколько функций:

  • Консольное средство .NET с открытым кодом с открытым кодом (7.0)
  • Поддерживает формат файла с разделим запятыми (.csv) для настройки массовых аттестаций
  • Изменения кода не требуются, и их можно использовать с помощью команды .NET.
  • Код является расширяемым и может быть улучшен в качестве партнеров, которые считают подходящим
  • Обширный журнал может помочь в устранении неполадок

Это средство предназначено для партнеров по прямым счетам и косвенных поставщиков, которые проходят через программу CSP.

Необходимые компоненты

  • Учетные записи партнеров должны быть включены для многофакторной проверки подлинности (MFA), так как API рабочей области клиента применяют MFA. Вы можете добавить MFA, следуя инструкциям в разделе "Mandating MFA" для клиента партнера.

  • Убедитесь, что на хост-компьютере установлен пакет SDK для .NET 7.0.

  • Настройка собственного приложения в Центре партнеров:

    1. В Центре партнеров выберите параметры учетной записи параметров (значок шестеренки). >

      Снимок экрана: меню параметров Центра партнеров с выделенными параметрами учетной записи.

    2. Выберите страницу управления приложениями .

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

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

      Теперь вы сможете увидеть только что созданное приложение в портал Azure в Регистрация приложений идентификатора >Записи Azure.

      Снимок экрана: страница Регистрация приложений с выделенным приложением Для Центра партнеров.

    4. Используйте вкладку "Проверка подлинности", чтобы добавить платформу для мобильных и классических приложений.

      Снимок экрана: страница проверки подлинности с открытым всплывающем меню

    5. http://localhost Настройте и другие URI перенаправления для приложения.

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

    6. После сохранения убедитесь, что URI перенаправления перечислены на платформе мобильных и классических приложений, а маркеры идентификаторов выбираются в разделе "Неявное предоставление" и гибридных потоков.

    Дополнительные сведения см. в статье "Проверка подлинности Центра партнеров".

Запуск средства массовой аттестации Клиентское соглашение Майкрософт

  1. Перейдите в примеры DotNet Центра партнеров на GitHub и выберите "Скачать ZIP-файл кода>", чтобы извлечь файлы в локальную папку. В извлеченной папке будет вложенная папка с именем Клиентское соглашение Майкрософт RefreshBulkAttestationCLITool. Теперь вы готовы запустить средство.

  2. Откройте командную строку и перейдите в папку, в которой вы извлекли файлы.

  3. Выполните следующую команду: dotnet run. При необходимости дождитесь завершения сборки.

  4. Укажите идентификатор приложения и имя участника-пользователя (UPN). Используйте собственный идентификатор приложения, настроенный вами, и имя участника-пользователя.

  5. Войдите в учетную запись с помощью MFA.

  6. В средстве показаны следующие параметры, описанные в следующих разделах:

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

Проверка подлинности

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

После успешной проверки подлинности появится следующее сообщение. Закройте окно браузера и вернитесь в консольное приложение.

Снимок экрана: окно localhost браузера с сообщением о том, что это нормально, чтобы закрыть вкладку браузера.

Сценарии

Перед использованием средства обратите внимание:

  • Средство не предназначено для предоставления сведений о прямом принятии клиентов
  • Средство имеет проверку входных данных по паритету с API создания соглашения Центра партнеров

Существует два сценария, поддерживаемые средством: получение записей клиентского соглашения и обновление записей клиентского соглашения.

Получение записей клиентского соглашения

Эта операция использует API Центра партнеров для получения всех записей клиентского соглашения, которые находятся в области Клиентское соглашение Майкрософт Обновить для вашего клиента партнера. Затем средство сохраняет записи в CSV-файл (CustomerAgreementRecords.csv) в пути выбора.

Если клиентское соглашение было обновлено (через массовое средство, портал Центра партнеров или API создания соглашения), запись не будет возвращена в операции получения. Он также не будет включен в CSV-файл. Все записи, возвращаемые в CSV-файле, являются действиями и должны быть обновлены.

Пример выполнения операции получения:

Снимок экрана: средство массовой аттестации с сообщением о том, что оно извлекает 14 записей клиентского соглашения из Центра партнеров.

Часть возвращаемых полей содержит контактные данные клиента для последнего соглашения, подтвержденного партнером. Если существовал предыдущий аттестация (соглашение, подтвержденное партнером от имени клиента), контактные данные клиента отображаются в следующих полях. В противном случае они будут пустыми. Эти сведения предоставляются для удобства, если принимающие агент совпадают во время обновления принятия, но в противном случае следует обновить, чтобы точно отразить сведения о принятии. Уведомление по электронной почте будет отправлено клиенту с помощью предоставленного сообщения электронной почты после того, как партнер подтвердит принятие Клиентское соглашение Майкрософт.

CSV-файл содержит следующие поля:

  • Идентификатор клиента: клиент клиента или идентификатор Майкрософт
  • Контактные данные клиента:
    • FirstName: имя принимающего агента в организации клиента последнего соглашения, подтвержденного партнером.
    • LastName: фамилия принимающего агента в организации клиента последнего соглашения, подтвержденного партнером.
    • Электронная почта: адрес электронной почты принимающего агента в организации клиента последнего соглашения, подтвержденного партнером
    • PhoneNumber: номер телефона принимающего агента в организации клиента последнего соглашения, подтвержденного партнером.
    • LastAgreementDate: дата последнего соглашения, подтвержденного партнером
  • Завершение аттестации партнера: логическое значение, указывающее, должна ли запись соглашения клиента обновляться массовым инструментом. Это поле имеет False значение по умолчанию и должно иметь значение True для всех записей, которые требуется обновить.
  • Ссылка на учетную запись клиента: нерабоспособное поле, которое используется для отображения прямой ссылки на страницу учетной записи клиента в Центре партнеров. Средство заполняет это поле, но не используется для каких-либо операций и не должно быть изменено.

Пример CSV-файла:

Снимок экрана: пример выходных данных из CSV-файла.

Совет

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

Обновление записей клиентского соглашения

Эта операция использует API Центра партнеров для обновления записей соглашения клиента из CSV-файла, созданного операцией получения.

Перед обновлением записи клиентского соглашения убедитесь, что контактные данные клиента для принимающего агента в организации клиента являются точными и актуальными. Для этого обновите следующие поля в CSV-файле:

  • FirstName
  • LastName
  • Эл. почта
  • PhoneNumber (необязательно)

Дата соглашения будет заполняться автоматически в Центре партнеров.

Чтобы пометить запись клиентского соглашения для обновления, задайте для поля "Завершенная аттестация партнеров" значение True для записи в CSV-файле. Средство обрабатывает только записи, для которых задано значение True.

Пример обновления CSV-файла для первых 2 клиентов , возвращенных из операции получения:

Снимок экрана: пример выходных данных из CSV-файла, в котором завершено аттестация партнера— True.

После пометки записей клиентского соглашения, которые вы хотите обновить, сохранить и закрыть CSV-файл, а затем активировать операцию обновления из меню инструментов. Средство предложит указать путь к CSV-файлу. После успешного анализа записей средство отображает количество найденных и запускаемых операций обновления.

Для больших объемов соглашений обновления могут занять некоторое время, так как максимальное количество соглашений об обновлении каждого отправленного вызова составляет 500. Операции обновления выполняются асинхронно после достижения Центра партнеров. Вы можете ожидать задержку, когда средство завершает операции обновления и когда записи соглашения клиента обновляются в Центре партнеров.

Пример выполнения операции обновления:

Снимок экрана: средство массовой аттестации с сообщением о том, что он обработал две интерактивные записи и завершил операцию.