Udostępnij przez

Konfigurowanie dostępu do interfejsu API w Centrum partnerskim

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

W tym artykule opisano konta, które należy zdefiniować w oparciu o SDK Centrum Partnerskiego. W tym artykule wyjaśniono również, jak utworzyć konto piaskownicy integracji i przetestować je w piaskownicy integracji.

Ważne

Od 1 kwietnia 2026 r. każde użycie API Centrum partnerskiego przez Aplikację+Użytkownika będzie wymuszać użycie uwierzytelniania wieloskładnikowego.

Aby ułatwić przygotowanie się do tego wymagania, począwszy od października 2025 r. interfejsy API będą szukać tokenu uwierzytelniania wieloskładnikowego i zapewnią potwierdzenie jego obecności w odpowiedzi. Aby uzyskać więcej informacji, zobacz Walidacja wywołań interfejsu API jest zintegrowana z usługą MFA.

Notatka

Aby uzyskać dostęp do interfejsów API, dzierżawca musi być dzierżawcą dostawcy rozwiązań w chmurze (CSP), a Ty musisz być dostawcą pośrednim lub partnerem rozliczającym bezpośrednio.

Omówienie definicji kont

Aby ułatwić integrację interfejsu API i przetestować ją, Centrum partnerskie obsługuje dwa rodzaje kont.

Konto partnera podstawowego

To konto służy do tworzenia rzeczywistych zamówień dla prawdziwych klientów. Jeśli wprowadzisz jakiekolwiek zmiany lub transakcje po zalogowaniu się do konta podstawowego, przy użyciu zestawu SDK Centrum partnerskiego lub interfejsu użytkownika pulpitu nawigacyjnego partnera, są one traktowane jako oficjalne zamówienia dla prawdziwych klientów. Są one odzwierciedlane na fakturze, a Twoja firma jest odpowiedzialna za ich płacenie.

Konto środowiska integracyjnego

To konto służy do testowania kodu i jego integracji z interfejsami API Centrum partnerskiego przed jej ogólnym wdrożeniem. Zmiany i transakcje, które wykonujesz, gdy jesteś zalogowany na konto testowe integracji, pojawiają się na fakturze, ale nie musisz płacić jej kwoty. Plik PDF faktury zawiera zastrzeżenie: "NIE PŁAC. TO JEST FAKTURA W WERSJI TESTOWEJ I NIE WYMAGA ŻADNEGO DZIAŁANIA.

  • Konto piaskownicy integracji i konto podstawowe działają zupełnie niezależnie od siebie. Nie udostępniają kont administratorów, kont użytkowników, klientów, zamówień, subskrypcji ani innych danych.
  • Piaskownica integracji obsługuje transakcje z ograniczoną liczbą klientów, zamówień, subskrypcji, licencji itd.
  • Konta w piaskownicy integracyjnej są przeznaczone wyłącznie do celów testowania integracji zgodnie z polityką.
  • Domyślnie nie istnieje żadne konto piaskownicy integracji. Jeśli planujesz używać zestawu SDK Centrum partnerskiego, musisz go utworzyć samodzielnie.

Konfigurowanie kont

W tej sekcji opisano sposób konfigurowania podstawowego konta partnera oraz konta piaskownicy integracji dla zestawu SDK Centrum Partnerów.

Utwórz środowisko testowe integracji

Aby utworzyć środowisko testowe integracji, wykonaj kroki opisane w Utworzenie konta środowiska testowego integracji dostawcy rozwiązań chmurowych (CSP).

Włączanie dostępu do interfejsu API

Po skonfigurowaniu konta należy włączyć dostęp do interfejsu API przed użyciem zestawu SDK Centrum Partnerów ze środowiskiem testowym integracji. Musisz włączyć dostęp do interfejsu API oddzielnie zarówno dla konta podstawowego partnera, jak i konta próbnego do integracji.

  1. Zaloguj się do Centrum partnerskiego przy użyciu konta administratora globalnego, a następnie wybierz pozycję Ustawienia (ikona koła zębatego).
  2. Wybierz pozycję Ustawienia konta , a następnie Zarządzanie aplikacjami.
  3. Jeśli nie masz jeszcze istniejącej aplikacji, dodaj nową aplikację internetową. Jeśli masz istniejącą aplikację internetową, wybierz przycisk Dodaj klucz.
  4. Skopiuj informacje o rejestracji aplikacji, zwłaszcza Klucz, jeśli tworzysz aplikację internetową i zapisz ją w bezpiecznym miejscu.
  5. Wyloguj się z Pulpitu Nawigacyjnego Partnera.
  6. Zaloguj się ponownie, korzystając ze swojego konta testowego integracji. Powtórz kroki 2–5, aby włączyć dostęp do interfejsu API w środowisku testowym integracji.

Pisanie i testowanie kodu

Możesz pisać i testować kod w piaskownicy integracyjnej. Aby skonfigurować uwierzytelnianie w Centrum partnerskim za pomocą identyfikatora Entra firmy Microsoft, potrzebne są następujące informacje.

  • identyfikator aplikacji/identyfikator klienta: wymienione jako identyfikator aplikacji zarejestrowanej w Ustawienia (ikona koła zębatego) >Ustawienia konta>zarządzanie aplikacjami.
  • Key: jeśli utworzono nową aplikację internetową w poprzedniej sekcji, użyj tego klucza.
  • Domena: jest przeznaczona do użytku w środowisku symulacyjnym.

Uruchamianie przetestowanego kodu

Aby korzystać z rozwiązania z rzeczywistymi danymi klienta, musisz zmienić poświadczenia środowiska testowego na główne poświadczenia konta partnera.

Gdy wszystko będzie gotowe do użycia przetestowanego kodu na podstawowym koncie partnera, potrzebujesz tokenu zabezpieczającego firmy Microsoft Entra. Ten token bezpieczeństwa jest oparty na aplikacji Partner Center, kluczu i domenie (zamiast aplikacji integration sandbox, klucza i domeny).

  1. Wykonaj kroki opisane w uwierzytelnianiu Centrum Partnerskiego, aby uzyskać token zabezpieczający Microsoft Entra przy użyciu podstawowych danych logowania do Centrum Partnerskiego. (Wcześniej śledzili Państwo te kroki, aby uzyskać token zabezpieczający Microsoft Entra dla środowiska testowego integracji).
  2. Zastąp token bezpieczeństwa integracji w kodzie nowym tokenem zabezpieczającym dla podstawowego konta partnera.

Powiązana zawartość

  • Last updated on