средство массовой аттестации Клиентское соглашение Майкрософт
Соответствующие роли: глобальный администратор | Агент администрирования
Применимые облака: глобальные
Средство массовой аттестации, Клиентское соглашение Microsoft позволяет партнерам подтвердить принятие Клиентское соглашение Microsoft от имени своих клиентов. Это средство предназначено для того, чтобы помочь партнерам, у которых много клиентов, и область усилий по обновлению Клиентского соглашения Microsoft.
Средство массовой аттестации имеет несколько функций:
- Консольное средство .NET с открытым кодом с открытым кодом (7.0)
- Поддерживает формат файла с разделим запятыми (.csv) для настройки массовых аттестаций
- Изменения кода не требуются, и их можно использовать с помощью команды .NET.
- Код является расширяемым и может быть улучшен в качестве партнеров, которые считают подходящим
- Обширный журнал может помочь в устранении неполадок
Это средство предназначено для партнеров по прямым счетам и косвенных поставщиков, которые проходят через программу CSP.
Необходимые компоненты
Учетные записи партнеров должны быть включены для многофакторной проверки подлинности (MFA), так как API рабочей области клиента применяют MFA. Вы можете добавить MFA, следуя инструкциям в разделе "Mandating MFA" для клиента партнера.
Убедитесь, что на хост-компьютере установлен пакет SDK для .NET 7.0.
Настройка собственного приложения в Центре партнеров:
В Центре партнеров выберите параметры учетной записи параметров (значок шестеренки). >
Выберите страницу управления приложениями .
Выберите и добавьте новое собственное приложение. Для вас создается новое приложение. Скопируйте идентификатор приложения и сохраните его в удобном состоянии.
Теперь вы сможете увидеть только что созданное приложение в портал Azure в Регистрация приложений идентификатора >Записи Azure.
Используйте вкладку "Проверка подлинности", чтобы добавить платформу для мобильных и классических приложений.
http://localhost Настройте и другие URI перенаправления для приложения.
После сохранения убедитесь, что URI перенаправления перечислены на платформе мобильных и классических приложений, а маркеры идентификаторов выбираются в разделе "Неявное предоставление" и гибридных потоков.
Дополнительные сведения см. в статье "Проверка подлинности Центра партнеров".
Запуск средства массовой аттестации Клиентское соглашение Майкрософт
Перейдите в примеры DotNet Центра партнеров на GitHub и выберите "Скачать ZIP-файл кода>", чтобы извлечь файлы в локальную папку. В извлеченной папке будет вложенная папка с именем Клиентское соглашение Майкрософт RefreshBulkAttestationCLITool. Теперь вы готовы запустить средство.
Откройте командную строку и перейдите в папку, в которой вы извлекли файлы.
Выполните следующую команду:
dotnet run
. При необходимости дождитесь завершения сборки.Укажите идентификатор приложения и имя участника-пользователя (UPN). Используйте собственный идентификатор приложения, настроенный вами, и имя участника-пользователя.
Войдите в учетную запись с помощью MFA.
В средстве показаны следующие параметры, описанные в следующих разделах:
Проверка подлинности
После запуска средства он пытается автоматически получить маркер проверки подлинности. Если он завершится ошибкой, активируется интерактивный режим, и откроется окно браузера, чтобы попросить вас войти. Используйте те же учетные данные, которые используются при входе в Центр партнеров.
После успешной проверки подлинности появится следующее сообщение. Закройте окно браузера и вернитесь в консольное приложение.
Сценарии
Перед использованием средства обратите внимание:
- Средство не предназначено для предоставления сведений о прямом принятии клиентов
- Средство имеет проверку входных данных по паритету с API создания соглашения Центра партнеров
Существует два сценария, поддерживаемые средством: получение записей клиентского соглашения и обновление записей клиентского соглашения.
Получение записей клиентского соглашения
Эта операция использует API Центра партнеров для получения всех записей клиентского соглашения, которые находятся в области Клиентское соглашение Майкрософт Обновить для вашего клиента партнера. Затем средство сохраняет записи в CSV-файл (CustomerAgreementRecords.csv) в пути выбора.
Если клиентское соглашение было обновлено (через массовое средство, портал Центра партнеров или API создания соглашения), запись не будет возвращена в операции получения. Он также не будет включен в CSV-файл. Все записи, возвращаемые в CSV-файле, являются действиями и должны быть обновлены.
Пример выполнения операции получения:
Часть возвращаемых полей содержит контактные данные клиента для последнего соглашения, подтвержденного партнером. Если существовал предыдущий аттестация (соглашение, подтвержденное партнером от имени клиента), контактные данные клиента отображаются в следующих полях. В противном случае они будут пустыми. Эти сведения предоставляются для удобства, если принимающие агент совпадают во время обновления принятия, но в противном случае следует обновить, чтобы точно отразить сведения о принятии. Уведомление по электронной почте будет отправлено клиенту с помощью предоставленного сообщения электронной почты после того, как партнер подтвердит принятие Клиентское соглашение Майкрософт.
CSV-файл содержит следующие поля:
- Идентификатор клиента: клиент клиента или идентификатор Майкрософт
- Контактные данные клиента:
- FirstName: имя принимающего агента в организации клиента последнего соглашения, подтвержденного партнером.
- LastName: фамилия принимающего агента в организации клиента последнего соглашения, подтвержденного партнером.
- Электронная почта: адрес электронной почты принимающего агента в организации клиента последнего соглашения, подтвержденного партнером
- PhoneNumber: номер телефона принимающего агента в организации клиента последнего соглашения, подтвержденного партнером.
- LastAgreementDate: дата последнего соглашения, подтвержденного партнером
- Завершение аттестации партнера: логическое значение, указывающее, должна ли запись соглашения клиента обновляться массовым инструментом. Это поле имеет
False
значение по умолчанию и должно иметь значениеTrue
для всех записей, которые требуется обновить. - Ссылка на учетную запись клиента: нерабоспособное поле, которое используется для отображения прямой ссылки на страницу учетной записи клиента в Центре партнеров. Средство заполняет это поле, но не используется для каких-либо операций и не должно быть изменено.
Пример CSV-файла:
Совет
Перед активацией первой операции обновления рекомендуется сохранить копию записей соглашения клиента, возвращенных в другое расположение для собственных записей. После успешного обновления записей соглашения клиента они рассматриваются как разрешенные и не будут возвращены в будущем.
Обновление записей клиентского соглашения
Эта операция использует API Центра партнеров для обновления записей соглашения клиента из CSV-файла, созданного операцией получения.
Перед обновлением записи клиентского соглашения убедитесь, что контактные данные клиента для принимающего агента в организации клиента являются точными и актуальными. Для этого обновите следующие поля в CSV-файле:
- FirstName
- LastName
- Эл. почта
- PhoneNumber (необязательно)
Дата соглашения будет заполняться автоматически в Центре партнеров.
Чтобы пометить запись клиентского соглашения для обновления, задайте для поля "Завершенная аттестация партнеров" значение True для записи в CSV-файле. Средство обрабатывает только записи, для которых задано значение True.
Пример обновления CSV-файла для первых 2 клиентов , возвращенных из операции получения:
После пометки записей клиентского соглашения, которые вы хотите обновить, сохранить и закрыть CSV-файл, а затем активировать операцию обновления из меню инструментов. Средство предложит указать путь к CSV-файлу. После успешного анализа записей средство отображает количество найденных и запускаемых операций обновления.
Для больших объемов соглашений обновления могут занять некоторое время, так как максимальное количество соглашений об обновлении каждого отправленного вызова составляет 500. Операции обновления выполняются асинхронно после достижения Центра партнеров. Вы можете ожидать задержку, когда средство завершает операции обновления и когда записи соглашения клиента обновляются в Центре партнеров.
Пример выполнения операции обновления: