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 mascaramento de dados

Atualizado em 2022-11-02 GMT+08:00

Ver PDF

Criação de uma regra de mascaramento de dados

Função

Essa API é usada para criar uma regra de mascaramento de dados.

URI

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

**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
url	Sim	String	URL protegido pela regra de mascaramento de dados. O valor deve estar no formato de URL padrão, por exemplo, /admin/xxx ou /admin/. The asterisk () indica o prefixo do caminho.
category	Sim	String	Campo mascarado. Params: O campo params em solicitações Cookie: Visitantes da Web distinguidos por cookies Header: Cabeçalho HTTP personalizado Form: Formulários Valores de enumeração: params cookie header form
index	Sim	String	Nome do campo mascarado. Defina o nome do campo com base no campo mascarado. O campo mascarado não será exibido nos logs. O nome do campo mascarado não pode exceder bytes de 2 048. Apenas números, letras, sublinhados (_) e hifens (-) são permitidos.
description	Não	String	(Opcional) Uma descrição da regra.

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
policyid	String	ID da política
timestamp	Long	Hora em que a regra foi criada. O valor é um carimbo de data/hora de 13 dígitos em ms.
status	Integer	Status da regra. O valor pode ser 0 ou 1. 0: A regra está desativada. 1: A regra está ativada.
url	String	URL protegido pela regra de mascaramento de dados. O valor deve estar no formato de URL padrão, por exemplo, /admin/xxx ou /admin/. The asterisk () indica o prefixo do caminho.
category	String	Campo mascarado. Params: O campo params em solicitações Cookie: Visitantes da Web distinguidos por cookies Header: Cabeçalho HTTP personalizado Form: Formulários Valores de enumeração: params cookie header form
index	String	Nome do campo mascarado. Defina o nome do campo com base no campo mascarado. O campo mascarado não será exibido nos logs.
description	String	(Opcional) Uma descrição da regra.

Código de estado: 400

**Tabela 6** 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 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: 500

**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

Exemplos de solicitações

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

{
  "url" : "/demo",
  "category" : "cookie",
  "index" : "demo",
  "description" : "demo"
}

Exemplo de respostas

Código de estado: 200

Solicitação bem-sucedida.

{
  "id" : "97e4d35f375f4736a21cccfad77613eb",
  "policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
  "timestamp" : 1650533191385,
  "description" : "demo",
  "status" : 1,
  "url" : "/demo",
  "category" : "cookie",
  "index" : "demo"
}