• Boas-vindas a Azion Docs
• Guias
• Como instalar a solution Limit Payload Size através do Marketplace da Azion

Como instalar a solution Limit Payload Size através do Marketplace da Azion

Visão geral

A solution Limite Payload Size é uma solution serverless disponível no Marketplace da Azion. Esta solution 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.

1. Obtendo a solution
2. Usando a solution
   2.1 Criando uma regra dentro do Edge Firewall
   2.2 Configurando a solution
3. Configurando o Rules Engine

1. Obtendo a solution

Para instalar a solution, siga estes passos:

1. Entre na sua conta do Real-Time Manager (RTM).
   • Se você não tiver uma, você pode criar sua conta aqui.
2. No canto superior esquerdo da página, selecione Products menu > Marketplace.
3. Selecione a caixa de busca e digite “payload” ou navegue pelos cards para encontrar a solution Limit Payload Size.
4. Uma vez encontrado o card da solution, selecione-o para ser redirecionado para a página da solution.
5. Na página da solution, procure a seção Subscribe for no canto inferior direito.
6. Clique no botão Get It Now.

Após clicar no botão Get it now, você verá uma mensagem indicando que sua solution foi instalada com sucesso e está pronta para ser usada.

2. Usando a solution

2.1 Criando uma regra do Edge Firewall

Para instanciar a solution Limit Payload Size, siga os passos:

1. No RTM, em Products menu, selecione Edge Firewall na seção SECURE.
2. Clique no botão Add Rule Set.
3. Dê um nome fácil de lembrar para sua nova regra.
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 uma regra para sua função.

2.2 Configurando a solution

Para terminar de instanciar a solution, ainda na página Edge Firewall, selecione a guia Functions e siga estes passos:

1. Clique no botão Add Function.
2. Dê um nome fácil de lembrar para a sua instância.
3. No menu suspenso, selecione a função Limit Payload Size.

Esta ação irá carregar a função, mostrando um formulário com o código-fonte dela e, logo acima dele, duas abas: Code e Args. Ao clicar na aba Code, você poderá navegar pelo código, mas não poderá modificá-lo.

Nesta solution você passará somente um argumento em Args:

{
    "max_payload_length": "10kb"
}

Algumas informações sobre como esta solution 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 solution retornará um erro 403.

3. Configurando o Rules Engine

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

Ainda na página do Edge Firewall, selecione a guia Rules Engine e siga estes passos:

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

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

Não encontrou o que procurava? Abra um ticket.