Configurare l'accesso all'API nel Centro per i partner

Articolo
01/17/2024

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 necessari per lo sviluppo con SDK per Centro per i partner. Illustra anche come creare un account sandbox di integrazione ed eseguire test nella sandbox di integrazione.

Nota

Per accedere alle API, è necessario appartenere a un tenant CSP ed essere un provider indiretto o un partner con fatturazione diretta.

Definizioni di account

Per consentirti di integrare e testare l'integrazione dell'API, il Centro per i partner supporta due tipi di account:

Account partner principale

Si tratta dell'account in cui si creano ordini reali per 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, questi verranno considerati ordini ufficiali per i clienti reali. Verranno riflesse nella fattura e la società è responsabile del pagamento.

Account sandbox di integrazione

Questo account server per testare il tuo codice e la relativa integrazione con le API del Centro per i partner prima di distribuirlo su vasta scala. Le modifiche e le transazioni effettuate dopo aver eseguito l'accesso all'account sandbox di integrazione vengono incluse nella fattura. Tuttavia, l'importo della fattura non deve essere pagato. Il PDF della fattura conterrà la clausola di responsabilità "NON PAGARE. QUESTA È UNA FATTURA SANDBOX E NON È NECESSARIA ALCUNA AZIONE".

L'account sandbox di integrazione e l'account principale agiscono in modo indipendente e 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.

In base ai criteri, gli account sandbox di integrazione vengono usati solo a scopo di test di integrazione.

Per impostazione predefinita, non è presente alcun account sandbox di integrazione. Se prevedi di usare SDK per Centro per i partner, devi crearne uno per tuo conto.

Configurare gli account

Questa sezione descrive come configurare un account partner principale e un account sandbox di integrazione per SDK per Centro per i partner.

Creare una sandbox di integrazione

Accedere al Centro per i partner con un account amministratore globale e selezionare Impostazioni (ingranaggio).

Nota

La creazione di una sandbox richiede che l'Amministrazione globale del partner sia connesso al Centro per i partner con il relativo alias di dominio onmicrosoft.com (ad esempio, alias@domain.onmicrosoft.com). La creazione della sandbox avrà esito negativo se l'utente ha eseguito l'accesso con il dominio personalizzato.
Selezionare Impostazioni account, quindi Sandbox di integrazione.

Nota

Se non viene visualizzata un'opzione Sandbox integrazione, potresti essere sprovvisto di un account amministratore globale. È anche possibile che tu stia usando un account sandbox di integrazione e che sia già stata configurata una sandbox di integrazione.
Immetti le informazioni di contatto per l'account amministratore sandbox di integrazione. Scegli quindi Crea account. In pochi minuti riceverai un messaggio di conferma che l'account è stato creato.
Dopo aver visualizzato il messaggio di conferma, disconnettiti dal dashboard partner.
Accedi nuovamente con il nuovo account amministratore sandbox di integrazione. Assicurarsi di usare il formato username@domain per le credenziali insieme alla password specificata.
Scegliere Configura account nella pagina Integration Sandbox (Sandbox di integrazione) per completare la configurazione dell'account sandbox.

Abilitare l'accesso all'API

Dopo aver configurato l'account, è necessario abilitare l'accesso all'API prima di poter usare l'SDK del Centro per i partner con la sandbox di integrazione. Devi abilitare l'accesso all'API separatamente per l'account partner principale e l'account sandbox di integrazione.

Accedere al Centro per i partner con un account amministratore globale e selezionare Impostazioni (ingranaggio).
Selezionare Impostazioni account, quindi Gestione app.
Se non hai ancora un'app esistente, aggiungi una nuova app Web. Se hai un'app Web esistente, scegli il pulsante Aggiungi chiave.
Copia le informazioni di registrazione dell'app, in particolare il valore di Chiave se stai creando un'app Web, e archiviale in una posizione sicura.
Disconnettiti dal dashboard partner.
Accedi nuovamente con l'account sandbox di integrazione. Ripeti i passaggi 2-5 per abilitare l'accesso all'API nella sandbox di integrazione.

Scrivere e testare codice

Puoi scrivere codice e testare codice nella sandbox di integrazione. Per configurare l'autenticazione del Centro per i partner con l'ID Microsoft Entra, sono necessarie le informazioni seguenti.

Nome elemento	Posizione elemento
ID app/ID client	Da Impostazioni (ingranaggio) selezionare Impostazioni account e quindi Gestione app. L'ID app/ID client viene visualizzato come ID client dell'applicazione registrata.
Key	Se hai creato un'app Web nella sezione Abilitare l'accesso all'API, questo valore rappresenta la chiave salvata nel passaggio 5.
Domain	Dominio della sandbox di integrazione.

Eseguire codice testato

Per usare la tua soluzione con dati di clienti reali, devi sostituire le credenziali della sandbox di integrazione con quelle dell'account partner principale.

Quando si è pronti a usare il codice testato nell'account partner primario, è necessario ottenere un token di sicurezza Microsoft Entra. Questo token di sicurezza si basa sull'app, sulla chiave e sul dominio del Centro per i partner anziché sull'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 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.