Domande comuni sulle API di evasione SaaS

Questo articolo descrive diversi requisiti di integrazione per il marketplace commerciale Microsoft per consentire ai clienti di Azure di sottoscrivere offerte SaaS.

Esperienza di individuazione

Dopo la pubblicazione di un'offerta SaaS, gli utenti di Azure possono individuarlo in Azure Marketplace. I clienti possono filtrare le offerte in base al tipo di prodotto (SaaS) e individuare i servizi SaaS a cui sono interessati.

Esperienza di acquisto

Quando un utente è interessato a un servizio SaaS specifico, l'utente può sottoscriverlo da Azure Marketplace.

Cosa significa che un utente di Azure sottoscrive un'offerta SaaS in Azure Marketplace?

Ciò significa che un utente può visualizzare le condizioni per l'utilizzo e l'informativa sulla privacy associate al servizio SaaS e accettarne il pagamento in base alle condizioni di fatturazione impostate dall'utente, l'editore dell'offerta SaaS, nella fattura di Microsoft. Gli utenti possono usare il profilo di pagamento esistente in Azure per pagare il consumo del servizio SaaS.

Questa capacità è utile in diversi modi. I clienti possono ora individuare e sottoscrivere in un'unica posizione usando Microsoft Cloud Platform come origine attendibile, senza dover controllare ogni software indipendente fornitore di software (ISV) che intende usare. Inoltre, i clienti possono usare il profilo di pagamento esistente senza dover pagare in modo esplicito ogni software ISV in modo indipendente.

L'utente viene addebitato automaticamente quando l'offerta viene sottoscritta?

Quando si sottoscrive l'offerta SaaS, l'utente accetta di pagare il consumo del servizio SaaS tramite la piattaforma Microsoft. Tuttavia, gli addebiti iniziano solo quando l'offerta viene utilizzata. L'utente deve passare all'offerta SaaS e confermare la creazione dell'account per iniziare a usare l'offerta. Si riceverà quindi una notifica a Microsoft per avviare la fatturazione per la sottoscrizione SaaS del cliente.

Come si riceve una notifica quando un utente sottoscrive l'offerta SaaS?

Dopo aver sottoscritto un'offerta, l'utente di Azure può individuare e gestire tutte le offerte in Azure. Per impostazione predefinita, lo stato di un'offerta SaaS appena sottoscritta viene visualizzato come Provisioning, evasione in sospeso. In questo stato, all'utente di Azure viene richiesta un'azione per Configurare l'account, per passare all'esperienza di gestione delle sottoscrizioni SaaS nel portale di Azure.

Quando l'utente seleziona Configura account, viene reindirizzato al sito Web del servizio SaaS. L'autore ha configurato l'URL al momento della pubblicazione dell'offerta. Questa pagina viene definita pagina di destinazione dell'editore. Gli utenti di Azure accedono alla pagina di destinazione SaaS in base alle credenziali di Microsoft Entra esistenti in Azure.

Importante

È necessario accedere all'utente che acquista usando Microsoft Entra ID, Single Sign On (SSO) come indicato dal criterio di . La proprietà mail sulla risorsa utente recuperata dall'API Microsoft Graph fornisce le informazioni di contatto per il caso di Microsoft Entra ID e userPrincipalName per MSA. È possibile che il campo "mail" sia vuoto per Microsoft Entra ID e che l'utente non abbia registrato un messaggio di posta elettronica. In tal caso, è consigliabile rilevare che e chiedere un messaggio di posta elettronica di contatto. Questa è l'unica possibilità di ottenere un messaggio di posta elettronica di contatto per raggiungere un cliente durante o dopo il processo di onboarding del cliente.

Quando l'utente di Azure viene reindirizzato alla pagina di destinazione, viene aggiunto un token all'URL della query. Questo token è di breve durata e valido per una durata di 24 ore. È quindi possibile rilevare la presenza di questo token e chiamare l'API Microsoft per ottenere più contesto associato al token.

flusso di sottoscrizione del cliente

Per altre informazioni sul contratto API per la gestione degli scenari di transazione nel ciclo di vita di un'offerta SaaS, vedere API di evasione SaaS.

Come si conosce l'offerta SaaS a cui l'utente sottoscrive in Azure?

La risposta all'API Resolve include le informazioni sull'offerta e sul piano associate alla sottoscrizione SaaS.

In che modo l'utente di Azure può modificare il piano associato a questa sottoscrizione di Azure?

  • L'utente di Azure può modificare il piano associato alla sottoscrizione SaaS direttamente nell'esperienza SaaS o tramite la piattaforma Microsoft.

  • Le conversioni possono essere eseguite in qualsiasi momento nel ciclo di fatturazione. Viene richiesto di confermare qualsiasi conversione, che diventa effettiva al momento del riconoscimento.

  • Il piano prepagato ( mensile o annuale ) è ripartito in modo proporzionale. Qualsiasi eccedenza generata fino al momento della conversione verrà addebitata nella fattura successiva. Le nuove eccedenze verranno generate in base al nuovo piano.

Nota

È possibile bloccare i downgrade se non si desidera supportare percorsi di conversione specifici.

La sequenza seguente acquisisce il flusso quando un cliente di Azure modifica un piano nell'esperienza SaaS:

