• Guias
• Trabalhar Com Rules Engine

Implementar regras em seu edge firewall usando o Rules Engine permitirá que você determine as regras que ele deve executar em cenários específicos.

Este guia demonstra o processo de criação de uma regra com um exemplo prático de verificação da existência de um certificado e retorno de uma resposta personalizada quando não houver um. Esse comportamento é útil em cenários como ajustar suas políticas para cumprir os requisitos do BACEN.

Para criar uma regra:

1. No Azion Console, vá para Edge Firewall.
2. Selecione o edge firewall no qual deseja configurar a regra.
3. Clique na aba Rules Engine.
4. Clique no botão New Rule.
5. Dê um nome à sua regra e, opcionalmente, uma descrição.
6. Na seção Criteria, selecione a variável SSL Verification Status.
7. Como operador de comparação, selecione is equal.
8. Como argumento, selecione Missing Client Certificate.
9. Na seção Behaviors, selecione Set Custom Response.
10. Como argumentos:
    • Em Status Code, adicione 401.
    • Em Content Type, adicione o conteúdo e a descrição do cabeçalho. Exemplo: application/json.
    • Em Content Body, insira a mensagem que deseja apresentar aos usuários.
11. Clique no botão Save.

1. Execute a seguinte requisição POST para criar uma regra, substituindo [TOKEN VALUE] pelo seu personal token e a variável <edge_firewall_id> pelo valor do ID do edge firewall:

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": "SSL Verification",
    "is_active": true,
    "behaviors": [
        {
            "name": "set_custom_response",
            "status_code": 401,
            "content_type": "application/json",
            "content_body": "{}"
        }
    ],
    "criteria": [
        [
            {
                "variable": "ssl_verification_status",
                "operator": "is_equal",
                "conditional": "if",
                "argument": "MISSING_CLIENT_CERTIFICATE"
            }
        ]
    ]
}'

Veja a documentação da Azion API para saber mais sobre os objetos de criteria e behaviors.

2. Você receberá a seguinte resposta:

{
  "results": {
    "name": "SSL Verification",
    "is_active": true,
    "behaviors": [
      {
        "status_code": 401,
        "content_body": "{}",
        "name": "set_custom_response",
        "content_type": "application/json"
      }
    ],
    "criteria": [
      [
        {
          "variable": "ssl_verification_status",
          "operator": "is_equal",
          "conditional": "if",
          "argument": "MISSING_CLIENT_CERTIFICATE"
        }
      ]
    ],
    "last_modified": "2023-11-23T23:54:14.941097Z",
    "last_editor": "user@email.com",
    "id": 28414,
    "order": 2
  },
  "schema_version": 3
}

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

Contributors