Scambiare messaggi AS2 per l'integrazione aziendale con le app per la logica di AzureExchange AS2 messages for enterprise integration with logic apps

Per poter scambiare messaggi AS2 con App per la logica di Azure, è necessario creare un contratto AS2 e archiviarlo nell'account di integrazione.Before you can exchange AS2 messages for Azure Logic Apps, you must create an AS2 agreement and store that agreement in your integration account. Di seguito viene illustrata la procedura per la creazione di un contratto AS2.Here are the steps for how to create an AS2 agreement.

Prima di iniziareBefore you start

Sono necessari gli elementi seguenti:Here's the items you need:

  • Un account di integrazione già definito e associato alla sottoscrizione di Azure.An integration account that's already defined and associated with your Azure subscription
  • Almeno due partner già definiti nell'account di integrazione e configurati con il qualificatore AS2 in Identità di business.At least two partners that are already defined in your integration account and configured with the AS2 qualifier under Business Identities

Nota

Quando si crea un contratto, il contenuto del file del contratto deve corrispondere al tipo di contratto.When you create an agreement, the content in the agreement file must match the agreement type.

Dopo aver creato un account di integrazione e aggiunto i partner, è possibile creare un contratto AS2 attenendosi alla procedura seguente.After you create an integration account and add partners, you can create an AS2 agreement by following these steps.

Creare un contratto AS2Create an AS2 agreement

  1. Accedere al Portale di Azure.Sign in to the Azure portal.

  2. Fare clic su Altri servizi nel menu a sinistra.From the left menu, select More services. Nella casella di ricerca, digitare integrazione come filtro.In the search box, enter integration as your filter. Nell'elenco dei risultati selezionare Account di integrazione.In the results list, select Integration Accounts.

    Suggerimento

    Se Altri servizi non viene visualizzato, potrebbe essere necessario espandere il menu.If you don't see More services, you might have to expand the menu first. Nella parte superiore del menu compresso, selezionare Visualizza menu.At the top of the collapsed menu, select Show menu.

    Altri servizi, filtro su "integrazione", selezionare "Account di integrazione"

  3. Nel pannello Account di integrazione visualizzato selezionare l'account di integrazione nel quale creare il contratto.In the Integration Accounts blade that opens, select the integration account where you want to create the agreement. Se non viene visualizzato alcun account di integrazione, crearne prima uno.If you don't see any integration accounts, create one first.

    Selezionare l'account di integrazione in cui si vuole creare il contratto.

  4. Selezionare il riquadro Accordi.Choose the Agreements tile. Se non è presente il riquadro dei contratti, aggiungerlo.If you don't have an Agreements tile, add the tile first.

    Selezionare il riquadro "Contratti"

  5. Nel pannello Contratti visualizzato, selezionare Aggiungi.In the Agreements blade that opens, choose Add.

    Selezionare "Aggiungi"

  6. In Aggiungi, digitare un nome per il contratto.Under Add, enter a Name for your agreement. In Tipo di contrattoselezionare AS2.For Agreement type, select AS2. Selezionare il Partner host, l'Identità host, il Partner guest, e l'Identità guest per il contratto.Select the Host Partner, Host Identity, Guest Partner, and Guest Identity for your agreement.

    Fornire i dettagli relativi al contratto

    ProprietàProperty DescrizioneDescription
    NomeName Nome del contrattoName of the agreement
    Tipo di contrattoAgreement Type Deve essere AS2Should be AS2
    Host Partner (Partner host)Host Partner Un contratto prevede un partner host e un partner guest.An agreement needs both a host and guest partner. Il partner host rappresenta l'organizzazione che configura il contratto.The host partner represents the organization that configures the agreement.
    Host Identity (Identità host)Host Identity Un identificatore per il partner hostAn identifier for the host partner
    Guest Partner (Partner guest)Guest Partner Un contratto prevede un partner host e un partner guest.An agreement needs both a host and guest partner. Il partner guest rappresenta l'organizzazione che intrattiene attività commerciali con il partner host.The guest partner represents the organization that's doing business with the host partner.
    identità guestGuest Identity Un identificatore per il partner guestAn identifier for the guest partner
    Receive Settings (Impostazioni di ricezione)Receive Settings Queste proprietà si applicano a tutti i messaggi ricevuti da un contratto.These properties apply to all messages received by an agreement.
    Send Settings (Impostazioni di invio)Send Settings Queste proprietà si applicano a tutti i messaggi inviati da un contratto.These properties apply to all messages sent by an agreement.