flusso di modifica del piano del cliente

La sequenza seguente acquisisce il flusso quando un cliente di Azure modifica un piano nello store online di Microsoft:

flusso di modifica del piano dello store online del cliente

In che modo l'utente di Azure può annullare la sottoscrizione al piano associato alla sottoscrizione di Azure?

Un utente di Azure può annullare la sottoscrizione a un'offerta SaaS acquistata direttamente nell'esperienza SaaS o tramite la piattaforma Microsoft. Una volta annullata la sottoscrizione, l'utente non verrà più addebitato dal ciclo di fatturazione successivo.

La sequenza seguente acquisisce il flusso quando un cliente di Azure annulla la sottoscrizione all'offerta SaaS nell'esperienza SaaS:

cliente annulla la sottoscrizione nell'esperienza SaaS

La sequenza seguente acquisisce il flusso quando l'utente di Azure annulla la sottoscrizione nello Store online di Microsoft:

il cliente annulla la sottoscrizione nel del negozio online di Microsoft

Gestire l'esperienza

Un ISV può gestire la sottoscrizione SaaS del cliente e modificare i piani.

Affinché un piano venga convertito correttamente in un piano diverso all'interno della stessa offerta, tutte le operazioni seguenti devono essere vere; in caso contrario, le chiamate API di evasione SaaS del piano di modifica potrebbero non funzionare:

  • Il piano di destinazione deve essere attivo.
  • Il piano di destinazione deve essere supportato nell'area del cliente.
  • Se il piano di destinazione è un piano privato, l'ID tenant del cliente deve essere aggiunto al piano nel Centro per i partner e ripubblicato prima di tentare il piano di modifica.
  • Se il piano di destinazione fa parte del marketplace privato, il cliente deve consentire l'elenco dei piani nel marketplace privato prima di modificare il piano.
  • Per i clienti EA, se l'impostazione BYOL è abilitata (ovvero può acquistare solo risorse gratuite), il piano di destinazione non deve essere un piano a pagamento.

Come si crea un'entità servizio per l'app Entra?

L'entità servizio dell'app Entra è l'istanza della registrazione dell'app Entra creata per l'offerta SaaS. L'entità servizio dell'app deve essere creata nello stesso tenant usato nella configurazione tecnica del Centro per i partner. Questi passaggi consentono di determinare se viene creata un'entità servizio e, in caso contrario, come crearne una.

Passaggio 1: Identificare la registrazione dell'app.

  1. Passare a ogni offerta SaaS nel Centro per i partner.

  2. Passare alla relativa "Pagina configurazione tecnica" e registrare il valore per "Entra application ID":

    schermata della pagina di configurazione tecnica del Centro per i partner Microsoft.

Passaggio 2: Determinare se l'entità servizio viene creata o meno.

opzione 1: uso del portale di Azure

  1. Passare alla pagina Registrazioni app del portale di Azure e individuare la registrazione dell'app con l'ID copiato dal Centro per i partner.

    Mancia

    Potrebbe essere necessario passare a "Tutte le applicazioni" invece di "Applicazioni di proprietà" nel caso in cui non fosse stata creata la registrazione dell'app al primo posto.

    Mancia

    Il nome della registrazione dell'app termina con "FulfillmentAppReg" se è stato creato usando lo script di distribuzione dell'acceleratore SaaS.

  2. Aprire la pagina Registrazione app. Nel caso in cui venga visualizzato il collegamento con il nome di registrazione dell'app (anziché il collegamento "Crea entità servizio", come illustrato nello screenshot successivo), significa che è già stata creata un'entità servizio.

    Screenshot della pagina Registrazione app.

opzione 2: uso dell'interfaccia della riga di comando di Azure

az ad sp list --filter "appId eq '<Your-App-ID>'"

Se viene creata l'entità servizio, si otterrà accountEnabled come true (come illustrato in questa immagine).

Screenshot dell'interfaccia della riga di comando di Azure con i risultati creati dall'entità servizio.

Altre informazioni su questo comando dell'entità servizio elencare all'indirizzo az ad sp list.

passaggio 3: Creazione e associazione di un'entità servizio

opzione 1: uso del portale di Azure

  1. Passare alla pagina Registrazioni app del portale di Azure e individuare la registrazione dell'app con l'ID copiato dal Centro per i partner.

    Mancia

    Potrebbe essere necessario passare a "Tutte le applicazioni" invece di "Applicazioni di proprietà" nel caso in cui non fosse stata creata la registrazione dell'app al primo posto.

    Mancia

    Il nome della registrazione dell'app termina con "FulfillmentAppReg" se è stato creato usando lo script di distribuzione dell'acceleratore SaaS.

  2. Aprire la pagina Registrazione app e selezionare il collegamento "Crea entità servizio", come illustrato in questo screenshot.

    screenshot della pagina Registrazione app con il collegamento Crea entità servizio evidenziata.

opzione 2: uso dell'interfaccia della riga di comando di Azure

az ad sp create --id <app_id>

Se viene creata l'entità servizio, verrà visualizzato accountEnabled come true (come illustrato in questa immagine).

Screenshot dell'interfaccia della riga di comando che mostra che è stata creata l'entità servizio.

Altre informazioni su questa entità servizio creare comando az ad sp create.