Creare e gestire gli account di integrazione per i flussi di lavoro B2B in App per la logica di Azure con Enterprise Integration Pack

Si applica a: App per la logica di Azure (a consumo e standard)

Prima di poter creare flussi di lavoro business-to-business (B2B) e di integrazione aziendale usando App per la logica di Azure, è necessario creare una risorsa dell'account di integrazione. Questo account è un contenitore scalabile basato sul cloud in Azure che semplifica l'archiviazione e la gestione degli artefatti B2B definiti e usati nei flussi di lavoro per scenari B2B, ad esempio:

• Partner commerciali
• Contratti
• Mappe
• Schemi
• Attestati

È anche necessario un account di integrazione per scambiare elettronicamente messaggi B2B con altre organizzazioni. Quando altre organizzazioni usano protocolli e formati di messaggi diversi dall'organizzazione, è necessario convertire questi formati in modo che il sistema dell'organizzazione possa elaborare tali messaggi. Con App per la logica di Azure è possibile creare flussi di lavoro che supportano i protocolli standard di settore seguenti:

• AS2
• EDIFACT
• RosettaNet
• X12

Se non si ha familiarità con la creazione di flussi di lavoro di integrazione aziendale B2B in App per la logica di Azure, vedere Flussi di lavoro di integrazione aziendale B2B con App per la logica di Azure ed Enterprise Integration Pack.

Prerequisiti

• Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito. Assicurarsi di usare la stessa sottoscrizione di Azure sia per l'account di integrazione che per la risorsa dell'app per la logica.

• Indipendentemente dal fatto che si stia lavorando a un flusso di lavoro di app per la logica A consumo o Standard, è necessario che la risorsa app per la logica sia già presente se è necessario collegare l'account di integrazione.

  • Per le risorse dell'app per la logica A consumo, questo collegamento è necessario prima di poter usare gli artefatti dell'account di integrazione con il flusso di lavoro. Anche se è possibile creare gli artefatti senza questo collegamento, il collegamento è necessario quando si è pronti per l'uso di questi artefatti. Per creare un flusso di lavoro di app per la logica A consumo di esempio, vedere Guida introduttiva: Creare un flusso di lavoro di app per la logica A consumo di esempio in App per la logica di Azure multi-tenant.

  • Per le risorse app per la logica Standard, questo collegamento può essere obbligatorio o facoltativo, in base allo scenario specifico:

    • Se si ha un account di integrazione con gli artefatti di cui si ha bisogno o che si vogliono usare, collegare l'account di integrazione alle singole risorse app per la logica Standard in cui si vogliono usare gli artefatti.

    • Alcuni connettori dell'account di integrazione ospitati in Azure non richiedono il collegamento e consentono di creare una connessione all'account di integrazione. Ad esempio, AS2, EDIFACT e X12 non richiedono il collegamento, ma il connettore AS2 (v2) richiede il collegamento.

    • I connettori predefiniti denominati Liquid e File flat consentono di selezionare mappe e schemi caricati in precedenza nella risorsa dell'app per la logica o in un account di integrazione collegato.

      Se non si ha o non è necessario un account di integrazione, è possibile usare l'opzione di caricamento. In caso contrario, è possibile usare l'opzione di collegamento, ovvero non è necessario caricare mappe e schemi in ogni risorsa dell'app per la logica. In entrambi i casi, è possibile usare questi artefatti in tutti i flussi di lavoro figlio all'interno della stessa risorsa dell'app per la logica.

    Per creare un flusso di lavoro di app per la logica Standard di esempio, vedere Creare un flusso di lavoro di app per la logica Standard di esempio in App per la logica di Azure a tenant singolo.

• Un account di integrazione Premium supporta l'uso di un endpoint privato all'interno di una rete virtuale di Azure per comunicare in modo sicuro con altre risorse di Azure nella stessa rete. Anche l'account di integrazione, la rete virtuale e le risorse di Azure devono trovarsi nella stessa area di Azure. Per altre informazioni, vedere Creare una rete virtuale e i passaggi descritti in questa guida per configurare l'account di integrazione Premium.

  Ad esempio, un'app per la logica Standard può accedere all'endpoint privato se si trovano nella stessa rete virtuale. Tuttavia, un'app per la logica A consumo non supporta l'integrazione della rete virtuale e non può accedere all'endpoint privato.

  • Per creare un'app per la logica Standard con l'integrazione della rete virtuale, vedere Creare un flusso di lavoro di app per la logica Standard di esempio in App per la logica di Azure a tenant singolo.

  • Per configurare un'app per la logica Standard esistente con l'integrazione della rete virtuale, vedere Configurare l'integrazione della rete virtuale.

Creare un account di integrazione