Configurare il modo in cui il contratto riceve i messaggiConfigure how your agreement handles received messages

Dopo aver impostato le proprietà del contratto, è possibile configurare il modo in cui il contratto identifica e gestisce i messaggi in arrivo ricevuti dal partner tramite il presente contratto.Now that you've set the agreement properties, you can configure how this agreement identifies and handles incoming messages received from your partner through this agreement.

  1. In Aggiungi, selezionare Impostazioni di ricezione.Under Add, select Receive Settings. Configurare queste proprietà in base al contratto con il partner con cui si scambiano i messaggi.Configure these properties based on your agreement with the partner that exchanges messages with you. Per le descrizioni delle proprietà, vedere la tabella in questa sezione.For property descriptions, see the table in this section.

    Configurare "Impostazioni di ricezione"

  2. Facoltativamente, è possibile eseguire l'override delle proprietà dei messaggi in arrivo selezionando Ignora proprietà del messaggio.Optionally, you can override the properties of incoming messages by selecting Override message properties.

  3. Selezionare Il messaggio deve essere firmato per richiedere la firma di tutti i messaggi in arrivo.To require all incoming messages to be signed, select Message should be signed. Per convalidare la firma dei messaggi, selezionare un certificato pubblico del partner guest nell'elenco Certificato.From the Certificate list, select an existing guest partner public certificate for validating the signature on the messages. Se non si dispone del certificato, crearne uno.Or create the certificate, if you don't have one.

  4. Per richiedere la crittografia di tutti i messaggi in arrivo, selezionare Il messaggio deve essere crittografato.To require all incoming messages to be encrypted, select Message should be encrypted. Per decrittografare i messaggi in arrivo, dall'elenco Certificato selezionare un certificato privato del partner host.From the Certificate list, select an existing host partner private certificate for decrypting incoming messages. Se non si dispone del certificato, crearne uno.Or create the certificate, if you don't have one.

  5. Per richiedere la compressione dei messaggi, selezionare Il messaggio deve essere compresso.To require messages to be compressed, select Message should be compressed.

  6. Per inviare una notifica sulla ricezione del messaggio (MDN) per i messaggi ricevuti, selezionare Invia notifica sulla ricezione del messaggio.To send a synchronous message disposition notification (MDN) for received messages, select Send MDN.

  7. Per inviare notifiche sulla ricezione del messaggio firmate per i messaggi ricevuti, selezionare Invia notifica sulla ricezione del messaggio firmata.To send signed MDNs for received messages, select Send signed MDN.

  8. Per inviare notifiche asincrone sulla ricezione del messaggio per i messaggi ricevuti, selezionare Invia notifica sulla ricezione del messaggio asincrona.To send asynchronous MDNs for received messages, select Send asynchronous MDN.

  9. Al termine, assicurarsi di salvare le impostazioni selezionando OK.After you're done, make sure to save your settings by choosing OK.

Il contratto è pronto per gestire i messaggi in arrivo conformi alle impostazioni selezionate.Now your agreement is ready to handle incoming messages that conform to your selected settings.

ProprietàProperty DescrizioneDescription
Override message propertiesOverride message properties Indica che è possibile eseguire l'override delle proprietà nei messaggi ricevuti.Indicates that properties in received messages can be overridden.
Il messaggio deve essere firmatoMessage should be signed Richiede la firma digitale dei messaggi.Requires messages to be digitally signed. Configurare il certificato pubblico del partner guest per la verifica della firma.Configure the guest partner public certificate for signature verification.
Il messaggio deve essere crittografatoMessage should be encrypted Richiede la crittografia dei messaggi.Requires messages to be encrypted. I messaggi non crittografati vengono rifiutati.Non-encrypted messages are rejected. Configurare il certificato privato del partner host per la decrittografia dei messaggi.Configure the host partner private certificate for decrypting the messages.
Il messaggio deve essere compressoMessage should be compressed Richiede la compressione dei messaggi.Requires messages to be compressed. I messaggi non compressi vengono rifiutati.Non-compressed messages are rejected.
Testo MDNMDN Text Notifica sulla ricezione del messaggio (MDN) predefinita da inviare al mittente del messaggio.The default message disposition notification (MDN) to be sent to the message sender.
Send MDN (Invia MDN)Send MDN Richiede l'invio della MDN.Requires MDNs to be sent.
Send signed MDN (Invia MDN firmato)Send signed MDN Richiede la firma delle MDN.Requires MDNs to be signed.
MIC Algorithm (Algoritmo MIC)MIC Algorithm Selezionare l'algoritmo da usare per firmare i messaggi.Select the algorithm to use for signing messages.
Send asynchronous MDN (Invia MDN asincrono)Send asynchronous MDN Richiede l'invio asincrono dei messaggi.Requires messages to be sent asynchronously.
URLURL Specificare l'URL al quale inviare le MDN.Specify the URL where to send the MDNs.

