Criar um contrato AS2 nos Serviços BizTalk do Azure

Atualizado: agosto de 2015

Criar um contrato AS2 no Serviços BizTalk para trocar mensagens entre parceiros comerciais usando o protocolo AS2.

Mensagens AS2 não EDI

As mensagens AS2 podem ser enviadas para um destino não EDI ou recebidas de um destino não EDI. Essa funcionalidade vem integrada no AS2, de modo que você não precisa se preocupar com o protocolo de transporte. Você pode usar X12, EDIFACT ou outros protocolos que não estão incluídos no Serviços BizTalk. Por exemplo, você recebe uma mensagem não EDI de um fornecedor pelo AS2. Você processa os dados XML e transforma a mensagem em documentos UBL.

As mensagens não EDI são habilitadas no Projeto do Serviço BizTalk ou no Portal de Serviços do BizTalk. Para usar as mensagens não EDI no Projeto do Serviço BizTalk, use qualquer uma das seguintes ferramentas na Caixa de ferramentas:

  • Ponte unidirecional XML

  • Ponte de solicitação-resposta XML

  • Ponto de extremidade de serviço externo bidirecional

  • Ponto de extremidade de retransmissão bidirecional

Não-repúdio no recebimento (NRR) AS2

O AS2 inclui suporte ao não-repúdio no recebimento (NRR). O Não-Repúdio fornece a prova de que a mensagem é válida e autêntica. Se a validade da mensagem sempre for questionada, a sua validade pode ser provada e, possivelmente, juridicamente associativa.

Por exemplo, você e a Contoso concordam em não-repúdio. Você envia uma mensagem de AS2 para a Contoso para comprar widgets. Em seguida, você nega o envio da mensagem para comprar os widgets da Contoso. Com o não-repúdio habilitado, a Contoso pode recuperar a mensagem para confirmar que você concordou em comprar os widgets.

O Não-repúdio no recebimento (NRR) é habilitado no Portal de Serviços do BizTalk e é usado para mensagens EDI e não EDI.

Os tópicos desta seção listam os passos para criar um contrato AS2, inclusive destinos não-repúdio e não EDI.

A primeira etapa para criar um contrato AS2 entre dois parceiros comerciais é inserir os parceiros e suas identidades AS2.

  1. Na página inicial do Portal de Serviços do BizTalk, selecione Contratos.

  2. Na página Contratos, selecione a guia AS2. Selecione Adicionar. A guia Configurações Gerais é exibida.

  3. Digite as seguintes propriedades:

     

    Nome

    Obrigatório. Insira um nome exclusivo para o contrato.

    Descrição

    Insira notas ou uma descrição do contrato.

  4. Para parceiros hospedados e convidados, insira o seguinte:

     

    Parceiro hospedado

    Parceiro

    Selecione o parceiro hospedado para o contrato. Um parceiro hospedado é o parceiro para o qual a Serviços BizTalk implanta o pipelines de envio e recebimento do AS2.

    Perfil

    O perfil padrão é exibido. Escolha o perfil desejado que foi configurado para o parceiro.

    Identidade AS2

    Digite a Identidade AS2, que é o nome para identificar o parceiro. Os exemplos incluem o nome ou o departamento da empresa.

    Parceiro convidado

    Parceiro

    Selecione o parceiro para o contrato. Um parceiro convidado é um parceiro gerenciado pelo provedor de serviços, e os pipelines são implantados para esse parceiro durante a implantação do contrato.

    Perfil

    O perfil padrão é exibido. Escolha o perfil desejado que foi configurado para o parceiro.

    Identidade AS2

    Digite a Identidade AS2, que é o nome para identificar o parceiro. Os exemplos incluem o nome ou o departamento da empresa.

  5. Em Status de NRR, marque a caixa de seleção Habilitar NRR para habilitar o não-repúdio no recebimento (NRR) no contrato. O NRR é usado quando o Parceiro hospedado e o Parceiro convidado concordam em usar o NRR.

  6. Selecione Continuar. As guias Configurações de Recebimento e Configurações de Envio são adicionadas. Cada guia é usada para criar um contrato unidirecional entre os dois parceiros: uma para receber mensagens e outra para enviar mensagens.

