As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Enviando e recebendo mensagens AS2

Esta seção descreve os processos para enviar e receber mensagens AS2. Ele também fornece detalhes sobre nomes de arquivos e locais associados às mensagens AS2.

A tabela a seguir lista os algoritmos de criptografia disponíveis para mensagens AS2 e quando você pode usá-los.

Processo de recebimento de mensagens AS2

O processo de entrada é definido como uma mensagem ou arquivo que está sendo transferido para o seu AWS Transfer Family servidor. A sequência das mensagens de entrada é a seguinte:

Enviando e recebendo mensagens AS2 por HTTPS

Esta seção descreve como configurar um servidor Transfer Family que usa o protocolo AS2 para enviar e receber mensagens por HTTPS.

Envie mensagens AS2 por HTTPS

Para enviar mensagens AS2 usando HTTPS, crie um conector com as seguintes informações:

Receba mensagens AS2 por HTTPS

AWS Transfer Family Atualmente, os servidores AS2 fornecem apenas transporte HTTP pela porta 5080. No entanto, você pode encerrar o TLS em um balanceador de carga de rede ou aplicativo na frente do endpoint VPC do servidor Transfer Family usando uma porta e um certificado de sua escolha. Com essa abordagem, você pode fazer com que as mensagens AS2 recebidas usem HTTPS.

Pré-requisitos

Você pode configurar um Network Load Balance (NLB) ou um Application Load Balancer (ALB). A tabela a seguir lista os prós e os contras de cada abordagem.

A tabela abaixo fornece as diferenças nos recursos quando você usa um NLB versus um ALB para encerrar o TLS.

Configure NLB

Este procedimento descreve como configurar um Network Load Balancer (NLB) voltado para a Internet em sua VPC.

Para criar um Network Load Balancer e definir o endpoint da VPC do servidor como o destino do balanceador de carga

1. Abra o console do Amazon Elastic Compute Cloud em https://console.aws.amazon.com/ec2/.

2. No painel de navegação, escolha Balanceadores de carga e, em seguida, escolha Criar balanceador de carga.

3. Em Network Load Balancer, escolha Criar.

4. Na seção Configurações básicas, insira as seguintes informações:

   • Em Nome, insira um nome descritivo para o balanceador de carga.

   • Para Esquema, escolha Internet-facing.

   • Em Tipo de endereço IP, selecione IPv4.

5. Na seção Mapeamento de rede, insira as seguintes informações:

   • Em VPC, escolha a nuvem privada virtual (VPC) que você criou.

   • Em Mapeamentos, escolha as zonas de disponibilidade associadas às sub-redes públicas que estão disponíveis na mesma VPC que você usa com os endpoints do servidor.

   • Para o endereço IPv4 de cada sub-rede, escolha um dos endereços IP elásticos alocados.

6. Na seção Receptores e roteamento, insira as seguintes informações:

   • Para Protocolos, escolha TLS.

   • Em Porta, insira 5080.

   • Em Ação padrão, escolha Criar grupo de destino. Para obter detalhes sobre a criação de um novo grupo-alvo, consulte Para criar um grupo de destino.

   Depois de criar um grupo-alvo, insira seu nome no campo Ação padrão.

7. Na seção Configurações do ouvinte seguro, escolha seu certificado na área SSL/TLS Certificado padrão.

8. Escolha Criar balanceador de carga para criar seu NLB.

9. (Opcional, mas recomendado) Ative os logs de acesso do Network Load Balancer para manter uma trilha de auditoria completa, conforme descrito em Logs de acesso do Network Load Balancer.

   Recomendamos esta etapa porque a conexão TLS é encerrada no NLB. Portanto, o endereço IP de origem refletido nos grupos de CloudWatch log AS2 do Transfer Family é o endereço IP privado do NLB, em vez do endereço IP externo do seu parceiro comercial.

Configure ALB

Este procedimento descreve como configurar um Application Load Balancer (ALB) em sua VPC.

Para criar um Application Load Balancer e definir o VPC endpoint do servidor como destino do balanceador de carga

1. Abra o console do Amazon Elastic Compute Cloud em https://console.aws.amazon.com/ec2/.

