Personalize cabeçalhos HTTP para mensagens AS2 - AWS Transfer Family
Visão geral do modeloComo funcionaRecursos principaisDetalhes da implantaçãoImplantação e uso

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á.

Personalize cabeçalhos HTTP para mensagens AS2

Ao enviar AS2 mensagens para parceiros comerciais, talvez seja necessário personalizar os cabeçalhos HTTP para atender a requisitos específicos ou aprimorar a compatibilidade com a configuração do AS2 servidor do seu parceiro. Esse CloudFormation modelo cria uma infraestrutura para habilitar cabeçalhos HTTP personalizados para AS2 mensagens enviadas AWS Transfer Family. Ele configura um Amazon API Gateway e uma função Lambda para atuar como proxy, permitindo a modificação dinâmica dos cabeçalhos exigidos pelos servidores dos parceiros comerciais. AS2

Use esse modelo para fazer o seguinte:

  • Adicione cabeçalhos HTTP personalizados às mensagens enviadas AS2

  • Substituir valores de cabeçalho padrão por valores personalizados

    Importante

    Tenha cuidado ao substituir os valores de cabeçalho padrão, pois isso pode causar falhas no envio: alguns AS2 cabeçalhos são necessários.

  • Garanta a compatibilidade com parceiros comerciais que tenham requisitos específicos de cabeçalho

Visão geral do modelo

O modelo cria os seguintes componentes principais:

  • Uma função Lambda que processa e encaminha mensagens AS2

  • Um Amazon API Gateway para expor a função Lambda

  • Funções e permissões do IAM para a função Lambda

  • Recursos condicionais para suporte a HTTPS

O arquivo de modelo está disponível aqui: Modelo de cabeçalhos HTTP dinâmicos.

Como funciona

  1. O Amazon API Gateway recebe AS2 mensagens de AWS Transfer Family.

  2. A solicitação é encaminhada para a função Lambda.

  3. A função Lambda processa a solicitação, adicionando ou modificando cabeçalhos conforme necessário.

  4. A solicitação modificada é então encaminhada para o AS2 servidor do parceiro.

  5. A resposta do servidor do parceiro é retornada por meio do Lambda e do Amazon API Gateway para. AWS Transfer Family

Recursos principais

  • Modificação dinâmica do cabeçalho: permite a personalização do cabeçalho do assunto e a adição de outros cabeçalhos necessários.

  • Protocol Support: funciona com os protocolos HTTP e HTTPS.

  • Configuração flexível: permite a especificação do host, porta e caminho do parceiro.

Detalhes da implantação

O modelo implementa os seguintes componentes principais:

Função do Lambda

O núcleo da solução é uma função Lambda Node.js que:

  • Recebe solicitações do Amazon API Gateway

  • Modifica os cabeçalhos com base na configuração e nos dados da solicitação recebida

  • Encaminha a solicitação modificada para o servidor do AS2 parceiro

  • Lida com os protocolos HTTP e HTTPS

  • Inclui tratamento e registro de erros

Amazon API Gateway

Uma API HTTP está configurada para:

  • Receba mensagens recebidas AS2

  • Encaminhe solicitações para a função Lambda

  • Retorne as respostas para AWS Transfer Family

Parâmetros do modelo

Insira as informações para os parâmetros do modelo da seguinte forma. Observe que todos esses parâmetros são cadeias de caracteres.

  • Environment: esse parâmetro é usado para nomear os recursos que o modelo cria: se eles são destinados a um ambiente de desenvolvimento ou produção. Os valores válidos são dev e prod.

  • PartnerHost: o endereço IP ou nome do host do servidor AS2 parceiro.

  • PartnerPort: o número da porta do servidor AS2 parceiro. Se não for especificado, o padrão é 80 para HTTP e 443 para HTTPS.

  • PartnerPath: o caminho para o AS2 endpoint no servidor parceiro

  • ProtocolType: o protocolo a ser usado para a AS2 comunicação: os valores válidos são HTTP e HTTPS.

Recursos condicionais

Para suporte a HTTPS, o modelo cria condicionalmente:

  • Uma camada Lambda para certificados CA

  • Configuração específica de HTTPS na função Lambda

Implantação e uso

Para personalizar cabeçalhos AS2 HTTP usando um modelo CloudFormation

  1. Abra o CloudFormation console em https://console.aws.amazon.com/cloudformation.

  2. No painel de navegação à esquerda, selecionePilhas.

  3. Selecione Criar pilha e, depois, Com novos recursos (padrão).

  4. Na seção Pré-requisito - Preparar modelo, escolha Escolher um modelo existente.

  5. Copie esse link, modelo de cabeçalhos HTTP dinâmicos, e cole-o no campo URL do Amazon S3.

  6. Escolha Próximo.

  7. Preencha os detalhes do parâmetro com suas informações. Eles estão detalhados emParâmetros do modelo.

  8. Escolha Próximo. Na página Configurar opções de pilha, selecione Próximo novamente.

  9. Revise os detalhes da pilha que você está criando e escolha Criar pilha.

    nota

    Na parte inferior da página, em Capacidades, você deve reconhecer que isso CloudFormation pode criar recursos AWS Identity and Access Management (IAM).

Depois de implantar essa CloudFormation pilha:

  1. Observe a URL do endpoint do Amazon API Gateway fornecida nas saídas da pilha.

  2. Atualize seu AWS Transfer Family conector existente para usar esse novo endpoint do Amazon API Gateway.

  3. A solução agora manipulará AS2 mensagens, adicionando ou modificando cabeçalhos conforme configurado.

Atenção

Modifique apenas o cabeçalho do assunto ou adicione cabeçalhos que seu parceiro espera explicitamente. Alterar outros cabeçalhos pode causar falhas na transferência.