As configurações de recebimento AS2 incluem principalmente detalhes de protocolo, como assinatura, criptografia e compactação de mensagem, bem como o envio de MDNs.

  1. Selecione a guia Configurações de Recebimento da página do contrato AS2. A primeira etapa é determinar se as configurações de recebimento no contrato são usadas ou se as configurações nas mensagens recebidas são usadas. Se você marcar ou desmarcar a opção Substituir configurações do contrato de recebimento pelas da mensagem AS2 recebida, ela determinará isso.

     

    Desmarcada

    Use as configurações definidas no contrato.

    Verificado

    Use as configurações das mensagens recebidas e substitua as configurações no contrato. As seguintes configurações sempre são seguidas no contrato e nunca são substituídas:

    • Texto MDN

    • A mensagem deve ser criptografada

    • A mensagem deve ser assinada

  2. Escolha as configurações de mensagens a serem usadas com este contrato ou modelo:

     

    A mensagem deve ser assinada

    Essa opção força o Parceiro Convidado a assinar as mensagens AS2 com seu certificado particular antes de enviar a mensagem ao Parceiro Hospedado.

    O Parceiro Convidado tem um Certificado Particular (.pfx). O Parceiro Convidado cria o certificado público (.cer) correspondente e o envia a você, o Provedor de Serviços. Esse certificado de chave pública (.cer) é carregado por você no perfil do Parceiro Convidado. Esse certificado de chave pública valida a assinatura do Parceiro Convidado.

    Certificado: Na lista suspensa, escolha o certificado público do Parceiro Convidado (.cer) que você carregou no perfil do Parceiro Convidado. As mensagens recebidas são verificadas para detectar se têm a assinatura correta do Parceiro Convidado.

    noteObservação
    Essa opção não pode ser substituída por uma mensagem recebida.

    A mensagem deve ser criptografada

    Essa opção força o Parceiro Convidado a criptografar a mensagem que está sendo recebida pelo Parceiro Hospedado.

    O Parceiro Hospedado tem um Certificado Particular (.pfx) carregado em seu perfil. Você cria o certificado público correspondente (.cer) e envia esse certificado ao Parceiro Convidado. O certificado público do Parceiro Convidado criptografa a mensagem, e o certificado particular correspondente do Parceiro Hospedado descriptografa a mensagem.

    Certificado: Na lista suspensa, escolha o certificado particular (.pfx) do Parceiro Hospedado que você adicionou ao perfil do Parceiro Hospedado. As mensagens criptografadas recebidas são descriptogradas usando o certificado de chave particular do perfil do Parceiro Hospedado.

    noteObservação
    Essa opção não pode ser substituída por uma mensagem recebida.

    A mensagem deve ser compactada

    Escolha essa opção para compactar mensagens enviadas do Parceiro Convidado ao Parceiro Hospedado.

  3. Escolha as configurações de confirmação que você deseja usar com esse contrato ou modelo. Essas configurações especificam que o Parceiro Convidado solicita uma mensagem de confirmação do Parceiro Hospedado no contrato. As mensagens de confirmação do Parceiro Hospedado são enviadas ao Parceiro Convidado com base na URL nas Configurações de Envio desse contrato AS2.

     

    Texto MDN

    Insira o texto usado no corpo do recibo MDN (Notificação de Disposição de Mensagem). Isso será aplicável se o remetente da mensagem solicitar a MDN ou se o contrato estiver configurado para enviar recibos MDN.

    Enviar MDN

    Essa configuração define o contrato para enviar recibos MDN ao remetente, que é o Parceiro Convidado. O remetente no contexto das configurações de recebimento do contrato é o Parceiro Convidado.

    As seguintes opções estão disponíveis quando a MDN é enviada ao Parceiro Convidado:

     

    Enviar MDN Assinada

    Essa opção define se o recibo MDN é enviado ao Parceiro Convidado e assinado pelo certificado de chave particular do Parceiro Hospedado.

    Opcionalmente, é possível escolher uma opção de algoritmo MIC. As seguintes opções de algoritmo MIC têm suporte para o cálculo do campo Received-Content-MIC da MDN de saída para não recusa no Parceiro Convidado:

    • MD5: campo Received-Content-MIC populado usando o algoritmo MD5.

    • SHA1 (Padrão): campo Received-Content-MIC populado usando o algoritmo SHA1.

    • SHA2-256: campo Received-Content-MIC populado usando o algoritmo SHA2-256.

    • SHA2-384: campo Received-Content-MIC populado usando o algoritmo SHA2-384.

    • SHA2-512: campo Received-Content-MIC populado usando o algoritmo SHA2-512.

    noteObservação
    Por motivos de segurança, convém usar um algoritmo SHA em vez de um MD5.

    Enviar MDN assíncrona

    Escolha essa opção para enviar um recibo MDN assíncrono ao Parceiro Convidado. Insira a URL do ponto de extremidade em que o Parceiro Convidado recebe MDNs.

    Para obter informações sobre como importar certificados no computador, consulte APÊNDICE: Visão geral de certificados dos Serviços BizTalk.

