Mensagens do Exchange AS2 usando fluxos de trabalho nos Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)
Para enviar e receber mensagens AS2 em fluxos de trabalho criados usando os Aplicativos Lógicos do Azure, você pode usar o conector AS2 (v2), que fornece ações que dão suporte e gerenciam a comunicação AS2. Se você precisar de recursos de rastreamento, o conector AS2 original ainda está disponível, mas está sendo preterido.
Exceto para recursos de rastreamento, o conector AS2 (v2) fornece os mesmos recursos que o conector AS2 original, é executado nativamente com o tempo de execução dos Aplicativos Lógicos do Azure e oferece melhorias significativas de desempenho no tamanho, taxa de transferência e latência da mensagem. Ao contrário do conector AS2 original, o conector AS2 (v2) não requer que você crie uma conexão com sua conta de integração. Em vez disso, conforme descrito nos pré-requisitos, certifique-se de vincular sua conta de integração ao recurso do aplicativo lógico onde planeja usar o conector.
Este guia de instruções mostra como adicionar as ações de codificação e decodificação AS2 a um fluxo de trabalho de aplicativo lógico existente. O conector AS2 (v2) não inclui nenhum gatilho, portanto, você pode usar qualquer gatilho para iniciar seu fluxo de trabalho. Os exemplos neste guia usam o gatilho Request.
Referência técnica do conector
O conector AS2 tem diferentes versões, com base no tipo de aplicativo lógico e no ambiente de host.
| Aplicação lógica | Environment | Versão do conector |
|---|---|---|
| Consumo | Aplicativos Lógicos do Azure multilocatários | Conectores gerenciados AS2 (v2) e AS2 (classe Standard). O conector AS2 (v2) fornece apenas ações, mas você pode usar qualquer gatilho que funcione para seu cenário. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado AS2 - Operações do conector gerenciado AS2 (v2) - Limites de mensagens AS2 |
| Consumo | Ambiente de serviço de integração (ISE) | Conectores gerenciados AS2 (v2) e AS2 (classe Standard) e versão AS2 ISE, que tem limites de mensagem diferentes da classe Standard. O conector AS2 (v2) fornece apenas ações, mas você pode usar qualquer gatilho que funcione para seu cenário. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado AS2 - Operações do conector gerenciado AS2 (v2) - Limites de mensagens AS2 |
| Standard | Aplicativos Lógicos do Azure e Ambiente do Serviço de Aplicativo v3 de locatário único (somente planos do Windows) | Conector integrado AS2 (v2) e conector gerenciado AS2 . A versão integrada difere das seguintes maneiras: - A versão integrada fornece apenas ações, mas você pode usar qualquer gatilho que funcione para o seu cenário. - A versão interna pode acessar diretamente as redes virtuais do Azure. Você não precisa de um gateway de dados local. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado AS2 - Operações de conector integrado AS2 (v2) - Limites de mensagens AS2 |
Operações AS2 (v2)
O conector AS2 (v2) não tem gatilhos. A tabela a seguir descreve as ações que o conector AS2 (v2) fornece para estabelecer segurança e confiabilidade ao transmitir mensagens:
| Ação | Descrição |
|---|---|
| Ação de codificação AS2 | Fornece criptografia, assinatura digital e confirmações por meio de notificações de disposição de mensagens (MDN), que ajudam a dar suporte ao não repúdio. Por exemplo, essa ação aplica cabeçalhos AS2/HTTP e executa as seguintes tarefas quando configurada: - Assine mensagens enviadas. - Criptografar mensagens enviadas. - Comprima a mensagem. - Transmita o nome do arquivo no cabeçalho MIME. |
| Ação de descodificação AS2 | Forneça desencriptação, assinatura digital e confirmações através de notificações de eliminação de mensagens (MDN). Por exemplo, essa ação executa as seguintes tarefas quando configurada: - Processar cabeçalhos AS2/HTTP. - Reconciliar MDNs recebidos com as mensagens de saída originais. - Atualizar e correlacionar registros no banco de dados de não repúdio. - Escrever registros para relatórios de status AS2. - Conteúdo da carga útil de saída codificada em base64. - Determinar se os MDNs são necessários. Com base no contrato AS2, determine se os MDNs devem ser síncronos ou assíncronos. - Gerar MDNs síncronos ou assíncronos com base no acordo AS2. - Defina os tokens de correlação e propriedades em MDNs. - Verifique a assinatura. - Desencriptar as mensagens. - Descomprimir a mensagem. - Verifique e não permita duplicatas de ID de mensagem. |
Pré-requisitos
Uma conta e subscrição do Azure. Se ainda não tiver uma subscrição, inscreva-se numa conta gratuita do Azure.
O recurso do aplicativo lógico e o fluxo de trabalho onde você deseja usar as operações AS2.
Um recurso de conta de integração para definir e armazenar artefatos para uso em integração empresarial e fluxos de trabalho B2B.
Sua conta de integração e o recurso do aplicativo lógico devem existir na mesma assinatura do Azure e na mesma região do Azure.
Define pelo menos dois parceiros comerciais que participam da operação AS2 usada em seu fluxo de trabalho. As definições para ambos os parceiros devem usar o mesmo qualificador de identidade comercial, que é AS2Identity para este cenário.
Define um acordo AS2 entre os parceiros comerciais que participam do seu fluxo de trabalho. Cada acordo requer um parceiro anfitrião e um parceiro convidado. O conteúdo das mensagens entre você e o outro parceiro deve corresponder ao tipo de contrato. Para obter informações sobre as configurações de contrato a serem usadas ao receber e enviar mensagens, consulte Configurações de mensagem AS2.
Com base no fato de você estar trabalhando em um fluxo de trabalho de aplicativo lógico de consumo ou padrão, seu recurso de aplicativo lógico pode exigir um link para sua conta de integração:
Fluxo de trabalho do aplicativo lógico Link necessário? Consumo - Conector AS2 (v2): conexão necessária, mas nenhum link necessário
- Conector AS2 : Link necessário, mas nenhuma conexão necessáriaStandard - Conector AS2 (v2):Link necessário, mas nenhuma conexão necessária
- Conector AS2 : conexão necessária, mas nenhum link necessárioSe você usar o Cofre de Chaves do Azure para gerenciamento de certificados, verifique se as chaves do cofre permitem as operações Criptografar e Descriptografar. Caso contrário, as ações de codificação e decodificação falharão.
No portal do Azure, abra seu cofre de chaves. No menu do cofre de chaves, em Configurações, selecione Chaves.
No painel Chaves, selecione sua chave. No painel Versões, selecione a versão principal que está a utilizar.
No painel Versão da Chave, em Operações permitidas, confirme se as operações Criptografar e Descriptografar estão selecionadas, por exemplo:
Codificar mensagens AS2
Selecione a guia para fluxos de trabalho do aplicativo lógico Consumo ou Padrão:
AS2 v2 conector
No portal do Azure, abra o recurso e o fluxo de trabalho do aplicativo lógico no designer.
No designer, siga estas etapas gerais para adicionar a ação AS2 (v2) chamada AS2 Encode ao seu fluxo de trabalho.
Na caixa de informações da ação, forneça as seguintes informações:
Property Obrigatório Description Mensagem para codificar Sim A carga útil da mensagem, por exemplo, a saída Body do gatilho Request.
1. Coloque o cursor na caixa Mensagem para codificar para que a lista de conteúdo dinâmico seja aberta.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista de saídas, selecione Corpo.AS2 de Sim O identificador comercial do remetente da mensagem, conforme especificado pelo seu contrato AS2, por exemplo, Fabrikam. AS2 a Sim O identificador comercial do destinatário da mensagem, conforme especificado pelo seu contrato AS2, por exemplo, Contoso. 
Conector AS2
No portal do Azure, abra o recurso e o fluxo de trabalho do aplicativo lógico no designer.
No designer, siga estas etapas gerais para adicionar a ação AS2 chamada Codificar para mensagem AS2 ao seu fluxo de trabalho.
Quando solicitado a criar uma conexão com sua conta de integração, forneça as seguintes informações:
Property Obrigatório Description Nome da ligação Sim Um nome para a conexão Conta de Integração Sim Na lista de contas de integração disponíveis, selecione a conta a ser usada. Por exemplo:
Quando tiver terminado, selecione Criar.
Na caixa de informações da ação, forneça as seguintes informações.
Property Obrigatório Description AS2-De Sim O identificador comercial do remetente da mensagem, conforme especificado pelo seu contrato AS2, por exemplo, Fabrikam. AS2-Para Sim O identificador comercial do destinatário da mensagem, conforme especificado pelo seu contrato AS2, por exemplo, Contoso. corpo Sim A carga útil da mensagem para codificar, por exemplo, a saída Body do gatilho Request.
1. Coloque o cursor na caixa do corpo para que a lista de conteúdo dinâmico seja aberta.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista de saídas, selecione Corpo.
Descodificar mensagens AS2
Selecione a guia para fluxos de trabalho do aplicativo lógico Consumo ou Padrão:
AS2 v2 conector
No portal do Azure, abra o recurso e o fluxo de trabalho do aplicativo lógico no designer.
No designer, siga estas etapas gerais para adicionar a ação AS2 (v2) chamada AS2 Decode ao seu fluxo de trabalho.
Na caixa de informações da ação, forneça as seguintes informações:
Property Obrigatório Description corpo Sim O corpo da mensagem para decodificar, por exemplo, a saída Body do gatilho Request.
1. Coloque o cursor na caixa do corpo para que a lista de conteúdo dinâmico seja aberta.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista de saídas, selecione Corpo.Cabeçalhos Sim Os cabeçalhos da mensagem para decodificar, por exemplo, a saída Cabeçalhos do gatilho Solicitação.
1. Coloque o cursor na caixa Cabeçalhos para que a lista de conteúdo dinâmico seja aberta.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista de saídas, selecione Cabeçalhos.Por exemplo:
Conector AS2
No portal do Azure, abra o recurso e o fluxo de trabalho do aplicativo lógico no designer.
No designer, siga estas etapas gerais para adicionar a ação AS2 chamada Decodificar mensagem AS2 ao seu fluxo de trabalho.
Quando solicitado a criar uma conexão com sua conta de integração, forneça as seguintes informações:
Property Obrigatório Description Nome da ligação Sim Um nome para a conexão Conta de Integração Sim Na lista de contas de integração disponíveis, selecione a conta a ser usada. Por exemplo:
Quando tiver terminado, selecione Criar.
Na caixa de informações da ação, forneça as seguintes informações.
Property Obrigatório Description corpo Sim A carga útil da mensagem, por exemplo, a saída Body do gatilho Request.
1. Coloque o cursor na caixa do corpo para que a lista de conteúdo dinâmico seja aberta.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista de saídas, selecione Corpo.Cabeçalhos Sim Os cabeçalhos da mensagem para decodificar, por exemplo, a saída Cabeçalhos do gatilho Solicitação.
1. Coloque o cursor na caixa Cabeçalhos para que a lista de conteúdo dinâmico seja aberta.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista de saídas, selecione Cabeçalhos.
Exemplo
Para tentar implantar um aplicativo lógico totalmente operacional e um cenário AS2 (v2) de exemplo, revise o modelo e o cenário do aplicativo lógico AS2 (v2).
Resolução de problemas
Problemas ao enviar mensagens assinadas ou criptografadas
Considere tentar diferentes formatos de algoritmo SHA256. A especificação AS2 não fornece nenhuma informação sobre formatos SHA256, portanto, cada provedor usa sua própria implementação ou formato.