Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Web Application Firewall/ Referência de API/ API/ Gerenciamento de regras/ Criação de uma regra de lista negra/lista branca
Atualizado em 2022-11-02 GMT+08:00

Criação de uma regra de lista negra/lista branca

Função

Essa API é usada para criar uma regra de lista negra ou lista branca.

URI

POST /v1/{project_id}/waf/policy/{policy_id}/whiteblackip

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto. Para obtê-lo, vá para o console de gerenciamento do Huawei Cloud e passe o cursor sobre seu nome de usuário. Na janela exibida, escolha My Credentials.Em seguida, na área Projects, visualize Project ID correspondente.

policy_id

Sim

String

ID da política. Ele pode ser obtido chamando a API ListPolicy.

Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

enterprise_project_id

Não

String

Você pode obter o ID chamando a API ListEnterpriseProject do EPS.

Parâmetros de solicitação

Tabela 3 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário. Ele pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho da resposta).

Content-Type

Sim

String

Tipo de conteúdo.

Padrão: application/json;charset=utf8

Tabela 4 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

Nome da rue. O valor pode conter no máximo 64 caracteres. Apenas letras, dígitos, hifens (-), sublinhados (_) e pontos (.) são permitidos.

addr

Não

String

Endereço IP ou intervalos de endereços IP na regra de lista negra ou lista branca, por exemplo, 42.123.120.66 ou 42.123.120.0/16.

description

Não

String

Descrição da regra

white

Sim

Integer

Ação Protetora

  • 0: O WAF bloqueia solicitações que atingem a regra.
  • 1: O WAF permite solicitações que batem na regra.
  • 2: O WAF registra apenas solicitações que atingem a regra.

ip_group_id

Não

String

ID do grupo de endereços IP criado. Use este parâmetro ou addr. Para adicionar um grupo de endereços IP, vá para o console do WAF, escolha Objects > Address Groups, e clique em Add Address Group.

Parâmetros de resposta

Código de estado: 200

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

id

String

ID da regra

name

String

Nome da regra da lista branca ou da lista negra

policyid

String

ID da política

addr

String

Endereço IP ou intervalos de endereços IP na regra de lista negra ou lista branca, por exemplo, 42.123.120.66 ou 42.123.120.0/16.

white

Integer

Ação Protetora

  • 0: O WAF bloqueia solicitações que atingem a regra.
  • 1: O WAF permite solicitações que batem na regra.
  • 2: O WAF registra apenas solicitações que atingem a regra.

ip_group

Ip_group object

Grupo de endereços IP

status

Integer

Status da regra. O valor pode ser 0 ou 1.

  • 0: A regra está desativada.
  • 1: A regra está ativada.

description

String

Descrição da regra

timestamp

Long

Hora em que uma regra é criada. O valor é um carimbo de data/hora de 13 dígitos em milissegundos.

Tabela 6 Ip_group

Parâmetro

Tipo

Descrição

id

String

ID do grupo de endereços IP

name

String

Nome do grupo de endereços IP

size

Long

Número de endereços IP ou intervalos de endereços IP no grupo de endereços IP

Código de estado: 400

Tabela 7 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro

error_msg

String

Mensagem de erro

Código de estado: 401

Tabela 8 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro

error_msg

String

Mensagem de erro

Código de estado: 500

Tabela 9 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro

error_msg

String

Mensagem de erro

Exemplos de solicitações

POST https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/whiteblackip?enterprise_project_id=0

{
  "name" : "demo",
  "white" : 0,
  "description" : "demo",
  "addr" : "x.x.x.x"
}

Exemplo de respostas

Código de estado: 200

OK

{
  "id" : "5d43af25404341058d5ab17b7ba78b56",
  "policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
  "name" : "demo",
  "timestamp" : 1650531872900,
  "description" : "demo",
  "status" : 1,
  "addr" : "x.x.x.x",
  "white" : 0,
  "size" : 1
}

Códigos de status

Código de status

Descrição

200

OK

400

Falha na solicitação.

401

O token não tem permissões necessárias.

500

Erro de servidor interno.

Códigos de erro

Consulte Códigos de erro.