Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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, use o conector AS2 (v2). Este conector fornece ações que suportam 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. O conector AS2 (v2) executa-se nativamente com o ambiente de execução dos Logic Apps do Azure e oferece melhorias significativas na performance em termos de tamanho, taxa de transferência e latência das mensagens. 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, vincule sua conta de integração ao recurso do aplicativo lógico onde você planeja usar o conector.
Este guia mostra como adicionar as ações de codificação e decodificação para AS2 (v2) e AS2 a um fluxo de trabalho de aplicativo lógico existente. O conector AS2 (v2) não fornece 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, que aparecem na galeria de conectores em Compartilhado. O conector AS2 tem um gatilho e várias ações. O conector AS2 (v2) fornece apenas ações. Você pode usar qualquer gatilho que funcione para o seu cenário. Para mais informações, consulte: - Referência do conector gerenciado AS2 - Operações do conector gerenciado AS2 (v2) - Limites de mensagens AS2 |
| Standard | Aplicações Lógicas do Azure de locatário único, Ambiente de Serviço de Aplicações v3 (planos Windows apenas) e implantação híbrida | Conector integrado AS2 (v2), que aparece na galeria de conectores em Built-in, e conector gerenciado AS2, que aparece na galeria de conectores em Compartilhado. O conector AS2 tem um gatilho e várias ações. O conector AS2 (v2) fornece apenas ações. Você pode usar qualquer gatilho que funcione para o seu cenário. A versão integrada difere das seguintes maneiras: - A versão interna pode acessar diretamente as redes virtuais do Azure. Você não precisa de um gateway de dados local. Para mais informações, consulte: - 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 | Fornece desencriptação, assinatura digital e confirmações através de Notificações de Disposiçã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.
Antes de começar a trabalhar com operações AS2 (v2) ou AS2, você deve vincular seu aplicativo lógico de consumo ou vincular seu aplicativo lógico padrão a uma conta de integração. Quando você adiciona uma operação AS2 (v2) ou AS2, também pode ser necessário criar uma conexão com a conta de integração:
Fluxo de trabalho do aplicativo lógico Link necessário? Consumo - Conector AS2 (v2): Não é necessária ligação
- Conector AS2: Conexão necessáriaStandard - Conector AS2 (v2): Não é necessária ligação
- Conector AS2: Conexão necessáriaSe 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 recurso de cofre de chaves. Na barra lateral do recurso, em Objetos, selecione Chaves.
Na página Chaves , selecione a sua chave. Na página Versões , selecione a versão principal que está a utilizar.
Na página Versão da Chave, em Operações permitidas, confirme se Encriptar e Desencriptar estão selecionados.
Codificar mensagens AS2
Para codificar mensagens com o conector AS2 (v2) ou o conector AS2, siga as etapas correspondentes.
AS2 v2 conector
Para codificar mensagens com o conector AS2 (v2), siga estes passos:
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.
No painel de informações da ação, forneça as seguintes informações:
Parâmetro Necessário Descrição Mensagem para codificar Sim A carga útil da mensagem para codificar, por exemplo, a saída Body do gatilho Request.
1. Selecione dentro da caixa Mensagem para codificar e, em seguida, selecione o ícone de relâmpago para abrir a lista de conteúdo dinâmico.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista, 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. Por exemplo, a carga útil da mensagem é a saída de conteúdo do corpo do gatilho Request:
Conector AS2
Para codificar mensagens com o conector AS2, siga estes passos:
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:
Parâmetro Necessário Descrição Nome da conexão Sim Um nome para a conexão. ID da conta de integração Sim O nome da sua conta de integração. URL SAS da Conta de Integração Sim A URL de callback para a sua conta de integração. Por exemplo:
Quando terminar, selecione Criar novo.
No painel de informações da ação, forneça as seguintes informações.
Parâmetro Necessário Descrição 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. Selecione dentro da caixa de corpo e, em seguida, selecione o ícone de relâmpago para abrir a lista de conteúdo dinâmico.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista, selecione Corpo.
Descodificar mensagens AS2
Para descodificar mensagens com o conector AS2 (v2) ou o conector AS2, siga os passos correspondentes.
AS2 v2 conector
Para descodificar mensagens com o conector AS2 (v2), siga estes passos:
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.
No painel de informações da ação, forneça as seguintes informações:
Parâmetro Necessário Descrição Mensagem para descodificar Sim A carga útil da mensagem para decodificar, por exemplo, a saída Body do gatilho Request.
1. Selecione dentro da caixa Mensagem para decodificar e, em seguida, selecione o ícone de relâmpago para abrir a lista de conteúdo dinâmico.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista, selecione Corpo.Cabeçalhos de mensagens Sim Os cabeçalhos da mensagem para decodificar, por exemplo, a saída Cabeçalhos do gatilho Solicitação.
1. Selecione dentro da caixa Cabeçalhos de mensagem e, em seguida, selecione o ícone de função para abrir o editor de expressão.
2. Na caixa do editor, digite a seguinte expressão:triggerOutputs()?['headers']
3. Quando terminar, selecione Adicionar.Por exemplo:
Conector AS2
Para descodificar mensagens com o conector AS2, siga estes passos:
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:
Parâmetro Necessário Descrição Nome da conexão Sim Um nome para a conexão. ID da conta de integração Sim O ID do recurso para sua conta de integração, que tem o seguinte formato: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name>
Por exemplo:/subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount
Para localizar este ID de recurso, siga estes passos:
1. No portal do Azure, abra sua conta de integração.
2. Na barra lateral da conta de integração, selecione Visão geral.
3. Na página Visão geral , selecione Visualização JSON.
4. A partir da propriedade Resource ID, copie o valor.URL SAS da Conta de Integração Sim O URL do ponto de extremidade da solicitação que usa a autenticação por assinatura de acesso partilhado (SAS) para permitir o acesso à sua conta de integração. Este URL de retorno de chamada tem o seguinte formato: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature>
Por exemplo:https://prod-04.west-us.logic-azure.com:443/integrationAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=aB1cD2eF-3gH4iJ5kL6-mN7oP8qR
Para localizar este URL, siga estes passos:
1. No portal do Azure, abra sua conta de integração.
2. Na barra lateral da conta de integração, em Configurações, selecione URL de retorno de chamada.
3. A partir da propriedade URL de retorno de chamada gerada, copie o valor.Por exemplo:
Quando terminar, selecione Criar novo.
No painel de informações da ação, forneça os seguintes valores:
Parâmetro Necessário Descrição corpo Sim A carga útil da mensagem, por exemplo, a saída Body do gatilho Request.
1. Selecione dentro da caixa de corpo e, em seguida, selecione o ícone de relâmpago para abrir a lista de conteúdo dinâmico.
2. Ao lado do nome da seção Quando uma solicitação HTTP for recebida, selecione Ver mais.
3. Na lista, selecione Corpo.Cabeçalhos Sim Os cabeçalhos da mensagem para decodificar, por exemplo, a saída Cabeçalhos do gatilho Solicitação.
1. Selecione dentro da caixa Cabeçalhos e, em seguida, selecione o ícone de função para abrir o editor de expressões.
2. Na caixa do editor, digite a seguinte expressão:triggerOutputs()?['headers']
3. Quando terminar, selecione Adicionar.Por exemplo:
Exemplo
Para implantar um fluxo de trabalho de aplicativo lógico totalmente funcional e um cenário de exemplo AS2 (v2), consulte 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.