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

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

применимо к: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США

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

Заметка

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

Общие сведения об определениях учетной записи

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

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

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

Учетная запись интеграционной песочницы

Эта учетная запись предназначена для тестирования кода и ее интеграции с API Центра партнеров, прежде чем развертывать его широко. Изменения и транзакции, внесенные при входе в учетную запись песочницы интеграции, отображаются в счете, но вам не нужно платить сумму счета. Pdf-файл счета содержит отказ от ответственности: "НЕ ПЛАТИТЬ. ЭТО ТЕСТОВЫЙ СЧЕТ, И НИКАКИХ ДЕЙСТВИЙ НЕ ТРЕБУЕТСЯ.

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

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

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

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

Чтобы создать песочницу интеграции, выполните шаги, указанные в Создание учетной записи песочницы интеграции поставщика облачных решений (CSP).

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

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

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

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

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

  • идентификатор приложения / идентификатор клиента: указан в качестве идентификатора зарегистрированного приложения в настройках (значок шестеренки) >управления аккаунтом>управления приложениями.
  • ключ. Если вы создали новое веб-приложение в предыдущем разделе, используйте этот ключ.
  • Домен: предназначен для тестовой среды интеграции.

Запуск тестового кода

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

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

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

Связанное содержимое