Como instanciar edge functions em seu edge firewall

1. Acesse o Azion Console > Edge Firewall.
2. Clique no edge firewall que você deseja configurar.
3. Na aba Main Settings, ative o switch do módulo Edge Functions para habilitar as funções.
4. Clique no botão Save.
5. Vá para a aba Functions Instances.
6. Clique em + Function Instance.
7. Nomeie sua instância de função. Por exemplo: Função de Recusar Geoip.
8. No menu suspenso Edge Functions, selecione a função que deseja usar. Neste exemplo, Função de Recusar Geoip.

• Se desejar, pode editar os Arguments.

9. Clique no botão Save.

A página de funções agora lista a instância recém-criada. No entanto, esta nova função ainda não está ativa em sua. Você precisa definir o que acionará a função.

Ainda na página do Edge Firewall:

1. Navegue até a aba Rules Engine.
2. Clique no botão + Rule.
3. Dê um nome para o seu conjunto de regras.
4. Na seção Criteria, selecione a variável Network.
5. Como operador de comparação, selecione matches.
6. Como argumento, selecione a network list do tipo Countries que deseja usar. Por exemplo: Países Bloqueados Geoip.
7. Na seção Behaviors, selecione Run Function na lista de comportamentos.
8. Selecione a função que deseja usar. Neste exemplo, Função de Recusar Geoip.
9. Clique no botão Save.

Quando sua aplicação receber uma requisição gerada de um dos países na lista de rede, a função em seu firewall recusará a requisição com base no Geo IP.

1. Execute a seguinte requisição PATCH no seu terminal, substituindo [VALOR DO TOKEN] pelo seu token pessoal e a variável <edge_firewall_id> pelo ID do seu edge firewall para ativar o módulo Edge Functions:

curl --location --request PATCH 'https://api.azionapi.net/edge_firewall/<edge_firewall_id>' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [VALOR DO TOKEN]' \
--header 'Content-Type: application/json' \
--data '{
    "edge_functions_enabled": true
}'

2. Você receberá uma resposta com o valor atualizado.
3. Execute a seguinte requisição GET para obter o edge_function_id da função Recusar Geoip:

curl --location 'https://api.azionapi.net/edge_functions' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [TOKEN VALUE]'

4. Você receberá uma resposta semelhante a esta:

{
  "count": 1,
  "total_pages": 1,
  "schema_version": 3,
  "links": {
    "previous": null,
    "next": null
  },
  "results": [
    {
      "id": 13426,
      "name": "Função de Recusar Geoip",
      "language": "javascript",
      "code": "async function firewallHandler(event){\n    // Access the country code through geoip\n    let countryCode = event.request.metadata[\"geoip_country_code\"]\n\n    // Do some logic here\n    // In this example, we are blocking access from Brazil\n    if (countryCode === \"BR\"){\n        event.deny();\n    }\n\n    // Then, if it comes from any other country,\n    // the processing continues\n    event.continue();\n}\n\naddEventListener(\"firewall\", (event)=>event.waitUntil(firewallHandler(event)));",
      "json_args": {
        "value": "hello_world"
      },
      "function_to_run": "",
      "initiator_type": "edge_firewall",
      "active": true,
      "last_editor": "user@email.com",
      "modified": "2023-11-14T20:09:48.657555Z",
      "is_proprietary_code": false,
      "reference_count": 1
    }
  ]
}

5. Copie o valor <edge_function_id>.
6. Execute a seguinte requisição POST, substituindo a variável <edge_firewall_id pelo ID do seu edge firewall e o valor <edge_function_id> pelo valor que você recebeu na resposta anterior:

curl --location 'https://api.azionapi.net/edge_firewall/<edge_firewall_id>/functions_instances' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [TOKEN VALUE]' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Recusar Geoip",
      "edge_function": <edge_function_id>,
      "json_args": {}
}'

7. Você receberá uma resposta semelhante a esta:

{
  "results": {
    "name": "Another function",
    "json_args": {},
    "edge_function": 13426,
    "last_modified": "2023-11-22T18:50:11.812819Z",
    "last_editor": "user@email.com",
    "id": 2806
  },
  "schema_version": 3
}

8. Execute a seguinte requisição GET para obter o id da network list Blocked Countries Geoip:

curl --location 'https://api.azionapi.net/network_lists' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [VALOR DO TOKEN]'

9. Você receberá uma resposta semelhante a esta:

{
  "count": 2,
  "total_pages": 1,
  "schema_version": 3,
  "links": {
    "previous": null,
    "next": null
  },
  "results": [
    {
      "id": 6217,
      "last_editor": "user@email.com",
      "last_modified": "2023-11-14T21:35:39.808175Z",
      "list_type": "countries",
      "name": "Negar Geoip",
      "country_list": [
        "Brasil"
      ],
      "ip_list": []
    }
  ]
}
}

10. Execute a seguinte requisição POST no seu terminal, substituindo [VALOR DO TOKEN] pelo seu personal token, a variável <edge_firewall_id> pelo ID do seu edge firewall, o valor <edge_function_instance_id> pelo ID da instância da função e o valor <network_list_id> pelo ID da network list:

curl --location 'https://api.azionapi.net/edge_firewall/<edge_firewall_id>/rules_engine' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [TOKEN VALUE]' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Create rule",
    "is_active": true,
    "behaviors": [
        {
            "name": "run_function",
            "argument": <edge_function_instance_id>
        }
    ],
    "criteria": [
        [
            {
                "variable": "network",
                "operator": "is_in_list",
                "conditional": "if",
                "argument": <network_list_id>
            }
        ]
    ]
}'

11. Você receberá uma resposta semelhante a esta, confirmando que sua função foi criada com sucesso:

{
  "results": {
    "name": "Create rule",
    "is_active": true,
    "behaviors": [
      {
        "name": "run_function",
        "argument": 2718
      }
    ],
    "criteria": [
      [
        {
          "variable": "network",
          "operator": "is_in_list",
          "conditional": "if",
          "argument": 6217
        }
      ]
    ],
    "last_modified": "2023-11-22T17:57:28.584143Z",
    "last_editor": "user@email.com",
    "id": 28370,
    "order": 1
  },
  "schema_version": 3
}

12. Aguarde alguns minutos para que as alterações se propaguem.

Quando sua aplicação receber uma requisição gerada de um dos países na network list, a função em seu firewall recusará a requisição com base no Geo IP.