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 opracowywać przy użyciu zestawu SDK Centrum partnerskiego. W tym artykule wyjaśniono również, jak utworzyć konto piaskownicy integracji i przetestować je w piaskownicy integracji.
Uwaga
Aby uzyskać dostęp do interfejsów API, dzierżawa musi być dzierżawą CSP i musisz być dostawcą pośrednim lub partnerem rozliczanym bezpośrednio.
Definicje kont
Aby ułatwić integrację i testowanie integracji interfejsu API, 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, będą one traktowane jako oficjalne zamówienia dla prawdziwych klientów. Zostaną one odzwierciedlone na fakturze, a Twoja firma jest odpowiedzialna za ich płacenie.
Konto piaskownicy integracji
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 wprowadzone podczas logowania do konta piaskownicy integracji będą wyświetlane na fakturze, jednak nie trzeba płacić kwoty faktury. Plik PDF faktury będzie miał zastrzeżenie "NIE PŁAC. JEST TO FAKTURA PIASKOWNICY I NIE JEST WYMAGANA ŻADNA AKCJA".
Konto piaskownicy integracji i konto podstawowe działają niezależnie i 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 itp.
Według zasad konta piaskownicy integracji są przeznaczone tylko do celów testowania integracji.
Konto piaskownicy integracji nie istnieje domyślnie. 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 i konta piaskownicy integracji dla zestawu SDK Centrum partnerskiego.
Tworzenie piaskownicy integracji
Zaloguj się do Centrum partnerskiego przy użyciu konta administratora globalnego i wybierz pozycję Ustawienia (koło zębate).
Uwaga
Utworzenie piaskownicy wymaga zalogowania partnera globalnego Administracja do Centrum partnerskiego przy użyciu aliasu domeny onmicrosoft.com (na przykład alias@domain.onmicrosoft.com). Tworzenie piaskownicy zakończy się niepowodzeniem, jeśli użytkownik jest zalogowany przy użyciu domeny niestandardowej.
Wybierz pozycję Ustawienia konta, a następnie pozycję Piaskownica integracji.
Uwaga
Jeśli nie widzisz opcji Piaskownica integracji, być może nie masz konta administratora globalnego. Być może używasz również konta piaskownicy integracji, a piaskownica integracji została już skonfigurowana.
Wprowadź informacje kontaktowe dla konta administratora piaskownicy integracji. Następnie wybierz pozycję Utwórz konto. Poczekaj kilka minut na komunikat potwierdzający, że konto zostało utworzone.
Po wyświetleniu komunikatu potwierdzenia wyloguj się z pulpitu nawigacyjnego partnera.
Zaloguj się ponownie przy użyciu nowego konta administratora piaskownicy integracji. Pamiętaj, aby użyć formatu username@domain dla poświadczeń wraz z określonym hasłem.
Wybierz pozycję Skonfiguruj konto na stronie Piaskownica integracji, aby ukończyć konfigurację konta piaskownicy.
Włączanie dostępu do interfejsu API
Po skonfigurowaniu konta należy włączyć dostęp do interfejsu API, aby można było używać zestawu SDK centrum partnerskiego z piaskownicą integracji. Należy włączyć dostęp do interfejsu API oddzielnie dla podstawowego konta partnera i dla konta piaskownicy integracji.
Zaloguj się do Centrum partnerskiego przy użyciu konta administratora globalnego i wybierz pozycję Ustawienia (koło zębate).
Wybierz pozycję Ustawienia konta, a następnie pozycję Zarządzanie aplikacjami.
Jeśli nie masz jeszcze istniejącej aplikacji, dodaj nową aplikację internetową. Jeśli masz istniejącą aplikację internetową, wybierz przycisk Dodaj klucz .
Skopiuj informacje o rejestracji aplikacji, zwłaszcza klucz , jeśli tworzysz aplikację internetową i zapisz ją w bezpiecznym miejscu.
Wyloguj się z pulpitu nawigacyjnego partnera.
Zaloguj się ponownie przy użyciu konta piaskownicy integracji. Powtórz kroki 2–5, aby włączyć dostęp do interfejsu API w piaskownicy integracji.
Pisanie i testowanie kodu
Kod i kod testowy można napisać w piaskownicy integracji. Aby skonfigurować uwierzytelnianie w Centrum partnerskim przy użyciu identyfikatora Entra firmy Microsoft, potrzebne są następujące informacje.
| Nazwa elementu | Lokalizacja elementu |
|---|---|
| Identyfikator aplikacji/identyfikator klienta | W obszarze Ustawienia (koło zębate) wybierz pozycję Ustawienia konta, a następnie pozycję Zarządzanie aplikacjami. Identyfikator aplikacji/identyfikator klienta jest wyświetlany jako identyfikator zarejestrowanej aplikacji. |
| Key | Jeśli aplikacja internetowa została utworzona w sekcji Włączanie dostępu do interfejsu API, jest to klucz zapisany w kroku 5. |
| Domain | Domena piaskownicy integracji. |
Uruchamianie przetestowanego kodu
Aby korzystać z rozwiązania z rzeczywistymi danymi klienta, musisz zmienić poświadczenia piaskownicy integracji na podstawowe poświadczenia konta partnera.
Gdy wszystko będzie gotowe do użycia przetestowanego kodu na podstawowym koncie partnerskim, musisz uzyskać token zabezpieczający firmy Microsoft Entra. Ten token zabezpieczający jest oparty na aplikacji, kluczu i domenie Centrum partnerskiego (zamiast aplikacji piaskownicy integracji, klucza i domeny).
Wykonaj kroki opisane w temacie Uwierzytelnianie w Centrum partnerskim, aby uzyskać token zabezpieczający firmy Microsoft przy użyciu podstawowych poświadczeń Centrum partnerskiego. (Wcześniej wykonano te kroki, aby uzyskać token zabezpieczający firmy Microsoft Entra dla piaskownicy integracji).
Zastąp token zabezpieczeń integracji w kodzie nowym tokenem zabezpieczającym dla podstawowego konta partnera.