As configurações de envio AS2 incluem principalmente detalhes de protocolo, como assinatura, criptografia e compactação de mensagem, bem como a solicitação de uma MDN.

  1. Selecione a guia Configurações de Envio da página do contrato AS2. Escolha as configurações de mensagens a serem usadas com este contrato. Essas configurações são usadas para enviar mensagens AS2 do parceiro hospedado ao parceiro convidado:

     

    Habilitar a assinatura de mensagens

    Essa opção assina as mensagens enviadas do parceiro hospedado para o parceiro convidado.

    O Parceiro Hospedado tem um Certificado Particular (.pfx) usado para assinaturas carregadas no perfil do Parceiro Hospedado. Você cria o certificado público correspondente (.cer) e envia esse certificado ao Parceiro Convidado. Essa chave pública valida a assinatura do Parceiro Hospedado para o Parceiro Convidado.

    Opções do algoritmo MIC:

    • MD5

    • SHA1 (padrão)

    • SHA2-256

    • SHA2-384

    • SHA2-512

    noteObservação
    Por motivos de segurança, convém usar um algoritmo SHA em vez de um MD5.

    Certificado: Na lista suspensa, escolha o certificado particular (.pfx) do Parceiro Hospedado que você adicionou ao perfil do Parceiro Hospedado. As mensagens de saída enviadas ao Parceiro Convidado são assinadas com o certificado de assinatura do Parceiro Hospedado.

    Habilitar criptografia de mensagens

    Essa opção é usada pelo Parceiro Hospedado para criptografar mensagens AS2 usando o certificado público (.cer) do Parceiro Convidado.

    Seu Parceiro Convidado tem um certificado particular (.pfx). O Parceiro Convidado cria o certificado público (.cer) correspondente e o envia a você, o Provedor de Serviços. Esse certificado de chave pública (.cer) é carregado por você no perfil do Parceiro Convidado. O certificado público do Parceiro Hospedado criptografa a mensagem e o certificado particular correspondente do Parceiro Convidado descriptografa a mensagem.

    Opções de algoritmo de criptografia:

    • AES-128

    • AES-192

    • AES-256

    • DES3 (padrão)

    • RC2

    noteObservação
    Por motivos de segurança, convém usar um algoritmo AES ou DES em vez de um RC2.

    Certificado: Na lista suspensa, escolha o certificado público (.cer) do Parceiro Convidado que você adicionou ao perfil do Parceiro Convidado. As mensagens de saída são criptografadas com o certificado de chave pública do perfil do Parceiro Convidado.

    Habilitar compactação de mensagens

    Escolha essa opção para compactar mensagens enviadas pelo Parceiro Hospedado ao Parceiro Convidado.

    Desdobrar cabeçalhos HTTP

    Marque essa caixa de seleção pata desdobrar cabeçalhos com conteúdo HTTP em uma única linha.

    Para obter informações sobre como importar certificados no computador, consulte APÊNDICE: Visão geral de certificados dos Serviços BizTalk.

  2. Escolha as configurações de confirmação que você deseja usar com esse contrato ou modelo. Essas configurações especificam que o Parceiro Hospedado solicita uma mensagem de confirmação do Parceiro Convidado no contrato. As mensagens de confirmação do Parceiro Convidado são enviadas ao Parceiro Hospedado com base na URL do URI de Entrada definida em Configurações de Recebimento no contrato.

     

    Solicitar MDN

    Essa configuração faz com que o contrato envie recibos MDN ao remetente da mensagem AS2 original, que é o Parceiro Hospedado. Confirmações são enviadas ao Parceiro Hospedado após a entrega da mensagem AS2.

    As seguintes opções estão disponíveis quando o Parceiro Hospedado solicita uma MDN:

     

    Solicitar MDN assinada

    Essa opção solicita que um recibo MDN seja assinado com a chave privada do Parceiro Convidado. A assinatura é validada com o certificado de chave pública do Parceiro Convidado que é carregado no perfil do Parceiro Convidado.

    Solicitar MDN assíncrono

    Essa opção solicita que os recibos MDN sejam enviados assincronamente ao remetente da mensagem AS2 original, que é o Parceiro Hospedado. A mensagem assíncrona é enviada à URL do URI de Entrada do Parceiro Hospedado. Essa URL do URI de Entrada é definida em Configurações de Recebimento no contrato.

  3. Selecione Salvar para salvar o contrato.

  • O Portal de Serviços do BizTalk permite que você modifique o Qualificador de uma identidade, quando um contrato for configurado. Isso pode resultar em propriedades inconsistentes. Por exemplo, há um contrato com ZZ:1234567 e ZZ:7654321, o Qualificador. Nas configurações de perfil do Portal de Serviços do BizTalk, altere ZZ:1234567 para 01:ChangedValue. Abra o contrato e 01:ChangedValue será exibido em vez de ZZ:1234567.

    Para modificar o Qualificador de uma identidade, exclua o contrato, atualize as Identidades no perfil de parceiro e, em seguida, recrie o contrato.

    WarningAviso
    Esse comportamento afeta o X12 e o AS2.

  • Os anexos de mensagens AS2 não são suportados no envio nem na recepção. Especificamente, os anexos são silenciosamente ignorados e o corpo da mensagem é processado como uma mensagem regular AS2.

Consulte também

Mostrar: