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 AS2 mensagens

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

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

Processo de recebimento de AS2 mensagens

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 AS2 mensagens por HTTPS

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

Envie AS2 mensagens por HTTPS

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

Receba AS2 mensagens por HTTPS

AWS Transfer Family AS2 atualmente, os servidores 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 AS2 mensagens 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 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 Voltado para a internet.

   • Em IP address type (Tipo de endereço IP), escolha 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 IPv4 endereço de cada sub-rede, escolha um dos endereços IP elásticos que você alocou.

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 AS2 CloudWatch registros 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 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 loja 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 AS2 servidor Transfer Family 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 certificado SSL/TLS.

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

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

Você pode usar o Transfer Family para enviar AS2 mensagens fazendo referência ao ID do conector e aos 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 list-connectors comando retorna o conector e IDs URLs os Amazon Resource Names (ARNs) para 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 describe-connector comando 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 o status das AS2 mensagens em seus CloudWatch registros.

Para ver os detalhes do AS2 conector, consulteExibir detalhes AS2 do conector. Para obter mais informações sobre a criação de AS2 conectores, consulteConfigurar AS2 conectores.

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

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 CloudWatch nos registros quando você ou seu parceiro enviam uma AS2 mensagem. 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"
}