Configurare l'accesso alle API nel Centro per i partner
si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti
Questo articolo descrive gli account da sviluppare con l'SDK del Centro per i partner. Questo articolo illustra anche come creare un account sandbox di integrazione e testarlo nella sandbox di integrazione.
Nota
Per ottenere l'accesso alle API, il tenant deve essere un tenant di Cloud Solution Provider (CSP) ed è necessario essere un provider indiretto o un partner con fatturazione diretta.
Informazioni sulle definizioni degli account
Per integrare e testare l'integrazione dell'API, il Centro per i partner supporta due tipi di account.
Account partner primario
Questo account consente di creare ordini reali per i clienti reali. Se si apportano modifiche o transazioni quando si è connessi all'account primario, usando l'SDK del Centro per i partner o l'interfaccia utente del dashboard del partner, vengono considerati ordini ufficiali per i clienti reali. Si riflettono nella fattura e la società è responsabile del pagamento.
Account sandbox per l'integrazione
Questo account è destinato a testare il codice e la relativa integrazione con le API del Centro per i partner prima di distribuirlo su larga scala. Le modifiche e le transazioni apportate al momento dell'accesso all'account sandbox di integrazione vengono visualizzate nella fattura, ma non è necessario pagare l'importo della fattura. Il pdf della fattura contiene una dichiarazione di non responsabilità: "NON PAGARE. SI TRATTA DI UNA FATTURA SANDBOX E NON È NECESSARIA ALCUNA AZIONE."
- L'account sandbox di integrazione e l'account primario agiscono in modo indipendente. Non condividono account amministratore, account utente, clienti, ordini, sottoscrizioni o altri dati.
- La sandbox di integrazione supporta transazioni con un numero limitato di clienti, ordini, sottoscrizioni, licenze e così via.
- Gli account sandbox di integrazione sono destinati solo ai test di integrazione conformemente alla policy.
- Nessun account sandbox di integrazione esiste per impostazione predefinita. Se si prevede di usare l'SDK del Centro per i partner, è necessario crearne uno manualmente.
Configurare i tuoi account
Questa sezione descrive come configurare un account partner primario e un account sandbox di integrazione per l'SDK del Centro per i partner.
Creare una sandbox di integrazione
Per creare una sandbox di integrazione, seguire i passaggi descritti in Creare un account sandbox di integrazione CSP (Cloud Solution Provider).
Abilitare l'accesso all'API
Dopo aver configurato l'account, è necessario abilitare l'accesso api prima di poter usare l'SDK del Centro per i partner con la sandbox di integrazione. È necessario abilitare l'accesso all'API separatamente sia per l'account partner principale che per l'account sandbox di integrazione.
- Accedere al Partner Center con un account amministratore globale, quindi selezionare Impostazioni (icona a forma di ingranaggio).
- Selezionare Impostazioni account, quindi Gestione app.
- Se non si ha già un'app esistente, aggiungere una nuova app Web. Se si dispone di un'app Web esistente, scegliere il tasto Aggiungi chiave.
- Copiare le informazioni di registrazione dell'app, in particolare la chiave se si sta creando un'app Web e archiviarla in un luogo sicuro.
- Disconnettersi dal Pannello di Controllo del Partner.
- Effettua nuovamente l'accesso con il tuo account sandbox di integrazione. Ripetere i passaggi da 2 a 5 per abilitare l'accesso api nella sandbox di integrazione.
Scrivere e testare il codice
È possibile scrivere codice e testare il codice nella sandbox di integrazione. Sono necessarie le informazioni seguenti per configurare l'autenticazione del Centro per i partner con un ID Entra Microsoft.
- ID App/ID Client: elencato come ID App dell'applicazione registrata all'interno Impostazioni (icona a forma di ingranaggio) >Impostazioni account>Gestione app.
- Chiave: se hai creato una nuova app Web nella sezione precedente, usa tale chiave.
- Domain: è per la sandbox di integrazione.
Eseguire il codice testato
Per usare la soluzione con dati reali dei clienti, è necessario passare dalle credenziali della sandbox di integrazione alle credenziali dell'account partner primario.
Quando si è pronti a usare il codice testato nell'account partner principale, è necessario un token di sicurezza Microsoft Entra. Questo token di sicurezza si basa sulla tua app Partner Center, sulla chiave e sul dominio (anziché sulla tua app sandbox di integrazione, sulla chiave e sul dominio).
- Seguire la procedura descritta in autenticazione del Centro per i Partner per ottenere un token di sicurezza di Microsoft Entra usando le credenziali primarie del Centro per i Partner. In precedenza sono stati eseguiti questi passaggi per ottenere un token di sicurezza Di Microsoft Entra per la sandbox di integrazione.
- Sostituisci il token di sicurezza di integrazione nel codice con il nuovo token di sicurezza per l'account partner principale.