Messaggi as2 di Exchange che usano flussi di lavoro in App per la logica di Azure
Si applica a: App per la logica di Azure (consumo + standard)
Per inviare e ricevere messaggi AS2 nei flussi di lavoro creati usando App per la logica di Azure, è possibile usare il connettore AS2 (v2), che fornisce azioni che supportano e gestiscono la comunicazione AS2. Se sono necessarie funzionalità di rilevamento, il connettore AS2 originale è ancora disponibile, ma è deprecato.
Ad eccezione delle funzionalità di rilevamento, il connettore AS2 (v2) offre le stesse funzionalità del connettore AS2 originale, viene eseguito in modo nativo con il runtime di App per la logica di Azure e offre miglioramenti significativi delle prestazioni in termini di dimensioni dei messaggi, velocità effettiva e latenza. A differenza del connettore AS2 originale, il connettore AS2 (v2) non richiede la creazione di una connessione all'account di integrazione. Come descritto nei prerequisiti, assicurarsi invece di collegare l'account di integrazione alla risorsa dell'app per la logica in cui si prevede di usare il connettore.
Questa guida pratica illustra come aggiungere le azioni di codifica e decodifica AS2 a un flusso di lavoro di app per la logica esistente. Il connettore AS2 (v2) non include trigger, quindi è possibile usare qualsiasi trigger per avviare il flusso di lavoro. Gli esempi in questa guida usano il trigger Request.
Riferimento tecnico Connessione or
Il connettore AS2 ha versioni diverse, in base al tipo di app per la logica e all'ambiente host.
| App per la logica | Ambiente | versione di Connessione or |
|---|---|---|
| Consumo | App per la logica di Azure multi-tenant | Connettori gestiti AS2 (v2) e AS2 (classe Standard). Il connettore AS2 (v2) fornisce solo azioni, ma è possibile usare qualsiasi trigger che funzioni per lo scenario in uso. Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito AS2 - Operazioni del connettore gestito AS2 (v2) - Limiti dei messaggi AS2 |
| Consumo | Ambiente del servizio di integrazione | As2 (v2) e i connettori gestiti AS2 (classe Standard) e AS2 I edizione Standard versione, con limiti di messaggio diversi rispetto alla classe Standard. Il connettore AS2 (v2) fornisce solo azioni, ma è possibile usare qualsiasi trigger che funzioni per lo scenario in uso. Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito AS2 - Operazioni del connettore gestito AS2 (v2) - Limiti dei messaggi AS2 |
| Standard | App per la logica di Azure a tenant singolo e ambiente del servizio app v3 (solo piani di Windows) | Connettore predefinito AS2 (v2) e connettore gestito AS2 . La versione predefinita è diversa nei modi seguenti: - La versione predefinita fornisce solo azioni, ma è possibile usare qualsiasi trigger che funzioni per lo scenario. - La versione predefinita può accedere direttamente alle reti virtuali di Azure. Non è necessario un gateway dati locale. Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito AS2 - Operazioni predefinite del connettore AS2 (v2) - Limiti dei messaggi AS2 |
Operazioni AS2 (v2)
Il connettore AS2 (v2) non dispone di trigger. Nella tabella seguente vengono descritte le azioni fornite dal connettore AS2 (v2) per stabilire la sicurezza e l'affidabilità durante la trasmissione dei messaggi:
| Azione | Descrizione |
|---|---|
| Azione codifica AS2 | Fornisce la crittografia, la firma digitale e i riconoscimenti tramite notifiche per l'eliminazione dei messaggi (MDN), che consentono di supportare la mancata valutazione. Ad esempio, questa azione applica le intestazioni AS2/HTTP ed esegue le attività seguenti quando configurate: - Firmare i messaggi in uscita. - Crittografare i messaggi in uscita. - Comprimere il messaggio. - Trasmettere il nome del file nell'intestazione MIME. |
| Azione di decodifica AS2 | Fornire la decrittografia, la firma digitale e i riconoscimenti tramite notifiche per l'eliminazione dei messaggi (MDN). Ad esempio, questa azione esegue le attività seguenti quando configurate: - Elaborare intestazioni AS2/HTTP. - Riconciliare le reti MDN ricevute con i messaggi in uscita originali. - Aggiornare e correlare i record nel database non di controllo. - Scrivere record per la segnalazione dello stato AS2. - Output del contenuto del payload come codificato in base64. - Determinare se sono necessarie le reti MDN. In base al contratto AS2, determinare se le reti MDN devono essere sincrone o asincrone. - Generare mdn sincroni o asincroni in base al contratto AS2. - Impostare i token di correlazione e le proprietà nelle reti MDN. - Verificare la firma. - Decrittografare i messaggi. - Decomprimere il messaggio. - Controllare e non consentire i duplicati dell'ID messaggio. |
Prerequisiti
Account e sottoscrizione di Azure. Se non si ha ancora una sottoscrizione, iscriversi per ottenere un account Azure gratuito.
Risorsa e flusso di lavoro dell'app per la logica in cui si vogliono usare le operazioni AS2.
Risorsa dell'account di integrazione per definire e archiviare gli artefatti da usare nei flussi di lavoro di integrazione aziendale e B2B.
Sia l'account di integrazione che la risorsa dell'app per la logica devono esistere nella stessa sottoscrizione di Azure e nella stessa area di Azure.
Definisce almeno due partner commerciali che partecipano all'operazione AS2 usata nel flusso di lavoro. Le definizioni per entrambi i partner devono usare lo stesso qualificatore di identità aziendale, ovvero AS2Identity per questo scenario.
Definisce un accordo AS2 tra i partner commerciali che partecipano al flusso di lavoro. Ogni contratto richiede un partner host e un partner guest. Il contenuto nei messaggi tra l'utente e l'altro partner deve corrispondere al tipo di contratto. Per informazioni sulle impostazioni del contratto da usare per la ricezione e l'invio di messaggi, vedere Impostazioni dei messaggi AS2.
In base al fatto che si stia lavorando a un flusso di lavoro di app per la logica a consumo o standard, la risorsa dell'app per la logica potrebbe richiedere un collegamento all'account di integrazione:
Flusso di lavoro dell'app per la logica Collegamento obbligatorio? Consumo - Connettore AS2 (v2): Connessione ion obbligatorio, ma non è necessario alcun collegamento
- Connettore AS2 : collegamento obbligatorio, ma nessuna connessione necessariaStandard - Connettore AS2 (v2): collegamento obbligatorio, ma nessuna connessione necessaria
- Connettore AS2: Connessione richiesta, ma non è necessario alcun collegamentoSe si usa Azure Key Vault per la gestione dei certificati, verificare che le chiavi dell'insieme di credenziali consentano le operazioni Crittografa e Decrittografia . In caso contrario, le azioni di codifica e decodifica hanno esito negativo.
Nella portale di Azure aprire l'insieme di credenziali delle chiavi. Nel menu dell'insieme di credenziali delle chiavi, in Impostazioni, selezionare Chiavi.
Nel riquadro Chiavi selezionare la chiave. Nel riquadro Versioni selezionare la versione chiave in uso.
Nel riquadro Versione chiave, in Operazioni consentite, verificare che le operazioni Crittografa e Decrittografia siano selezionate, ad esempio:
Codificare i messaggi AS2
Selezionare la scheda per i flussi di lavoro delle app per la logica a consumo o Standard:
Connettore AS2 v2
Nella portale di Azure aprire la risorsa e il flusso di lavoro dell'app per la logica nella finestra di progettazione.
Nella finestra di progettazione seguire questa procedura generale per aggiungere l'azione AS2 (v2) denominata AS2 Encode (Codifica AS2) al flusso di lavoro.
Nella casella informazioni sull'azione specificare le informazioni seguenti:
Proprietà Richiesto Descrizione Messaggio da codificare Sì Payload del messaggio, ad esempio, output del corpo del trigger Richiesta.
1. Posizionare il cursore nella casella Messaggio per codificare in modo che venga aperto l'elenco di contenuto dinamico.
2. Accanto al nome della sezione Quando viene ricevuta una richiesta HTTP, selezionare Visualizza altro.
3. Nell'elenco degli output selezionare Corpo.AS2 da Sì Identificatore aziendale per il mittente del messaggio come specificato dal contratto AS2, ad esempio Fabrikam. Da AS2 a Sì Identificatore aziendale per il destinatario del messaggio come specificato dal contratto AS2, ad esempio Contoso. 
Connettore AS2
Nella portale di Azure aprire la risorsa e il flusso di lavoro dell'app per la logica nella finestra di progettazione.
Nella finestra di progettazione seguire questa procedura generale per aggiungere l'azione AS2 denominata Encode to AS2 message to AS2 (Codifica a AS2) al flusso di lavoro.
Quando viene richiesto di creare una connessione all'account di integrazione, specificare le informazioni seguenti:
Proprietà Richiesto Descrizione Nome connessione Sì Nome della connessione Account di integrazione Sì Nell'elenco degli account di integrazione disponibili selezionare l'account da usare. Ad esempio:
Al termine, seleziona Crea.
Nella casella informazioni sull'azione specificare le informazioni seguenti.
Proprietà Richiesto Descrizione AS2-From Sì Identificatore aziendale per il mittente del messaggio come specificato dal contratto AS2, ad esempio Fabrikam. Da AS2 a Sì Identificatore aziendale per il destinatario del messaggio come specificato dal contratto AS2, ad esempio Contoso. body Sì Payload del messaggio da codificare, ad esempio, l'output body del trigger request.
1. Posizionare il cursore nella casella del corpo in modo che venga aperto l'elenco di contenuto dinamico.
2. Accanto al nome della sezione Quando viene ricevuta una richiesta HTTP, selezionare Visualizza altro.
3. Nell'elenco degli output selezionare Corpo.
Decodificare i messaggi AS2
Selezionare la scheda per i flussi di lavoro delle app per la logica a consumo o Standard:
Connettore AS2 v2
Nella portale di Azure aprire la risorsa e il flusso di lavoro dell'app per la logica nella finestra di progettazione.
Nella finestra di progettazione seguire questa procedura generale per aggiungere l'azione AS2 (v2) denominata AS2 Decode al flusso di lavoro.
Nella casella informazioni sull'azione specificare le informazioni seguenti:
Proprietà Richiesto Descrizione body Sì Corpo del messaggio da decodificare, ad esempio, l'output body del trigger Request.
1. Posizionare il cursore nella casella del corpo in modo che venga aperto l'elenco di contenuto dinamico.
2. Accanto al nome della sezione Quando viene ricevuta una richiesta HTTP, selezionare Visualizza altro.
3. Nell'elenco degli output selezionare Corpo.Intestazioni Sì Intestazioni per il messaggio da decodificare, ad esempio, l'output Delle intestazioni dal trigger Richiesta.
1. Posizionare il cursore nella casella Intestazioni in modo che venga aperto l'elenco di contenuto dinamico.
2. Accanto al nome della sezione Quando viene ricevuta una richiesta HTTP, selezionare Visualizza altro.
3. Nell'elenco degli output selezionare Intestazioni.Ad esempio:
Connettore AS2
Nella portale di Azure aprire la risorsa e il flusso di lavoro dell'app per la logica nella finestra di progettazione.
Nella finestra di progettazione seguire questa procedura generale per aggiungere il messaggio AS2 denominato Decode AS2 al flusso di lavoro.
Quando viene richiesto di creare una connessione all'account di integrazione, specificare le informazioni seguenti:
Proprietà Richiesto Descrizione Nome connessione Sì Nome della connessione Account di integrazione Sì Nell'elenco degli account di integrazione disponibili selezionare l'account da usare. Ad esempio:
Al termine, seleziona Crea.
Nella casella informazioni sull'azione specificare le informazioni seguenti.
Proprietà Richiesto Descrizione body Sì Payload del messaggio, ad esempio, output del corpo del trigger Richiesta.
1. Posizionare il cursore nella casella del corpo in modo che venga aperto l'elenco di contenuto dinamico.
2. Accanto al nome della sezione Quando viene ricevuta una richiesta HTTP, selezionare Visualizza altro.
3. Nell'elenco degli output selezionare Corpo.Intestazioni Sì Intestazioni per il messaggio da decodificare, ad esempio, l'output Delle intestazioni dal trigger Richiesta.
1. Posizionare il cursore nella casella Intestazioni in modo che venga aperto l'elenco di contenuto dinamico.
2. Accanto al nome della sezione Quando viene ricevuta una richiesta HTTP, selezionare Visualizza altro.
3. Nell'elenco degli output selezionare Intestazioni.
Esempio
Per provare a distribuire un'app per la logica completamente operativa e uno scenario AS2 (v2) completo, esaminare il modello e lo scenario dell'app per la logica AS2 (v2).
Risoluzione dei problemi
Problemi durante l'invio di messaggi firmati o crittografati
Provare diversi formati di algoritmo SHA256. La specifica AS2 non fornisce informazioni sui formati SHA256, quindi ogni provider usa la propria implementazione o formato.