Panoramica degli eventi dei partner per i partner - Griglia di eventi di Azure

Articolo
06/14/2023

Gli eventi partner di Griglia di eventi consentono ai clienti di sottoscrivere eventi che hanno origine in un sistema registrato usando lo stesso meccanismo usato per qualsiasi altra origine evento in Azure, ad esempio un servizio di Azure. Questi sistemi registrati si integrano con Griglia di eventi sono noti come "partner". Questa funzionalità consente anche ai clienti di inviare eventi ai sistemi partner che supportano la ricezione e il routing di eventi alle soluzioni/endpoint del cliente nella piattaforma. In genere, i partner sono provider SaaS (Software-as-a-Service) o ERP , ma potrebbero essere piattaforme aziendali che desiderano rendere disponibili i propri eventi ai team interni. Si integrano intenzionalmente con Griglia di eventi per realizzare casi d'uso dei clienti end-to-end che terminano in Azure (i clienti sottoscrivono gli eventi inviati dal partner) o terminano in un sistema partner (i clienti sottoscrivono gli eventi Microsoft inviati da Griglia di eventi di Azure). I clienti Griglia di eventi di Azure per inviare eventi pubblicati da un partner a destinazioni supportate, ad esempio webhook, Funzioni di Azure, Hub eventi di Azure o bus di servizio di Azure, per citarne alcuni. I clienti si basano anche su Griglia di eventi di Azure per instradare gli eventi che hanno origine in servizi Microsoft, ad esempio Outlook, Teams o Microsoft Entra ID, in modo che le soluzioni del cliente possano reagire. Con gli eventi partner, i clienti possono creare soluzioni guidate dagli eventi attraverso piattaforme e limiti di rete per ricevere o inviare eventi in modo affidabile, sicuro e su larga scala.

Nota

Questo è un articolo concettuale che è necessario leggere prima di decidere di eseguire l'onboarding come partner per Griglia di eventi di Azure. Per istruzioni dettagliate su come eseguire l'onboarding come partner di Griglia di eventi usando il portale di Azure, vedere Come eseguire l'onboarding come partner di Griglia di eventi (portale di Azure).

Eventi partner: funzionamento

I partner creano risorse di Griglia di eventi che consentono di pubblicare eventi in Griglia di eventi di Azure in modo che i clienti in Azure possano sottoscriverli. Per la maggior parte dei partner, ad esempio i provider SaaS, è l'unica funzionalità di integrazione che useranno.

È anche possibile creare risorse di Griglia di eventi per ricevere eventi da Griglia di eventi di Azure. Questo caso d'uso è destinato alle organizzazioni che possiedono o gestiscono una piattaforma che consente ai clienti di ricevere eventi esponendo gli endpoint. Alcune di queste organizzazioni sono sistemi ERP che dispongono anche di funzionalità di routing degli eventi all'interno della piattaforma, che invia gli eventi di Azure in ingresso a un'applicazione cliente ospitata nella piattaforma.

Per la pubblicazione di eventi o la ricezione di eventi, creare lo stesso tipo di risorse di Griglia di eventi seguendo questi passaggi generali.

Contattare il team di Griglia di eventi per askgrid@microsoft.com comunicare l'interesse a diventare partner. Una volta contattati, ti guideremo nel processo di onboarding e ti aiuteremo a ottenere una scheda di ingresso nella nostra raccolta di Griglia di eventi di Azure in modo che il servizio sia disponibile nel portale di Azure.
Creare una registrazione partner. Si tratta di una risorsa globale e in genere è necessario creare una sola volta.
Creare uno spazio dei nomi partner. Questa risorsa espone un endpoint a cui è possibile pubblicare eventi in Azure. Quando si crea lo spazio dei nomi partner, specificare la registrazione del partner creata.
Il cliente autorizza l'utente a creare un argomento partner nella sottoscrizione di Azure del cliente.
Il cliente accede alla pagina Web o esegue un comando, si definisce l'esperienza utente, per richiedere il flusso degli eventi ad Azure o la possibilità di ricevere eventi Microsoft nel sistema. In risposta a tale richiesta, si configura il sistema per farlo con l'input del cliente. Ad esempio, il cliente può avere la possibilità di selezionare determinati eventi dal sistema che devono essere inoltrati ad Azure.
Creare un argomento partner nella sottoscrizione e nel gruppo di risorse di Azure del cliente usando i canali. I canali sono risorse contenute negli spazi dei nomi dei partner.
Il cliente attiva l'argomento partner creato nella sottoscrizione di Azure e nel gruppo di risorse.
Avviare la pubblicazione di eventi nello spazio dei nomi partner.

Nota

È necessario registrare il provider di risorse Griglia di eventi di Azure in ogni sottoscrizione di Azure in cui si vogliono creare risorse di Griglia di eventi. In caso contrario, le operazioni per la creazione di risorse avranno esito negativo.

