Настройка доступа через API в Центре партнеров

Статья
11/28/2023

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

В этой статье описываются учетные записи, которые потребуются для разработки с помощью пакета SDK Центра партнеров. В этой статье также описано, как создать учетную запись песочницы интеграции и выполнить тестирование в этой песочнице.

Примечание.

Чтобы получить доступ к API-интерфейсам, клиент должен быть зарегистрирован в CSP, а вы должны быть косвенным поставщиком или партнером с прямым выставлением счетов.

Определения учетных записей

Чтобы помочь интегрировать и проверить интеграцию API, Центр партнеров поддерживает два типа учетных записей:

Основная учетная запись партнера

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

Интеграция учетной записи типа "песочница"

Эта учетная запись предназначена для тестирования кода и его интеграции с интерфейсами API Центра партнеров перед широким развертыванием приложения. Изменения и транзакции, осуществляемые после входа в учетную запись типа "песочница", будут отражены в вашем счете, но вам не нужно будет выплачивать указанную за них сумму. В PDF-файл будет добавлена оговорка "DO NOT PAY. THIS IS A SANDBOX INVOICE AND NO ACTION IS REQUIRED" (НЕ ОПЛАЧИВАТЬ. ЭТО ТЕСТОВЫЙ СЧЕТ. НИКАКИХ ДЕЙСТВИЙ НЕ ТРЕБУЕТСЯ).

Учетная запись песочницы интеграции и основная учетная запись действуют независимо и не совместно используют учетные записи администратора, учетные записи пользователей, клиентов, заказы, подписки или другие данные.

Песочница интеграции поддерживает транзакции с ограниченным количеством клиентов, заказов, подписок, лицензий и т. д.

По политике учетные записи песочницы интеграции предназначены только для тестирования интеграции.

По умолчанию учетная запись песочницы интеграции не создается. Вы должны самостоятельно создать ее, если планируете использовать SDK Центра партнеров.

Настройка учетных записей

В этом разделе описывается, как настроить основную учетную запись партнера и учетную запись песочницы интеграции для SDK Центра партнеров.

Создание песочницы интеграции

Войдите в Центр партнеров с помощью учетной записи глобального администратора и выберите Параметры (шестеренка).

Примечание.

Для создания песочницы требуется, чтобы глобальный партнер Администратор вошел в Центр партнеров с помощью псевдонима домена onmicrosoft.com (например, alias@domain.onmicrosoft.com). Создание песочницы завершится ошибкой, если пользователь вошел в систему с помощью личного домена.
Выберите параметры учетной записи, а затем песочницу интеграции.

Примечание.

Если вы не видите вариант "Песочница интеграции", возможно, у вас нет учетной записи глобального администратора. Также возможно, что у вас уже настроена песочница интеграции и вы сейчас используете учетную запись для нее.
Введите контактные данные учетной записи для администратора песочницы интеграции. Затем выберите Создать учетную запись. Через несколько минут появится сообщение, подтверждающее успешное создание учетной записи.
Получив это подтверждение, выйдите из Панели мониторинга для партнеров.
Снова войдите в систему, но теперь уже с новой учетной записью администратора песочницы интеграции. Обязательно вводите учетные данные в формате username@domain и указывайте для них созданный пароль.
Выберите учетную запись настройки на странице песочницы интеграции, чтобы завершить настройку учетной записи песочницы.

Включение доступа к API

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

Войдите в Центр партнеров с помощью учетной записи глобального администратора и выберите Параметры (шестеренка).
Выберите параметры учетной записи, а затем управление приложениями.
Если у вас еще нет веб-приложения, добавьте новое веб-приложение. Если у вас есть веб-приложение, нажмите кнопку Добавить ключ.
Скопируйте регистрационные данные приложения, в частности ключ, если вы создаете веб-приложение, и сохраните их в надежном месте.
Выйдите из Панели мониторинга для партнеров.
Снова войдите в систему, но теперь уже с учетной записью песочницы интеграции. Повторите действия 2–5, чтобы включить доступ к API в песочнице интеграции.

Создание и тестирование кода

Вы можете создавать и тестировать код в песочнице интеграции. Чтобы настроить проверку подлинности Центра партнеров с помощью идентификатора Microsoft Entra, вам потребуется следующая информация.

Наименование номенклатуры	Расположение элемента
Идентификатор приложения / идентификатор клиента	В Параметры (шестеренка) выберите параметры учетной записи, а затем управление приложениями. Идентификатор приложения и идентификатор клиента указаны как идентификатор зарегистрированного приложения.
Ключ.	Если при работе с разделом Включение доступа к API вы создали веб-приложение, здесь нужно указать ключ, сохраненный на шаге 5.
Домен	Это домен для песочницы интеграции.

Выполнение протестированного кода

Чтобы применить это решение с реальными данными клиентов, вместо учетных данных песочницы интеграции необходимо указать учетные данные основной учетной записи партнера.

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

Выполните действия, описанные в проверке подлинности Центра партнеров, чтобы получить маркер безопасности Microsoft Entra с помощью учетных данных основного Центра партнеров. (Ранее вы выполнили эти действия, чтобы получить маркер безопасности Microsoft Entra для песочницы интеграции.)
Замените в коде маркер безопасности интеграции на новый маркер безопасности для основной учетной записи партнера.

Share via