Gli account di integrazione sono disponibili in diversi livelli dai prezzi differenti. In base al livello scelto, la creazione di un account di integrazione potrebbe comportare costi. Per altre informazioni, vedere Prezzi e modelli di fatturazione di App per la logica di Azure e Prezzi di App per la logica di Azure.

In base ai requisiti e agli scenari, determinare il livello di account di integrazione appropriato da creare. La tabella seguente descrive i livelli disponibili:

L'account di integrazione usa un'identità gestita assegnata dal sistema creata e abilitata automaticamente per autenticare l'accesso.

Per questa attività, è possibile usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell.

az logic integration-account import --name integration_account_01 \
    --resource-group myresourcegroup --input-path integration.json

Configurare l'accesso alle risorse di archiviazione per l'account di integrazione Premium

Per leggere gli artefatti e scrivere informazioni sullo stato, l'account di integrazione Premium deve accedere all'account di archiviazione di Azure selezionato e associato. L'account di integrazione usa l'identità gestita assegnata dal sistema creata e abilitata automaticamente per autenticare l'accesso.

1. Nel portale di Azure aprire l'account di integrazione Premium.

2. Nel menu dell'account di integrazione, in Impostazioni, selezionare Identità.

3. Nella scheda Assegnata dal sistema, che mostra l'identità gestita assegnata dal sistema abilitata, in Autorizzazioni selezionare Assegnazioni di ruolo di Azure.

4. Sulla barra degli strumenti Assegnazioni di ruolo di Azure selezionare Aggiungi assegnazione di ruolo (anteprima), specificare le informazioni seguenti, selezionare Salva e quindi ripetere per ogni ruolo richiesto:

   Parametro	valore	Descrizione
   Scope	Storage	Per altre informazioni, vedere Informazioni sull'ambito per il controllo degli accessi in base al ruolo di Azure.
   Abbonamento	<Sottoscrizione di Azure>	Sottoscrizione di Azure a cui accedere la risorsa.
   Conto risorse	<Azure-storage-account-name>	Nome dell'account di archiviazione di Azure a cui accedere. Nota Se viene visualizzato un errore che indica che non si dispone delle autorizzazioni per aggiungere assegnazioni di ruolo a questo ambito, è necessario ottenere tali autorizzazioni. Per altre informazioni, vedere Ruoli predefiniti di Microsoft Entra.
   Ruolo	- Collaboratore account di archiviazione - Collaboratore ai dati del BLOB di archiviazione - Collaboratore ai dati della tabella di archiviazione	I ruoli richiesti dall'account di integrazione Premium per accedere all'account di archiviazione.

   Per altre informazioni, vedere Assegnare un ruolo di Azure all'identità gestita assegnata dal sistema

Configurare l'endpoint privato per l'account di integrazione Premium (anteprima)

Per possibile creare una connessione sicura tra l'account di integrazione Premium e i servizi di Azure, è possibile configurare un endpoint privato per l'account di integrazione. Questo endpoint è un'interfaccia di rete che usa un indirizzo IP provato della rete virtuale di Azure. In questo modo, il traffico tra la rete virtuale e i servizi di Azure rimane nella rete backbone di Azure e non attraversa mai la rete Internet pubblica. Gli endpoint privati garantiscono un canale di comunicazione sicuro e privato tra le risorse e i servizi di Azure offrendo i vantaggi seguenti:

• Elimina l'esposizione alla rete Internet pubblica e riduce i rischi derivanti dagli attacchi.

• Aiuta l'organizzazione a soddisfare i requisiti di privacy e conformità dei dati mantenendo i dati all'interno di un ambiente controllato e protetto.

• Riduce la latenza e migliora le prestazioni del flusso di lavoro mantenendo il traffico all'interno della rete backbone di Azure.

• Rimuove la necessità di configurazioni di rete complesse, ad esempio reti private virtuali o ExpressRoute.

• Consente di risparmiare sui costi riducendo l'infrastruttura di rete aggiuntiva ed evitando addebiti in uscita per i dati tramite endpoint pubblici.

Procedure consigliate per gli endpoint privati

• Pianificare attentamente l'architettura della rete virtuale e della subnet per supportare gli endpoint privati. Assicurarsi di segmentare e proteggere correttamente le subnet.

• Assicurarsi che le impostazioni DNS (Domain Name System) siano aggiornate e configurate correttamente per gestire la risoluzione dei nomi per gli endpoint privati.

• Controllare il flusso del traffico da e verso gli endpoint privati e applicare criteri di sicurezza rigorosi usando i gruppi di sicurezza di rete.

• Testare accuratamente la connettività e le prestazioni dell'account di integrazione per assicurarsi che tutto funzioni come previsto con gli endpoint privati prima della distribuzione nell'ambiente di produzione.