Perché è consigliabile usare eventi partner?

Se si hanno uno o più dei requisiti seguenti, è consigliabile usare la funzionalità Eventi partner.

Per i partner come editori di eventi

Si vuole un meccanismo per rendere disponibili gli eventi ai clienti in Azure. Gli utenti possono filtrare e instradare tali eventi usando gli argomenti dei partner e le sottoscrizioni di eventi di cui sono proprietari e gestiti. È possibile usare altri approcci di integrazione, ad esempio argomenti e domini. Tuttavia, questi approcci non consentono una separazione pulita della proprietà, della gestione e della fatturazione delle risorse tra l'utente e il cliente. La funzionalità Eventi partner offre anche un'esperienza utente più intuitiva che semplifica l'individuazione del servizio.
È necessario un semplice modello multi-tenant in cui si pubblicano eventi in un singolo endpoint a livello di area, l'endpoint dello spazio dei nomi, per instradare gli eventi a clienti diversi.
Si vuole avere visibilità sulle metriche correlate agli eventi pubblicati.
Si vuole usare lo schema eventi cloud 1.0 per gli eventi.

Per i partner come sottoscrittore

Si vuole che il servizio reagisca agli eventi dei clienti che hanno origine in Microsoft Azure.
Si vuole che il cliente reagisca agli eventi del servizio di Microsoft Azure usando le applicazioni ospitate dalla piattaforma. Si usano le funzionalità di routing degli eventi della piattaforma per recapitare eventi alla soluzione del cliente corretta.
Si vuole un modello semplice in cui i clienti selezionano semplicemente il nome del servizio come destinazione senza la necessità di conoscere i dettagli tecnici come gli endpoint della piattaforma.
Il sistema/piattaforma supporta lo schema Eventi cloud 1.0 .

Risorse gestite dai partner

I partner gestiscono i tipi di risorse seguenti.

Registrazione partner

Una registrazione contiene informazioni generali correlate a un partner. Quando si crea uno spazio dei nomi partner, è necessaria una registrazione. In altre parole, è necessario avere una registrazione partner per creare le risorse di Azure necessarie per l'integrazione con Griglia di eventi di Azure.

Le registrazioni sono globali. Ovvero, non sono associati a una determinata area di Azure. È possibile creare una registrazione a partner singolo e usarla durante la creazione degli spazi dei nomi dei partner.

Channel

Un canale è una risorsa nidificata in uno spazio dei nomi partner. Un canale ha due scopi principali:

Si tratta del tipo di risorsa che consente di creare risorse partner nella sottoscrizione di Azure di un cliente. Quando si crea un canale di tipo partner topic, viene creato un argomento partner nella sottoscrizione di Azure di un cliente. Un argomento partner è la risorsa di un cliente a cui vengono indirizzati gli eventi quando un sistema partner pubblica eventi.

Un canale ha lo stesso ciclo di vita dell'argomento o della destinazione del partner cliente associato. Quando viene eliminato un canale di tipo partner topic , ad esempio, l'argomento partner del cliente associato viene eliminato. Analogamente, se l'argomento del partner viene eliminato dal cliente, il canale associato nella sottoscrizione di Azure viene eliminato.
Si tratta di una risorsa usata per instradare gli eventi. Un canale di tipo partner topic viene usato per instradare gli eventi all'argomento partner di un cliente. Supporta due tipi di modalità di routing.
- Routing dei nomi del canale. Con questo tipo di routing, si pubblicano eventi usando un'intestazione HTTP denominata aeg-channel-name dove si specifica il nome del canale a cui devono essere indirizzati gli eventi. Poiché i canali sono la rappresentazione degli argomenti di un partner, gli eventi indirizzati al canale vengono visualizzati nell'argomento parter del cliente. Questo tipo di routing è una nuova funzionalità non presente in event channels, che supporta solo il routing basato su origine. Il routing dei nomi del canale consente più casi d'uso rispetto al routing basato sull'origine ed è la modalità di routing consigliata da scegliere. Ad esempio, con il routing del nome del canale un cliente può richiedere eventi che hanno origine in origini eventi diverse per raggiungere un singolo argomento partner.
- Routing basato sull'origine. Questo approccio di routing si basa sul valore dell'attributo source di contesto nell'evento. Le origini vengono mappate ai canali e quando un evento viene fornito con un'origine, ad esempio, il valore "A" che l'evento viene indirizzato all'argomento partner associato al canale che contiene "A" nella relativa proprietà di origine.
È possibile dichiarare i tipi di evento indirizzati al canale e all'argomento partner associato. I tipi di evento vengono visualizzati ai clienti durante la creazione di sottoscrizioni di eventi nell'argomento del partner e vengono usati per selezionare i tipi di evento specifici da inviare a una destinazione del gestore eventi. Altre informazioni.

