Functions em um firewall

Exemplo de uso geral para funções executadas no firewall, combinando várias ações de tratamento de requisição em um único handler. Use-o como ponto de partida quando precisar inspecionar headers e metadados de entrada e então decidir se vai bloquear, descartar, modificar ou responder a uma requisição diretamente na rede global da Azion. O código de exemplo demonstra as seguintes capacidades:

event.deny()
event.drop()
event.addRequestHeader()
event.addResponseHeader()
event.respondWith()
event.continue()

JavaScript

01 async function firewallHandler(event) {

02 // Access the value of x-deny, one of the headers

03 let condition = event.request.headers.get("x-deny");

05 if (condition) {

06 // event.deny() triggers a default 403 Response

07 event.deny();

08 }

10 let anotherCondition = event.request.headers.get("x-drop"); // Access the value of x-drop, , one of the headers

11 if (anotherCondition) {

12 // event.drop() drops the connection without returning a Response

13 event.drop();

14 }

16 // Access the value of x-third, one of the headers

17 let aThirdCondition = event.request.headers.get("x-third");

18 if (aThirdCondition) {

19 // event.addRequestHeader() adds a new header to the Request object, passing key:"value".

20 event.addRequestHeader("X-New-Request-Header", "Hello");

21 }

23 // Access the value of x-fourth, one of the headers

24 let aFourthCondition = event.request.headers.get("x-fourth");

25 if (aFourthCondition) {

26 // event.addResponseHeader() adds a new header to the Response object

27 // that will be delivered after accessing the origin.

28 event.addResponseHeader("X-New-Response-Header", "Bye");

29 }

31 // The metadata object contains the attributes of the request

32 if (event.request.metadata["remote_addr"] == "127.0.0.1") {

33 // event.respondWith(new Response()) allows you to serve your own Response

34 event.respondWith(new Response('{"my_custom_response": true}', {

35 status: 599,

36 headers: { "content-type": "application/json" }

37 }));

38 }

40 // If the request was not denied or dropped and did not have a Response returned,

41 // it is necessary to continue the processing, and to do so use use -> event.continue()

42 // Do not forget this command, otherwise the request won't continue!

43 event.continue();

44 }

46 addEventListener("firewall", (event) => event.waitUntil(firewallHandler(event)));

Como funciona

Este código é executado como um handler de firewall, ou seja, dentro de um firewall e não no caminho da requisição da aplicação. Ele registra o handler com addEventListener("firewall", ...) e executa o trabalho assíncrono dentro de event.waitUntil(). Consulte Functions no Firewall para conhecer o conjunto completo de ações que um handler de firewall pode chamar.

O handler lê vários headers da requisição com event.request.headers.get() para orientar suas decisões. Dependendo de qual header está presente, ele pode chamar event.deny() para retornar um 403, event.drop() para encerrar a conexão sem resposta, ou event.addRequestHeader() e event.addResponseHeader() para injetar headers personalizados. Ele também inspeciona event.request.metadata["remote_addr"] e pode interromper o fluxo com event.respondWith(new Response(...)) para servir um corpo JSON próprio. Ele termina com event.continue(), de modo que qualquer requisição ainda não tratada prossiga normalmente.

Recursos relacionados

Exemplos em JavaScript

Consulte os outros padrões de sintaxe da coleção.

Functions no Firewall

Leia a referência de todas as ações que um handler de firewall pode chamar.

API de metadados

Consulte os campos de metadados da requisição, incluindo remote_addr.

Functions Instances para Firewall

Veja como uma função é instanciada em um firewall e acionada por uma regra.

Limites para funções em um firewall

Os limites que uma função de firewall compartilha com toda função, e onde ficam os limites do próprio firewall.