• Monitorare regolarmente il traffico di rete da e verso gli endpoint privati. Controllare e analizzare i modelli di traffico usando strumenti come Monitoraggio di Azure e Centro sicurezza di Azure.

Creare un endpoint privato

Prima di iniziare, assicurarsi di avere una rete virtuale di Azure definita con le subnet e i gruppi di sicurezza di rete appropriati per gestire e proteggere il traffico.

1. Nella casella di ricerca del portale di Azure immettere endpoint privato e quindi selezionare Endpoint privati.

2. Nella pagina Endpoint privati selezionare Crea.

3. Nella scheda Nozioni di base specificare le informazioni seguenti:

   Proprietà	valore
   Abbonamento	<Sottoscrizione di Azure>
   Gruppo di risorse	<Azure-resource-group>
   Nome	<private-endpoint>
   Nome interfaccia di rete	<endpoint-privato>-nic
   Area	<Area di Azure>

4. Nella scheda Risorsa specificare le informazioni seguenti:

   Proprietà	valore
   Metodo di connessione	- Connettersi a una risorsa di Azure nella directory: crea un endpoint privato approvato automaticamente e pronto per l'uso immediato. La proprietà Stato connessione dell'endpoint è impostata su Approvata dopo la creazione. - Connettersi a una risorsa di Azure in base all'alias o all'ID risorsa: consente di creare un endpoint privato approvato manualmente e richiede l'approvazione dell'amministratore dei dati prima che chiunque lo possa usare. La proprietà Stato connessione dell'endpoint è impostata su In sospeso dopo la creazione. Nota: se l'endpoint è approvato manualmente, la scheda DNS non è disponibile.
   Abbonamento	<Sottoscrizione di Azure>
   Tipo di risorsa	Microsoft.Logic/integrationAccounts
   Conto risorse	<account-integrazione-Premium>
   Risorsa secondaria di destinazione	integrationAccount

5. Nella scheda Rete virtuale specificare la rete virtuale e la subnet in cui si vuole creare l'endpoint:

   Proprietà	valore
   Rete virtuale	<rete-virtuale>
   Subnet	<subnet-per-endpoint>

   La rete virtuale usa un'interfaccia di rete collegata all'endpoint privato.

6. Nella scheda DNS specificare le informazioni seguenti per assicurarsi che le app possano risolvere l'indirizzo IP privato per l'account di integrazione. Potrebbe essere necessario configurare una zona DNS privato e collegarsi alla rete virtuale.

   Proprietà	valore
   Abbonamento	<Sottoscrizione di Azure>
   Gruppo di risorse	<gruppo-risorse-azure-per-zona-DNS-privato>

7. Al termine, confermare tutte le informazioni fornite e selezionare Crea.

8. Dopo aver verificato che Azure ha creato l'endpoint privato, controllare la connettività e testare la configurazione per assicurarsi che le risorse nella rete virtuale possano connettersi in modo sicuro all'account di integrazione tramite l'endpoint privato.

Visualizzare le connessioni endpoint in sospeso

Per un endpoint privato che richiede l'approvazione, seguire questa procedura:

1. Nel portale di Azure passare alla pagina Collegamento privato.

2. Nel menu a sinistra selezionare Connessioni in sospeso.

Approvare un endpoint privato in sospeso

Per un endpoint privato che richiede l'approvazione, seguire questa procedura:

1. Nel portale di Azure passare alla pagina Collegamento privato.

2. Nel menu a sinistra selezionare Connessioni in sospeso.

3. Selezionare la connessione in sospeso. Nella barra degli strumenti selezionare Approva. Attendere il completamento dell'operazione.

   La proprietà Stato connessione dell'endpoint viene impostata su Approvata.

Abilitare le chiamate dell'app per la logica Standard tramite endpoint privato nell'account di integrazione Premium

1. Scegli una delle opzioni seguenti:

• Per creare un'app per la logica Standard con l'integrazione della rete virtuale, vedere Creare un flusso di lavoro di app per la logica Standard di esempio in App per la logica di Azure a tenant singolo.

• Per configurare un'app per la logica Standard esistente con l'integrazione della rete virtuale, vedere Configurare l'integrazione della rete virtuale.

1. Per effettuare chiamate tramite l'endpoint privato, includere un'azione HTTP nel flusso di lavoro dell'app per la logica Standard in cui si vuole chiamare l'account di integrazione.

2. Nel portale di Azure passare all'account di integrazione Premium. In Impostazioni nel menu dell'account di integrazione selezionare URL di callback e copiare l'URL.