Configurare il modo in cui il contratto invia messaggiConfigure how your agreement sends messages

È possibile configurare il modo in cui il contratto identifica e gestisce i messaggi in uscita inviati ai partner tramite il presente contratto.You can configure how this agreement identifies and handles outgoing messages that you send to your partners through this agreement.

  1. In Aggiungi, selezionare Impostazioni di avvio.Under Add, select Send Settings. Configurare queste proprietà in base al contratto con il partner con cui si scambiano i messaggi.Configure these properties based on your agreement with the partner that exchanges messages with you. Per le descrizioni delle proprietà, vedere la tabella in questa sezione.For property descriptions, see the table in this section.

    Impostare le proprietà "Impostazioni di invio"

  2. Per inviare messaggi firmati al partner, selezionare Abilita firma del messaggio.To send signed messages to your partner, select Enable message signing. Per firmare i messaggi, nell'elenco Algoritmo per il controllo di integrità delle credenziali, selezionare l'algoritmo per il controllo di integrità delle credenziali del certificato privato del partner host.For signing the messages, in the MIC Algorithm list, select the host partner private certificate MIC Algorithm. Dall'elenco Certificato, selezionare un certificato privato del partner host esistente.And in the Certificate list, select an existing host partner private certificate.

  3. Per inviare messaggi crittografati al partner, selezionare Abilita crittografia messaggio.To send encrypted messages to the partner, select Enable message encryption. Per crittografare i messaggi, nell'elenco Algoritmo di crittografia selezionare l'algoritmo del certificato pubblico del partner guest.For encrypting the messages, in the Encryption Algorithm list, select the guest partner public certificate algorithm. Dall'elenco Certificato, selezionare un certificato pubblico del partner guest esistente.And in the Certificate list, select an existing guest partner public certificate.

  4. Per comprimere il messaggio, selezionare Abilita compressione messaggio.To compress the message, select Enable message compression.

  5. Per espandere l'intestazione HTTP del tipo di contenuto in una singola riga, selezionare Espandi intestazioni HTTP.To unfold the HTTP content-type header into a single line, select Unfold HTTP headers.

  6. Per ricevere notifiche sincrone sulla ricezione del messaggio per i messaggi inviati, selezionare Richiedi notifica sulla ricezione del messaggio.To receive synchronous MDNs for the sent messages, select Request MDN.

  7. Per ricevere notifiche sulla ricezione del messaggio firmate per i messaggi inviati, selezionare Richiedi notifica sulla ricezione del messaggio firmata.To receive signed MDNs for the sent messages, select Request signed MDN.

  8. Per ricevere notifiche asincrone sulla ricezione del messaggio per i messaggi inviati, selezionare Richiedi notifica sulla ricezione del messaggio asincrona.To receive asynchronous MDNs for the sent messages, select Request asynchronous MDN. Se si seleziona questa opzione, immettere l'URL a cui inviare le MDN.If you select this option, enter the URL for where to send the MDNs.

  9. Per richiedere il non ripudio della ricezione, selezionare Abilita rilevamento messaggi (NRR).To require non-repudiation of receipt, select Enable NRR.

  10. Per specificare il formato di algoritmo da usare per il controllo di integrità delle credenziali o la firma nelle intestazioni in uscita del messaggio AS2 o della notifica sulla ricezione del messaggio, selezionare il formato di algoritmo SHA2.To specify algorithm format to use in the MIC or signing in the outgoing headers of the AS2 message or MDN, select SHA2 Algorithm format.

  11. Al termine, assicurarsi di salvare le impostazioni selezionando OK.After you're done, make sure to save your settings by choosing OK.