2. No painel de navegação, escolha Balanceadores de carga e, em seguida, escolha Criar balanceador de carga.

3. Em Application Load Balancer, escolha Create (Criar).

4. No console do ALB, crie um novo ouvinte HTTP na porta 443 (HTTPS).

5. (Opcional). Se você quiser configurar a autenticação mútua (mTLS), defina as configurações de segurança e um armazenamento confiável.

   1. Anexe seu SSL/TLS certificado ao ouvinte.

   2. Em Tratamento de certificados do cliente, selecione Autenticação mútua (mTLS).

   3. Escolha Verificar com um repositório confiável.

   4. Em Configurações avançadas do mTLS, escolha ou crie um repositório confiável fazendo o upload de seus certificados CA.

6. Crie um novo grupo-alvo e adicione os endereços IP privados dos endpoints do servidor Transfer Family AS2 como destinos na porta 5080. Para obter detalhes sobre a criação de um novo grupo-alvo, consulte Para criar um grupo de destino.

7. Configure verificações de saúde para que o grupo-alvo use o protocolo HTTP na porta 5080.

8. Crie uma nova regra para encaminhar o tráfego HTTPS do ouvinte para o grupo-alvo.

9. Configure o ouvinte para usar seu SSL/TLS certificado.

Depois de configurar o balanceador de carga, os clientes se comunicam com o balanceador de carga por meio do receptor de porta personalizado. Em seguida, o balanceador de carga se comunica com o servidor pela porta 5080.

Teste o acesso ao servidor a partir de um endereço IP elástico

Conecte-se ao servidor pela porta personalizada usando um endereço IP elástico ou o nome DNS do Network Load Balancer.

Transferindo arquivos usando um conector AS2

Os conectores AS2 estabelecem um relacionamento entre parceiros comerciais para transferências de mensagens AS2 de um servidor Transfer Family para um destino externo de propriedade do parceiro.

Você pode usar o Transfer Family para enviar mensagens AS2 referenciando o ID do conector e os caminhos para os arquivos, conforme ilustrado no seguinte comando start-file-transfer AWS Command Line Interface ()AWS CLI:

aws transfer start-file-transfer --connector-id c-1234567890abcdef0 \
--send-file-paths "/amzn-s3-demo-source-bucket/myfile1.txt" "/amzn-s3-demo-source-bucket/myfile2.txt"

Para obter detalhes dos conectores, execute o seguinte comando:

aws transfer list-connectors

O comando list-connectors retorna os IDs do conector, os URLs e nomes do recurso da Amazon (ARNs) dos seus conectores.

Para retornar as propriedades de um conector específico, execute o comando a seguir com o ID que você deseja usar:

aws transfer describe-connector --connector-id your-connector-id

O comando describe-connector retorna todas as propriedades do conector, incluindo URL, funções, perfis, avisos de disposição de mensagens (MDNs), tags e métricas de monitoramento.

Você pode confirmar que o parceiro recebeu os arquivos com êxito visualizando os arquivos JSON e MDN. Esses arquivos são nomeados de acordo com as convenções descritas em Nomes e localizações dos arquivos. Se você configurou uma função de registro ao criar o conector, também poderá verificar seus CloudWatch registros quanto ao status das mensagens AS2.

Para ver os detalhes do conector AS2, consulte Exibir detalhes do conector AS2. Para obter mais informações sobre como criar conectores AS2, consulte Configurar conectores AS2.

O processamento AS2 suporta muitos dos protocolos RFC 4130, com foco em casos de uso comuns e integração com implementações de servidores existentes AS2-enabled . Para obter detalhes sobre as configurações suportadas, consulte Configurações AS2.

Nomes e localizações dos arquivos

Esta seção discute as convenções de nomenclatura de arquivos para transferências AS2.

Para Transferência de Arquivos de entrada, observe o seguinte:

Para transferências de saída, a nomenclatura é semelhante, com a diferença de que não há arquivo de mensagem de entrada e, além disso, a ID de transferência da mensagem transferida é adicionada ao nome do arquivo. O ID de transferência é retornado pela operação API StartFileTransfer (ou quando outro processo ou script chama essa operação).