3. Nell'azione HTTP del flusso di lavoro, nella scheda Parametri immettere l'URL di callback nella proprietà URI usando il formato seguente:

   https://{domain-name}-{integration-account-ID}.cy.integrationaccounts.microsoftazurelogicapps.net:443/integrationAccounts/{integration-account-ID}?api-version=2015-08-01-preview&sp={sp}&sv={sv}&sig={sig}

   L'esempio seguente mostra i valori di esempio:

   https://prod-02-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.cy.integrationaccounts.microsoftazurelogicapps.net:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-01-preview&sp={sp}&sv={sv}&sig={sig}

4. Per la proprietà Metodo dell'azione HTTP selezionare GET.

5. Completare la configurazione dell'azione HTTP in base alle esigenze e testare il flusso di lavoro.

Collegare all'app per la logica

Per collegare correttamente l'account di integrazione alla risorsa dell'app per la logica, assicurarsi che entrambe le risorse usino la stessa sottoscrizione e area di Azure.

Modificare il piano tariffario

Per aumentare i limiti per un account di integrazione, è possibile eseguire l'aggiornamento a un piano tariffario superiore, se disponibile. Ad esempio, è possibile eseguire l'aggiornamento dal livello Gratuito al livello Basic, al livello Standard o al livello Premium. È anche possibile effettuare il downgrade a un livelloinferiore, se disponibile. Per altre informazioni sui prezzi, vedere la documentazione seguente:

• Prezzi di App per la logica di Azure
• Modello tariffario delle App per la logica di Azure

Aggiorna piano tariffario

Per apportare questa modifica, è possibile usare il portale di Azure o l'interfaccia della riga di comando di Azure.

Effettuare il downgrade del piano tariffario

Per apportare questa modifica, usare l'interfaccia della riga di comando diAzure.

1. Se non lo si ha già fatto, installare i prerequisiti dell'interfaccia della riga di comando di Azure.

2. Nel portale di Azure aprire l'ambiente Azure Cloud Shell.

   

3. Al prompt dei comandi immettere il comando az resource e impostare skuName sul livello inferiore desiderato.

   az resource update --resource-group <resourceGroupName> --resource-type Microsoft.Logic/integrationAccounts --name <integrationAccountName> --subscription <AzureSubscriptionID> --set sku.name=<skuName>
   

   Ad esempio, se si ha il livello Standard, è possibile impostare skuName su Basic:

   az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Basic
   

Scollegare da un'app per la logica

Spostare l'account di integrazione

È possibile spostare l'account di integrazione a un altro gruppo di risorse o sottoscrizione di Azure. Quando si spostano le risorse, Azure crea nuovi ID risorsa, quindi assicurarsi di usare i nuovi ID e aggiornare gli script o gli strumenti associati alle risorse spostate. Se si vuole modificare la sottoscrizione, è necessario specificare anche un gruppo di risorse esistente o nuovo.

Per questa attività, è possibile usare il portale di Azure seguendo i passaggi descritti in questa sezione o nell'interfaccia della riga di comando di Azure.

1. Nella casella di ricerca del portale di Azure immettere account di integrazione e selezionare Account di integrazione.

   Azure mostra tutti gli account di integrazione nelle sottoscrizioni di Azure.

2. In Account di integrazione selezionare l'account di integrazione che si vuole spostare. Nel menu dell'account di integrazione selezionare Panoramica.

3. Nella pagina Panoramica, accanto a Gruppo di risorse o Nome sottoscrizione, selezionare Cambia.

   

4. Selezionare anche le risorse correlate da spostare.

5. In base alla selezione, seguire questa procedura per modificare il gruppo di risorse o la sottoscrizione:

   • Gruppo di risorse: dall'elenco Gruppo di risorse selezionare il gruppo di risorse di destinazione. In alternativa, creare un gruppo di risorse differente, selezionare Creare un nuovo gruppo di risorse.

   • Sottoscrizione: nell'elenco Sottoscrizione selezionare la sottoscrizione di destinazione. Nell'elenco Gruppo di risorse selezionare il gruppo di risorse di destinazione. In alternativa, creare un gruppo di risorse differente, selezionare Creare un nuovo gruppo di risorse.

6. Per confermare che gli script o gli strumenti associati alle risorse spostate non funzioneranno fino a quando non vengono aggiornati con i nuovi ID risorsa, selezionare la casella di conferma e quindi selezionare OK.

7. Al termine, assicurarsi di aggiornare tutti gli script con i nuovi ID risorsa per le risorse spostate.

Eliminare l'account di integrazione

Per questa attività, è possibile usare il portale di Azure seguendo i passaggi descritti in questa sezione, nell'interfaccia della riga di comando di Azureo in Azure PowerShell.

az logic integration-account delete --name integration_account_01 --resource-group myresourcegroup

Passaggi successivi

• Creare partner commerciali nell'account di integrazione
• Creare accordi tra partner nell'account di integrazione