Il contratto è pronto per gestire i messaggi in uscita conformi alle impostazioni selezionate.Now your agreement is ready to handle outgoing messages that conform to your selected settings.

ProprietàProperty DescrizioneDescription
Enable message signing (Abilita la firma dei messaggi)Enable message signing Richiede la firma di tutti i messaggi inviati dal contratto.Requires all messages that are sent from the agreement to be signed.
MIC Algorithm (Algoritmo MIC)MIC Algorithm L'algoritmo da usare per firmare i messaggi.The algorithm to use for signing messages. Configura algoritmo per il controllo di integrità delle credenziali del certificato privato del partner host per la firma dei messaggi.Configures the host partner private certificate MIC Algorithm for signing the messages.
CertificateCertificate Selezionare il certificato da usare per firmare i messaggi.Select the certificate to use for signing messages. Configura il certificato privato del partner host per la firma dei messaggi.Configures the host partner private certificate for signing the messages.
Enable message encryption (Abilita la crittografia dei messaggi)Enable message encryption Richiede la crittografia di tutti i messaggi inviati da questo contratto.Requires encryption of all messages that are sent from this agreement. Configura l'algoritmo del certificato pubblico del partner guest per la crittografia dei messaggi.Configures the guest partner public certificate algorithm for encrypting the messages.
Algoritmo di crittografiaEncryption Algorithm Algoritmo di crittografia da usare per la crittografia dei messaggi.The encryption algorithm to use for message encryption. Configura il certificato pubblico del partner guest per la crittografia dei messaggi.Configures the guest partner public certificate for encrypting the messages.
CertificateCertificate Certificato da usare per crittografare i messaggi.The certificate to use to encrypt messages. Configura il certificato privato del partner guest per crittografare i messaggi.Configures the guest partner private certificate for encrypting the messages.
Abilita compressione messaggioEnable message compression Richiede la compressione di tutti i messaggi inviati da questo contratto.Requires compression of all messages that are sent from this agreement.
Espandi intestazioni HTTPUnfold HTTP headers Posiziona l'intestazione HTTP del tipo di contenuto in una singola riga.Places the HTTP content-type header onto a single line.
Richiedi MDNRequest MDN Richiede un MDN per tutti i messaggi inviati da questo contratto.Requires an MDN for all messages that are sent from this agreement.
Richiedi MDN firmatoRequest signed MDN Richiede la firma di tutti gli MDN che vengono inviati a questo contratto.Requires all MDNs that are sent to this agreement to be signed.
Richiedi MDN asincronoRequest asynchronous MDN Richiede l'invio di MDN asincroni a questo contratto.Requires asynchronous MDNs to be sent to this agreement.
URLURL Specificare l'URL al quale inviare le MDN.Specify the URL where to send the MDNs.
Enable NRR (Attiva NRR)Enable NRR Richiede il non ripudio della ricezione (NRR), un attributo di comunicazione che fornisce prova di ricezione dei dati come inviati.Requires non-repudiation of receipt (NRR), a communication attribute that provides evidence that the data was received as addressed.
Formato di algoritmo SHA2SHA2 Algorithm format Selezionare il formato di algoritmo da usare per il controllo di integrità delle credenziali o la firma nelle intestazioni in uscita del messaggio AS2 o della notifica sulla ricezione del messaggioSelect algorithm format to use in the MIC or signing in the outgoing headers of the AS2 message or MDN

Individuare il contratto creatoFind your created agreement

  1. Dopo aver impostato tutte le proprietà del contratto, scegliere OK nel pannello Aggiungi per completare la creazione del contratto e tornare al pannello dell'account di integrazione.After you finish setting all your agreement properties, on the Add blade, choose OK to finish creating your agreement and return to your integration account blade.

    Il contratto appena aggiunto viene visualizzato nell'elenco Contratti.Your newly added agreement now appears in your Agreements list.

  2. È anche possibile visualizzare i contratti nella panoramica dell'account di Integrazione.You can also view your agreements in your integration account overview. Nel pannello dell'account di integrazione, selezionare Panoramica, quindi selezionare il riquadro Contratti.On your integration account blade, choose Overview, then select the Agreements tile.

    Scegliere il riquadro Contratti per visualizzare tutti i contratti

Visualizzare il file SwaggerView the swagger

Vedere i dettagli del file Swagger.See the swagger details.

Passaggi successiviNext steps