Como instalar a integração Limit Payload Size através do Marketplace da Azion

Limite Payload Size é uma integração serverless disponível no Marketplace da Azion. Esta integração emprega uma edge function para avaliar os dados de uma request e negar payloads que excedam o limite pré-definido.

A função valida o tamanho do payload da request, verificando o cabeçalho Content-Length. O cabeçalho Content-Length é necessário para tornar segura a sua leitura, ao invés de sempre ler o body da request. Desta maneira, os usuários estão protegidos contra tentativas de alterar o valor do cabeçalho e a leitura do Content-Length é o melhor curso de ação do ponto de vista de desempenho.

Obtenha a integração

Para instalar a integração, siga estes passos:

  1. Acesse o Azion Console > Marketplace.
  2. Na homepage do Marketplace, selecione o card da Limit Payload Size.
  3. Quando a página da integração abrir, clique no botão Install.

Aparecerá uma mensagem indicando que sua integração foi instalada com sucesso.

Configure a integração

Esta é uma integração de edge firewall, portanto, você terá que instanciar a integração na página do Edge Firewall. Siga os passos abaixo para fazer isso.

Crie uma regra do Edge Firewall

Para instanciar a integração Limit Payload Size, siga os passos:

  1. No Azion Console, em Products menu, selecione Edge Firewall na seção SECURE.
  2. Clique no botão + Edge Firewall.
  3. Dê um nome fácil de lembrar para seu edge firewall.
  4. Selecione os domínios que você deseja proteger com a função.
  5. Habilite o switch Edge Functions.
  6. Clique no botão Save.

Pronto. Agora você instanciou um edge firewall para sua função.

Configure a integração

Para terminar de instanciar a integração, ainda na página do Edge Firewall:

  1. Selecione a aba Functions Instances e siga estes passos:
  2. Clique no botão + Function Instance.
  3. Dê um nome fácil de lembrar para a sua instância.
  4. No menu suspenso, selecione a função Limit Payload Size.
  • Esta ação irá carregar a aba Arguments.
  1. Na aba Arguments, você passará os parámetros.

Nesta integração você passará somente um argumento em Arguments:

{ "max_payload_length": "10kb"
}

Algumas informações sobre como esta integração funciona:

  • O max_payload_length é o tamanho máximo do payload que sua função aceitará.
  • Este campo aceita bytes, kilobytes e megabytes como argumento.
  • Se você não especificar a unidade de tamanho para o payload, a função assumirá como sendo em bytes.
  • Se você não passar nenhum argumento, a função irá ignorar a execução.
  • Sempre que o tamanho do payload exceder o limite estabelecido pelo usuário, a integração retornará um erro 403.
  1. Clique no botão Save.

Configure o Rules Engine

Para terminar o processo, é preciso configurar o Rules Engine indicando o behavior e o criteria necessários para executar a integração.

Ainda na página do Edge Firewall:

  1. Selecione a aba Rules Engine.
  2. Clique no botão + Rule Engine.
  3. Dê um nome fácil de lembrar para sua regra.
  4. Selecione o criteria que deseja usar para a execução e o domínio no qual você deseja rodar a integração.
  5. Abaixo, selecione um behavior para este criteria. Neste caso, será Run Function.
  6. Em seguida, selecione a função Limite Payload Size, de acordo com o nome que você deu no passo de instanciação.
  7. Clique no botão Save.

Pronto. Agora a integração está sendo executada para cada request feita ao domínio que você indicou.

Contribuidores