Isente um header de requisição

Nomeie um único header em uma exceção do WAF pela API, e evite o formato de condition que silenciosamente cobre todos os headers.

Última atualização

Ver como Markdown Configurar agente

Você pode criar uma exceção do WAF que nomeia um único header de requisição pela API. A exceção abaixo impede que a regra 1005, a regra do caractere pipe, dispare no header Cookie, e a deixa disparando no corpo, no path e na query string.

Pré-requisitos

  • O rule set que bloqueou a requisição, como storefront-waf.
  • Um personal token.

Crie a exceção

Envie uma requisição POST para o endpoint de exceptions do rule set, com specific_http_header_name como valor de match:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/wafs/<waf-id>/exceptions \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "rule_id": 1005,
08 "name": "Allow the session cookie on the storefront",
09 "path": "/",
10 "operator": "contains",
11 "active": true,
12 "conditions": [
13 { "match": "specific_http_header_name", "name": "cookie" }
14 ]
15}
JSON
01{
02 "state": "pending",
03 "data": {
04 "id": 123465,
05 "rule_id": 1005,
06 "name": "Allow the session cookie on the storefront",
07 "path": "/",
08 "conditions": [
09 { "match": "specific_http_header_name", "name": "cookie" }
10 ],
11 "operator": "contains",
12 "active": true,
13 "last_editor": "user@example.com",
14 "last_modified": "2026-01-01T12:00:00.000000Z"
15 }
16}

A API responde 202 e ecoa a exceção sob data, com a chave name da condition intacta. A Azion CLI envia o mesmo corpo a partir de um arquivo com azion create waf-exceptions --waf-id <waf-id> --file exception.json.

nota — Uma condition carrega apenas as chaves que o seu próprio formato declara, e uma chave que o formato não declara é descartada em vez de recusada. Enviar {"match": "any_http_header_value", "name": "cookie"} responde 202 e é lido de volta como {"match": "any_http_header_value"}: a exceção agora cobre todos os headers, e nenhuma resposta, releitura ou tela reporta a diferença. Leia a condition armazenada depois de criar uma. A API também armazena o nome do header exatamente como enviado, então cookie, Cookie e HTTP_COOKIE são mantidos como escritos.

Para a chave que cada um dos quinze valores de match carrega, consulte WAF Exceptions.

Próximos passos

Isente um parâmetro de query stringO mesmo formato para um argumento de query string nomeado, com os procedimentos do Console e da CLI.WAF ExceptionsTodos os quinze valores de match, e a chave que cada um carrega.