Importante

I tipi di evento possono essere gestiti nel canale e, dopo l'aggiornamento dei valori, le modifiche vengono riflesse immediatamente nell'argomento del partner associato.

Spazio dei nomi partner

Uno spazio dei nomi partner è una risorsa a livello di area con un endpoint per pubblicare eventi in Griglia di eventi di Azure. Gli spazi dei nomi dei partner contengono canali o canali di eventi (risorsa legacy). È necessario creare spazi dei nomi dei partner nelle aree in cui i clienti richiedono argomenti o destinazioni partner perché i canali e le risorse partner corrispondenti devono trovarsi nella stessa area. Non è possibile avere un canale in una determinata area con il relativo argomento partner correlato, ad esempio, che si trova in un'area diversa.

Gli spazi dei nomi partner contengono canali o canali eventi. È determinata dalla modalità di routing dell'argomento del partner di proprietà nello spazio dei nomi . Se è impostata sull'intestazione Nome canale, i canali sono l'unico tipo di risorsa che può essere creato nello spazio dei nomi . Se la modalità di routing degli argomenti partner è impostata su Attributo di origine nell'evento, lo spazio dei nomi può contenere solo canali di evento. Tenere presente che la decisione di impostare il diritto partner topic routing mode non è una decisione tra la scelta del nome del canale o il routing basato sull'origine. I canali supportano entrambi. È piuttosto una decisione tra l'uso del nuovo tipo di risorsa di routing, dei canali, rispetto all'uso di una risorsa legacy, dei canali di evento.

Canale eventi

Un canale eventi è la risorsa rilasciata per la prima volta con gli eventi partner per instradare gli eventi in ingresso agli argomenti dei partner. I canali di eventi supportano solo il routing basato sull'origine e rappresentano sempre un argomento partner del cliente.

Importante

I canali di eventi sono deprecati. Di conseguenza, è consigliabile usare i canali.

Partner verificati

Un partner verificato è un'organizzazione partner la cui identità è stata convalidata da Microsoft. È fortemente consigliato che l'organizzazione venga verificata. I clienti cercano di interagire con i partner che sono stati verificati come tale verifica offre maggiori garanzie che si occupano di un'organizzazione legittima. Dopo la verifica, è possibile usufruire di una presenza nella raccolta di Griglia di eventi in cui i clienti possono individuare facilmente il servizio e avere un'esperienza di prima parte quando si sottoscrivono gli eventi, ad esempio.

Autorizzazione del cliente per la creazione di argomenti dei partner

I clienti autorizzano l'utente a creare argomenti partner nella sottoscrizione di Azure. L'autorizzazione viene concessa per un determinato gruppo di risorse in una sottoscrizione di Azure del cliente ed è associato al tempo. È necessario creare il canale prima della data di scadenza impostata dal cliente. È necessario disporre della documentazione che suggerisce al cliente un intervallo di tempo adeguato per la configurazione del sistema per l'invio o la ricezione di eventi e la creazione del canale prima della scadenza dell'autorizzazione. Se si tenta di creare un canale senza autorizzazione o dopo la scadenza, la creazione del canale avrà esito negativo e non verrà creata alcuna risorsa nella sottoscrizione di Azure del cliente.

Nota

Griglia di eventi ha iniziato ad applicare i controlli di autorizzazione per creare argomenti partner intorno al 30 giugno 2022. La documentazione deve chiedere ai clienti di concedere l'autorizzazione come prerequisito prima di creare un canale.

Importante

Un partner verificato non è un partner autorizzato. Anche se un partner è stato controllato da Microsoft, è comunque necessario essere autorizzati prima di poter creare un argomento partner nella sottoscrizione di Azure del cliente.

Attivazione dell'argomento partner

Il cliente attiva l'argomento o la destinazione del partner che hai creato. A questo punto, lo stato di attivazione del canale cambia in Attivato. Dopo l'attivazione di un canale, è possibile avviare la pubblicazione di eventi nell'endpoint dello spazio dei nomi partner che contiene il canale.

Come si automatizza il processo per sapere quando è possibile iniziare a pubblicare eventi per un determinato argomento del partner?

è possibile procedere in due modi:

Legge (poll) lo stato del canale periodicamente per verificare se lo stato di attivazione è passato da NeverActivated a Activated. Questa operazione può essere a elevato utilizzo di calcolo.
Creare una sottoscrizione di eventi per la sottoscrizione di Azure o il gruppo di risorse che contiene i canali da monitorare. Si riceveranno Microsoft.Resources.ResourceWriteSuccess eventi ogni volta che viene aggiornato un canale. Sarà quindi necessario leggere lo stato del canale con l'ID di Azure Resource Manager fornito nell'evento per verificare che l'aggiornamento sia correlato a una modifica dello stato di attivazione su Attivato.