Azion CLI waf

Os comandos waf da Azion CLI criam, listam, descrevem, atualizam e excluem rule sets do WAF. Um rule set guarda um limiar para cada ameaça que cobre, um nome de ameaça associado a uma sensibilidade, e a saída da CLI o chama de WAF. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.

Criar

azion create waf cria um rule set com o nome e as configurações que você informa:

azion create waf [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--active`	—	string	—	Ativa (`true`) ou desativa (`false`) o rule set.
`--engine-version`	—	string	—	Versão do motor do WAF. Um rule set criado sem ela recebe `2021-Q3`.
`--file`	—	string	—	Caminho de um arquivo JSON com os atributos do rule set. Use `-` para ler o JSON da entrada padrão.
`--name`	—	string	—	Nome do rule set.
`--product-version`	—	string	—	Versão de produto do rule set. Um rule set criado sem ela recebe `1.0`.
`--rulesets`	—	string	—	Lista, separada por vírgulas, dos IDs dos rulesets a ativar. Um rule set criado sem ela recebe `1`.
`--thresholds`	—	string	—	Lista de pares `threat=sensitivity` separados por vírgulas. Um rule set criado sem ela recebe as oito ameaças em `medium`.
`--type`	—	string	—	Tipo do motor do WAF. Um rule set criado sem ela recebe `score`.

As oito ameaças são cross_site_scripting, directory_traversal, evading_tricks, file_upload, identified_attack, remote_file_inclusion, sql_injection e unwanted_access. A sensibilidade aceita highest, high, medium, low ou lowest.

Este comando cria um rule set ativo chamado my-strict-waf, com sensibilidade highest para cross-site scripting e high para SQL injection:

azion create waf --name my-strict-waf --active true --engine-version 2021-Q3 --type score --rulesets 1 --thresholds 'cross_site_scripting=highest,sql_injection=high'

O comando imprime o ID do rule set:

Created WAF with ID 12348

O rule set guarda somente os limiares que você informa: azion describe waf --waf-id 12348 --format json lista cross_site_scripting em highest e sql_injection em high, e nenhuma outra ameaça.

Uma sensibilidade fora desses cinco valores é recusada:

Error: Invalid sensitivity value for threshold. Valid values: highest, high, medium, low, lowest

Listar

azion list waf lista os rule sets da sua conta, 50 por página:

azion list waf [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--details`	—	—	—	Adiciona as colunas `PRODUCT VERSION`, `LAST EDITOR` e `LAST MODIFIED` às colunas `ID`, `NAME` e `ACTIVE`.
`--filter`	—	string	—	Nome pelo qual filtrar a lista.
`--order-by`	—	string	—	Campo pelo qual ordenar a lista.
`--page`	—	int	`1`	Número da página a retornar.
`--page-size`	—	int	`50`	Número de rule sets em cada página.

Este comando lista os rule sets da conta:

azion list waf

O comando imprime uma linha por rule set:

Texto

01ID NAME ACTIVE

0212345 my-blog-waf true

0312346 my-store-waf true

0412347 my-waf true

0512348 my-strict-waf true

0612349 my-site-waf true

Descrever

azion describe waf imprime as configurações de um rule set:

azion describe waf [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--waf-id`	—	int	—	ID do rule set a descrever.

Este comando descreve o rule set com ID 12347, criado somente com --name e --active:

azion describe waf --waf-id 12347

O comando imprime o nome, o estado e as configurações do motor do rule set. As oito ameaças têm a sensibilidade padrão medium:

Texto

01ID: 12347

02Active: true

03Name: my-waf

04Last Editor: you@example.com

05Modified at: "2026-01-01T12:00:00.058811Z"

06Product Version: "1.0"

Engine Settings:   {"attributes":{"rulesets":[1],"thresholds":[{"sensitivity":"medium","threat":"cross_site_scripting"},{"sensitivity":"medium","threat":"directory_traversal"},{"sensitivity":"medium","threat":"evading_tricks"},{"sensitivity":"medium","threat":"file_upload"},{"sensitivity":"medium","threat":"identified_attack"},{"sensitivity":"medium","threat":"remote_file_inclusion"},{"sensitivity":"medium","threat":"sql_injection"},{"sensitivity":"medium","threat":"unwanted_access"}]},"engine_version":"2021-Q3","type":"score"}

Com --format json, o comando imprime o objeto completo: active, engine_settings, id, is_versioned, last_editor, last_modified, name, product_version, version, version_id e version_state. O objeto engine_settings guarda engine_version, type e um objeto attributes com os rulesets e os thresholds que as flags de criação e de atualização definem.

Um ID que não existe falha com este erro:

Error: Failed to get the WAF: The given ID or API's endpoint doesn't exist or isn't available. Check that the identifying information is correct. Check your settings and try again. If the error persists, contact Azion support

Atualizar

azion update waf altera o nome, o estado ativo ou as configurações do motor de um rule set:

azion update waf [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--active`	—	string	—	Ativa (`true`) ou desativa (`false`) o rule set.
`--engine-version`	—	string	—	Versão do motor do WAF.
`--file`	—	string	—	Caminho de um arquivo JSON com os atributos a alterar. Use `-` para ler o JSON da entrada padrão.
`--name`	—	string	—	Novo nome do rule set.
`--rulesets`	—	string	—	Lista, separada por vírgulas, dos IDs dos rulesets a ativar.
`--thresholds`	—	string	—	Lista de pares `threat=sensitivity` separados por vírgulas. Substitui a lista inteira de limiares.
`--type`	—	string	—	Tipo do motor do WAF.
`--waf-id`	—	int	—	Obrigatório, também com `--file`. ID do rule set a atualizar. Sem ela, o comando pergunta o ID.

Atenção — --thresholds substitui a lista inteira. Uma ameaça que você deixa fora do valor perde o seu limiar, então informe todas as ameaças que o rule set precisa manter.

Este comando renomeia o rule set com ID 12347 para my-waf-renamed e define SQL injection com sensibilidade lowest:

azion update waf --waf-id 12347 --name my-waf-renamed --thresholds 'sql_injection=lowest'

O comando imprime o ID do rule set atualizado:

Updated WAF with ID 12347

Depois dessa atualização, azion describe waf --waf-id 12347 --format json retorna um limiar, sql_injection em lowest. As outras sete ameaças saem do rule set.

Excluir

azion delete waf exclui um rule set:

azion delete waf [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--waf-id`	—	int	—	ID do rule set a excluir.

Este comando exclui o rule set com ID 12347:

azion delete waf --waf-id 12347

O comando confirma a exclusão:

WAF 12347 was successfully deleted

Usar um arquivo JSON

azion create waf e azion update waf leem os atributos do rule set de um arquivo JSON com --file.

Este arquivo cria um rule set ativo chamado my-site-waf, com sensibilidade high para SQL injection. O comando lê name, active e engine_settings do arquivo:

JSON

01{

02 "name": "my-site-waf",

03 "active": true,

04 "engine_settings": {

05 "engine_version": "2021-Q3",

06 "type": "score",

07 "attributes": {

08 "rulesets": [1],

09 "thresholds": [

10 {"threat": "sql_injection", "sensitivity": "high"}

11 ]

12 }

13 }

14}

Informe o arquivo ao comando de criação:

azion create waf --file waf-create.json

O comando imprime o ID do rule set:

Created WAF with ID 12349

O rule set criado a partir desse arquivo guarda um limiar, sql_injection em high, como mostra azion describe waf --format json.

Na atualização, o comando não lê "id" do arquivo. Informe --waf-id na linha de comando, ou o comando pergunta o ID. Este arquivo renomeia o rule set com ID 12349:

JSON

01{

02 "id": 12349,

03 "name": "my-site-waf-updated"

04}

Informe o arquivo e o ID ao comando de atualização:

azion update waf --waf-id 12349 --file waf-update.json

O comando imprime o ID do rule set atualizado:

Updated WAF with ID 12349

A atualização é parcial: o arquivo deixa active de fora, e o rule set continua ativo.