Você também pode verificar os CloudWatch registros para ver os detalhes de suas transferências, incluindo as que falharam.

Códigos de status

A tabela a seguir lista todos os códigos de status que podem ser registrados nos CloudWatch registros quando você ou seu parceiro enviam uma mensagem AS2. Diferentes etapas de processamento de mensagens se aplicam a diferentes tipos de mensagens e são destinadas somente ao monitoramento. Os estados COMPLETED e FAILED representam a etapa final do processamento e são visíveis nos arquivos JSON.

Arquivos JSON de amostra

Esta seção lista exemplos de arquivos JSON para transferências de entrada e saída, incluindo arquivos de amostra para transferências bem-sucedidas e transferências que falham.

Exemplo de arquivo de saída que foi transferido com sucesso:

{
  "requester-content-type": "application/octet-stream",
  "message-subject": "File xyzTest from MyCompany_OID to partner YourCompany",
  "requester-file-name": "TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-from": "MyCompany_OID",
  "connector-id": "c-c21c63ceaaf34d99b",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 3198,
  "mdn-message-id": "OPENAS2-11072022063009+0000-df865189-1450-435b-9b8d-d8bc0cee97fd@PartnerA_OID_MyCompany_OID",
  "mdn-subject": "Message be18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa has been accepted",
  "as2-to": "PartnerA_OID",
  "transfer-id": "dedf4601-4e90-4043-b16b-579af35e0d83",
  "file-path": "/amzn-s3-demo-bucket/as2testcell0000/openAs2/TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-message-id": "fbe18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa",
  "timestamp": "2022-07-11T06:30:10.791274Z"
}

Exemplo de arquivo de saída que foi transferido sem sucesso:

{
  "failure-code": "HTTP_ERROR_RESPONSE_FROM_PARTNER",
  "status-code": "FAILED",
  "requester-content-type": "application/octet-stream",
  "subject": "Test run from Id da86e74d6e57464aae1a55b8596bad0a to partner 9f8474d7714e476e8a46ce8c93a48c6c",
  "transfer-size": 3198,
  "requester-file-name": "openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "as2-message-id": "9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "failure-message": "http://Test123456789.us-east-1.elb.amazonaws.com:10080 returned status 500 for message with ID 9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "transfer-id": "07bd3e07-a652-4cc6-9412-73ffdb97ab92",
  "connector-id": "c-056e15cc851f4b2e9",
  "file-path": "/amzn-s3-demo-bucket-4c1tq6ohjt9y/as2IntegCell0002/openAs2/openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "timestamp": "2022-07-11T21:17:24.802378Z"
}

Exemplo de arquivo de entrada que foi transferido com sucesso:

{
  "requester-content-type": "application/EDI-X12",
  "subject": "File openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat sent from MyCompany to PartnerA",
  "client-ip": "10.0.109.105",
  "requester-file-name": "openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat",
  "as2-from": "MyCompany_OID",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 1050,
  "mdn-subject": "Message Disposition Notification",
  "as2-message-id": "OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID",
  "as2-to": "PartnerA_OID",
  "agreement-id": "a-f5c5cbea5f7741988",
  "file-path": "processed/openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID.dat",
  "server-id": "s-5f7422b04c2447ef9",
  "timestamp": "2022-07-11T23:36:36.105030Z"
}

Exemplo de arquivo de entrada que foi transferido sem sucesso:

{
  "failure-code": "INVALID_REQUEST",
  "status-code": "FAILED",
  "subject": "Sending a request from InboundHttpClientTests",
  "client-ip": "10.0.117.27",
  "as2-message-id": "testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "as2-to": "0beff6af56c548f28b0e78841dce44f9",
  "failure-message": "Unsupported date format: 2022/123/456T",
  "agreement-id": "a-0ceec8ca0a3348d6a",
  "as2-from": "ab91a398aed0422d9dd1362710213880",
  "file-path": "failed/01187f15-523c-43ac-9fd6-51b5ad2b08f3.testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "server-id": "s-0582af12e44540b9b",
  "timestamp": "2022-07-11T06:30:03.662939Z"
}