Este tópico descreve as políticas integradas e a configuração de políticas personalizadas para a segurança de API Agentic. Com base em seus mecanismos de detecção integrados, a segurança de API Agentic oferece suporte a políticas de detecção personalizadas e adaptadas ao seu negócio. Configure a detecção de riscos, eventos de segurança, dados confidenciais, credenciais de autenticação, finalidades de negócios, listas de permissões, gerenciamento de ciclo de vida, assinatura de logs e objetos de destino para garantir que os dados de API identificados reflitam com precisão o seu negócio. Isso melhora a precisão e o recall da detecção, ajudando você a responder de forma eficaz e a reduzir as perdas causadas por ataques aos ativos de negócios da sua API.
Console
Faça login no Web Application Firewall 3.0 console. Na barra de menu superior, selecione o grupo de recursos e a região (Chinese Mainland ou Outside Chinese Mainland) da instância do WAF.
No painel de navegação à esquerda, escolha .
Clique na aba Policy Configurations.
Risk Detection Configurations
Um risco é uma ameaça à segurança ou uma vulnerabilidade em uma API causada por falhas de desenvolvimento, gerenciamento ou configuração. Um risco de segurança é uma vulnerabilidade em potencial, enquanto um evento de segurança confirma que um ataque ocorreu e acionou um alerta.
O WAF fornece políticas integradas e personalizadas. Caso as políticas integradas não atendam aos requisitos do seu negócio, configure políticas personalizadas.
Política integrada
Na aba Policy Configurations > Risk Detection Configurations, visualize as políticas de risco configuradas. Todas as políticas integradas são ativadas por padrão. Altere o status delas e ajuste seus níveis de risco. De acordo com os requisitos do seu negócio, defina o nível de risco de uma política integrada como "Low Risk", "Medium Risk" ou "High Risk".
Política personalizada
Além das políticas integradas, crie até 20 políticas personalizadas.
Acesse a aba .
-
Na seção Custom Policy à esquerda, clique em New. No painel exibido, configure as seguintes definições.
Parâmetro
Descrição
Risk Name
Insira um nome descritivo para o risco personalizado.
Suggestions
Insira a ação recomendada para este risco.
Risk Level
Defina o nível de risco como baixo, médio ou alto.
Check Configurations
Defina as condições de detecção para a política personalizada. Adicione até 10 condições.
Especifique o Match Field, o Logical Operator e o Match Content. Insira até 50 valores para o conteúdo de correspondência. Pressione Enter após cada valor. Os valores de Risk Detection Configurations diferenciam maiúsculas de minúsculas.
Para obter detalhes sobre as configurações suportadas, consulte Description of Match Conditions (Risk Detection and Security Events).
Security Event Configurations
Um evento de segurança é uma chamada de API anômala ou um ataque, como um ataque de força bruta a uma API de login ou um ataque de bombardeio de SMS que abusa de uma API de SMS. O WAF detecta esses eventos com base em endereços IP e contas.
O WAF oferece políticas integradas e personalizadas. Se as políticas integradas não atenderem aos requisitos do seu negócio, configure políticas personalizadas.
Política integrada
Quando uma política integrada para um evento de segurança aciona um alerta, o sistema não gera novos alertas para o ataque em andamento. Em vez disso, ele atualiza o horário do ataque do alerta original, e a gravidade do evento pode mudar com base em fatores como o volume do ataque.
Na aba Policy Configurations > Security Event Configurations, visualize as políticas integradas de eventos de segurança. Todas as políticas integradas são ativadas por padrão. Altere o status delas e ajuste o Event Level.
Política personalizada
Além das políticas integradas, crie até 10 políticas personalizadas.
Acesse a aba Policy Configurations>Security Event Configurations.
-
Na seção Custom Policy à esquerda, clique em New. No painel exibido, configure as seguintes definições.
Parâmetro
Descrição
Event Name
Insira um nome descritivo para o evento personalizado.
Suggestions
Forneça uma sugestão de correção para o evento de segurança personalizado com base nas necessidades do seu negócio.
Event Level
Defina a gravidade do evento como Low, Medium ou High.
Match Condition
Configure as condições de correspondência que acionam o evento de segurança personalizado. Adicione até 10 condições.
Para obter detalhes sobre as configurações suportadas, consulte Match Condition Descriptions (Risk Detection and Security Events).
Rate Limiting
Especifique o Statistical Object (endereço IP ou conta), o Statistical Period (até 15 minutos) e as Requests (deve ser um número inteiro positivo).
Data Statistics
Configure as condições estatísticas para o evento de segurança personalizado. Adicione até 10 condições.
Para obter detalhes sobre as configurações suportadas, consulte Data Statistics Descriptions (Security Events).
Insira até 50 valores de conteúdo de correspondência. Pressione Enter após cada valor para confirmar.
Se você definir várias condições, uma solicitação deverá atender a todas as condições para acionar a regra.
O conteúdo de correspondência para Security Event Configurations diferencia maiúsculas de minúsculas.
III. Sensitive Data-related Configurations
O WAF detecta tipos de dados confidenciais integrados e personalizados. Os tipos integrados são ativados por padrão e apenas podem ser ativados ou desativados. Caso os tipos integrados não atendam às necessidades do seu negócio, configure até 20 tipos de dados confidenciais personalizados.
Built-in Sensitive Data Types
Acesse a aba Policy Configurations > Sensitive Data-related Configurations > Built-in Sensitive Data Types. Todas as políticas integradas são ativadas por padrão. Não é possível editá-las ou excluí-las; você pode apenas ativá-las ou desativá-las.
Custom Sensitive Data Types
Acesse a aba Policy Configurations > Sensitive Data-related Configurations > Custom Sensitive Data Types, clique em Create Policy e configure os seguintes parâmetros:
Parâmetro | Descrição |
Name | Insira um nome para a política. |
Mode | Define o modo de detecção para a política personalizada.
|
Sensitivity Level | Define o nível de sensibilidade dos dados detectados. As opções são: S1, S2, S3 e S4. Nota Para obter mais informações sobre os tipos de dados confidenciais, consulte What sensitive data types does Agentic API Security support? |
De-identification Display
A aba Sensitive Data-related Configurations inclui a opção De-identification Display. Esta opção fica desativada por padrão e nenhum dado é mascarado. Quando ativada, ela mascara as seguintes informações:
Regras de mascaramento de dados
Risk Details e API Details: Os dados confidenciais nas amostras de solicitação e resposta são substituídos por padrão pelo placeholder
{{Phone}}.Event Details: As amostras de solicitação e resposta que contêm dados confidenciais são mascaradas como
{}.-
Mascaramento de campos específicos:
Os cookies de solicitação são mascarados como
{{Cookie}}.Os cabeçalhos de solicitação que contêm um token são mascarados como
{{XXXToken}}.Os cabeçalhos Set-Cookie de resposta são mascarados como
{{SetCookie}}.
Escopo
Risk Details e API Details: Aplica-se apenas a novas amostras de solicitação e resposta.
Event Details: Aplica-se tanto a novas quanto a amostras de solicitação e resposta existentes.
IV. Disposal Policy Configuration
A aba Disposal Policy Configuration oferece os seguintes recursos.
Schema Validation: Valida solicitações e respostas em tempo real em relação ao schema (
API contract) configurado para umAPI asset. Durante a execução, o WAF compara o tráfego com a definição do schema para identificar solicitações que não estão em conformidade com oAPI contracte as trata com base nadisposition actionconfigurada no modelo. Isso ajuda a detectar chamadas anormais e abuso de API.API Real-Time Data Masking: Impulsionado pelo
AI baseline engine, este recurso aprende automaticamente a estrutura da sua API para identificarsensitive datae realizar odata maskingautomatizado e granular em tempo real. Por não exigir a pré-definição de campos, este recurso se adapta de forma flexível a cenários de negócios complexos, ajuda a atender aos requisitos de conformidade, como a transferência de dados entre fronteiras, e fornece proteção automatizada em tempo real.
Schema Validation
Antes de configurar o Schema Validation, você deve primeiro configure a schema for the API asset na aba Asset Management.
Na aba Policy Configurations > Disposal Policy Configuration, clique em Schema Validation na lista à esquerda e, em seguida, clique em Create Template para criar um modelo de validação.
Template Name: Insira um nome descritivo para o modelo.
-
Rule Configuration: Clique em Create Rule para configurar regras de validação específicas. Configure várias regras.
Rule Name: Insira um nome descritivo para a regra.
-
Validation Details: Selecione um ou mais itens para validar: Method, Path Parameter, Query Parameter, Header Parameter e Cookie Parameter. O WAF não valida itens não selecionados.
Method: Valida se o método da solicitação em tempo real corresponde ao definido no schema.
Path Parameter, Query Parameter, Header Parameter e Cookie Parameter: Valida se os parâmetros da solicitação nos locais correspondentes estão em conformidade com a definição do schema (incluindo se o parâmetro é obrigatório, seu tipo, formato e restrições de valor).
-
Data Processing Method: As ações suportadas são Monitor e Block.
Monitor: Permite solicitações que correspondem à regra, mas registra a correspondência em log. Ao testar uma regra, comece com a ação Log e analise os logs do WAF para verificar se há falsos positivos antes de alterar a ação.
Block: Bloqueia solicitações que correspondem à regra e retorna uma página de bloqueio para o cliente. Por padrão, o WAF usa uma página de bloqueio padrão. Crie também uma página personalizada usando o recurso custom response.
Apply To: Especifique os
API assets aos quais o modelo se aplica. CadaAPI assetpode ser associado a apenas um modelo de validação.
API Real-Time Data Masking
Na aba Policy Configurations > Disposal Policy Configuration, clique em API Real-Time Data Masking na lista à esquerda e, em seguida, clique em Create Template para criar um modelo de mascaramento de dados.
Template Name: Insira um nome descritivo para o modelo.
-
Masking Rule Configuration: Clique em Create Rule para configurar regras específicas de mascaramento de dados. Configure várias regras.
Rule Name: Insira um nome descritivo para a regra.
Sensitive Data Type: Selecione os tipos de dados a serem mascarados. Apenas os tipos de dados confidenciais integrados são suportados.
-
Match Condition: Defina as condições HTTP que acionam a regra. Configure até cinco condições. Se nenhuma for configurada, a regra corresponderá a todas as solicitações HTTP.
NotaSe uma regra incluir várias condições, uma solicitação deverá atender a todas as condições (E lógico) para corresponder à regra. Para obter uma descrição detalhada dos campos de correspondência e operadores lógicos, consulte Match condition details.
-
Data Processing Method: As duas ações a seguir são suportadas:
Mask: Mascara os dados. Configure também uma Action específica. As ações suportadas são Clear e Masking.
Monitor: Não mascara os dados, mas registra em log quando dados confidenciais são detectados.
Apply To: Especifique os
API assets aos quais o modelo se aplica. CadaAPI assetpode ser associado a apenas um modelo de mascaramento de dados.
Após criar um modelo, as regras de mascaramento de dados levam de 10 a 20 minutos para serem aplicadas aos API asset s recém-adicionados. Para visualizar os logs de mascaramento de dados da API, acesse a página Security Reports.
Manutenção: Gerencie os modelos e as regras existentes das seguintes formas:
Ative ou desative modelos e regras.
Adicione novas regras a um modelo.
Edite modelos e regras.
Exclua modelos e regras.
V. Authentication Credential Configurations
O WAF fornece identificação integrada de credenciais de autenticação e oferece suporte à configuração personalizada de credenciais de autenticação. Se o seu service usa campos não padronizados ou campos com padrões fracos (como valores apenas numéricos) como credenciais de autenticação, crie uma política personalizada para melhorar a precisão da segurança da API e a identificação de riscos não autenticados. Siga estas etapas:
Acesse a aba Policy Configurations > Authentication Credential Configurations.
-
Clique em Create Policy e configure as seguintes definições.
Parâmetro
Descrição
Name
Insira um nome descritivo para a política.
Match Condition
Cada condição de correspondência consiste em um Match Field, Logical Operator e Match Content. Adicione até 10 condições. Adicione pelo menos uma condição de correspondência para um cabeçalho de solicitação, cookie de solicitação, consulta de solicitação ou corpo de solicitação. O WAF combina várias condições com um E lógico, o que significa que uma solicitação deve satisfazer todas as condições para corresponder à regra.
Configuração do conteúdo de correspondência: Insira até 50 valores. Pressione Enter para confirmar cada valor. Para um Authentication Credential Configurations, o conteúdo de correspondência diferencia maiúsculas de minúsculas. Para obter mais detalhes, consulte Match condition description (authentication credential configuration).
VI. Business Purpose
O WAF oferece políticas integradas e personalizadas. Caso as políticas integradas não atendam aos requisitos do seu negócio, configure políticas personalizadas para melhorar a precisão da detecção de API Agentic em cenários de negócios específicos.
Built-in Policy
Acesse a aba Policy Configurations > Business Purpose > Built-in Policy. Essas políticas incluem atualizações de dados, compartilhamento de dados, envio de SMS e envio de mensagens. Por padrão, todas as políticas integradas estão ativadas. Não é possível editá-las ou excluí-las, mas você pode ativá-las ou desativá-las.
Custom Policy
Acesse a aba Policy Configurations>Business Purpose>Custom Policy.
-
Clique em Create Policy e configure os seguintes parâmetros.
Parâmetro
Descrição
Name
Insira um nome descritivo para a política.
Match Condition
Cada condição consiste em um Match Field, um Logical Operator e Match Content. Adicione até 10 condições.
Configuração do conteúdo de correspondência: Insira até 50 valores, pressionando Enter após cada um. O conteúdo de correspondência em Business Purpose diferencia maiúsculas de minúsculas. Para obter detalhes, consulte Description of match conditions (business purpose configuration).
Configure Whitelist
A segurança de API Agentic permite configurar listas de permissões personalizadas para detecção de riscos e eventos de segurança, a fim de filtrar alertas irrelevantes com base nas necessidades do seu negócio, como os provenientes dos endereços IP de saída da rede do seu escritório, e melhorar a eficiência operacional.
Atualmente, você só pode configurar listas de permissões para Risk Detection e Security Events.
Acesse a aba Policy Configurations > Configure Whitelist.
-
Clique em Create Policy e configure os seguintes parâmetros.
Parâmetro
Descrição
Name
Insira um nome descritivo para a política.
Type
Selecione o tipo de lista de permissões: Risk Detection ou Security Events.
Match Condition
Cada condição consiste em um Match Field, um Logical Operator e Match Content. Adicione até 10 condições.
Configuração do conteúdo de correspondência: Insira até 50 valores. Pressione Enter após cada valor. O conteúdo de correspondência em Configure Whitelist diferencia maiúsculas de minúsculas. Para obter mais informações, consulte Description of matching conditions (whitelist configuration).
Skipped Types
Nas políticas integradas ou personalizadas, selecione um ou mais tipos de detecção de risco ou eventos de segurança a serem excluídos.
Gerenciamento de ciclo de vida
A segurança de API Agentic permite personalizar critérios para APIs inativas ao definir limiares para visitas diárias e duração. Isso alinha a detecção de APIs inativas às necessidades do seu negócio. O gerenciamento do ciclo de vida da API ajuda a identificar e gerenciar APIs que atendem a esses padrões. Isso impede que invasores explorem APIs inativas e reduz possíveis perdas para o negócio.
Acesse a aba Policy Configurations > Lifecycle Management.
-
Defina os critérios para identificar uma API inativa e, em seguida, clique em OK.
Modo
Descrição
Built-in Model
O sistema marca uma API como inativa se ela não receber tráfego por 8 dias ou se o volume de tráfego cair significativamente.
Custom
Este modo permite definir um limiar para visitas diárias e uma duração de até 31 dias. Se as visitas diárias de uma API ficarem abaixo desse limiar durante a duração especificada, o sistema a marcará como inativa.
Se o Last Active Time de um ativo for superior a 30 dias, o sistema exclui automaticamente o ativo e seus dados de risco e registros de eventos de segurança associados.
IX. Log Subscription Configurations
O WAF oferece suporte à entrega de informações de ativos, informações de riscos e informações de eventos de ataque da segurança de API Agentic para um LogStore especificado no Log Service (SLS) para gerenciamento e análise centralizados.
Restrição de região: As instâncias do WAF na China continental podem entregar logs apenas para um LogStore na China continental. As instâncias do WAF fora da China continental podem entregar logs apenas para um LogStore fora da China continental. A entrega entre regiões não é suportada.
Restrições de Project e LogStore: Não é possível selecionar um LogStore para assinaturas de log se ele foi criado automaticamente pelo service de log do WAF ou se você o nomeou como
waf-logstore,wafng-logstoreouwafnew-logstore.
Procedimento
Faça login no Log Service console e crie um Project e um LogStore para receber os logs de segurança da API Agentic. Se já os tiver criado, pule esta etapa. Para obter mais informações, consulte Manage a Project.
Retorne ao WAF console e acesse a aba Policy Configurations > Log Subscription Configurations.
Selecione o tipo de log a ser assinado e clique em Settings.
Selecione a region, o Project name e o LogStore name de destino e, em seguida, clique em OK.
O Log Service cobra por operações no Log Service console, como a criação de Projects e LogStores e a ativação de indexação. Para obter mais informações sobre itens de faturamento e preços, consulte Log Service billing overview.
Condições de acionamento da assinatura de log
|
Tipo de log |
Condição de acionamento |
|
Logs de informações de ativos |
Os logs são entregues imediatamente quando um novo ativo de API é adicionado. Se nenhum novo ativo for adicionado, os logs serão entregues por padrão a cada hora. |
|
Logs de informações de riscos |
Quando novas informações de risco são detectadas, os logs são entregues em tempo real. |
|
Logs de informações de eventos de ataque |
Quando um novo evento de ataque é detectado, os logs são entregues em tempo real. Se o ataque continuar, os logs serão entregues a cada 10 minutos. |
Campos de log: Para obter uma lista dos campos de log entregues, consulte Description of log subscription fields.
Applicable Object Configurations
WAF por assinatura
O Agentic API Security disponibiliza três chaves de configuração no nível do objeto protegido ou do grupo de objetos protegidos:
Chave Basic Detection: Ativada por padrão. Controla todos os mecanismos de detecção integrados e as políticas de detecção personalizadas.
Chave Compliance Check: Desativada por padrão. Ative esta chave somente após ativar a Basic Detection. Controla o recurso Compliance Check.
Chave Traceability: Desativada por padrão. Ative esta chave somente após ativar a Basic Detection. Controla o recurso Traceability.
WAF com pagamento conforme o uso
O Agentic API Security disponibiliza uma chave de configuração no nível do objeto protegido ou do grupo de objetos protegidos:
Chave Basic Detection: Controla todos os mecanismos de detecção integrados e as políticas de detecção personalizadas. Para desativar a segurança de API, desative a chave Basic Detection de todos os objetos protegidos e grupos de objetos protegidos.
Apêndice
Condições de correspondência para eventos de risco e de segurança
|
Campo de correspondência |
Subcondição |
Operador lógico |
Descrição |
|
Domain Name |
Não suportado |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
API |
Não suportado |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
Request Method |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value |
Selecione um ou mais métodos de solicitação, como GET, POST, DELETE e PUT. |
|
User-Agent |
Não suportado |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
Referer |
Não suportado |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
Communication Protocol |
Não suportado |
Equals |
Selecione HTTP ou HTTPS. |
|
Request Content-Type |
Não suportado |
Contains One of Multiple Values, Does Not Contain Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
Request Length |
Não suportado |
Equals, Value Less Than, Value Greater Than |
Insira um número inteiro de 0 a 8192. |
|
Response Content-Type |
Não suportado |
Contains One of Multiple Values, Does Not Contain Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
Response Length |
Não suportado |
Equals, Value Less Than, Value Greater Than |
Insira um número inteiro de 0 a 8192. |
|
HTTP Status Code |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
Request Header |
cabeçalho personalizado |
Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value |
- |
|
Cookie Parameter |
Cookie-Exact personalizado |
Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value |
- |
|
GET Parameter |
Parâmetro personalizado |
Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value |
- |
|
POST Parameter |
Post-Arg personalizado |
Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value |
- |
|
Response Header |
cabeçalho de resposta |
Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value |
- |
|
Response Parameter |
parâmetro de resposta |
Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value |
- |
|
Purpose |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value |
Selecione uma ou mais finalidades de negócios na lista. Para mais informações, consulte How does Agentic API security classify API business purposes? |
|
Service Object |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value |
Selecione um ou mais objetos service na lista. Para mais informações, consulte How does Agentic API security distinguish API service objects? |
|
Authentication |
Não suportado |
Equals |
Sim/Não |
|
Request Sensitive Data Type |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value, Category Count Greater Than |
Selecione um ou mais tipos de dados confidenciais na lista. Se utilizar o operador de quantidade de tipos maior que, insira um número inteiro de 0 a 8192. |
|
Sensitivity Level of Request Sensitive Data |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value |
Selecione um ou mais níveis de S1 a S4. |
|
Response Sensitive Data Type |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value, Category Count Greater Than |
Selecione um ou mais tipos de dados confidenciais na lista. Se utilizar o operador de quantidade de tipos maior que, insira um número inteiro de 0 a 8192. |
|
Sensitivity Level of Response Sensitive Data |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value |
Selecione um ou mais níveis de S1 a S4. |
|
Source Location |
Não suportado |
Equals |
China Continental/Fora da China Continental |
|
IP address |
Não suportado |
Belongs To, Does Not Belong To |
Insira um endereço IP ou um bloco CIDR (por exemplo, 1.1.X.X/24). Não há suporte para expressões regulares. Insira até 50 valores, separados por vírgulas ou quebras de linha. |
|
Account (apenas eventos de segurança) |
Não suportado |
Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
Estatísticas de eventos de segurança
|
Campo de correspondência |
Subcondição |
Operador lógico |
Valor |
|
Status Code Statistics |
Código de status (um número inteiro de 100 a 600) |
Value Greater Than |
Um número inteiro de 0 a 8192. |
|
Request Header |
cabeçalho personalizado |
Distinct Less Than, Distinct Equals, Distinct Greater Than |
Um número inteiro de 0 a 8192. |
|
Cookie Parameter |
cookie-exact personalizado |
Distinct Less Than, Distinct Equals, Distinct Greater Than |
Um número inteiro de 0 a 8192. |
|
GET Parameter |
parâmetro personalizado |
Distinct Less Than, Distinct Equals, Distinct Greater Than |
Um número inteiro de 0 a 8192. |
|
POST Parameter |
parâmetro POST personalizado |
Distinct Less Than, Distinct Equals, Distinct Greater Than |
Um número inteiro de 0 a 8192. |
|
Response Sensitive Data Type |
Um ou mais tipos de dados confidenciais de resposta. |
Distinct Greater Than |
Um número inteiro de 0 a 8192. |
|
Sensitivity Level of Response Sensitive Data |
Um ou mais níveis de dados confidenciais de resposta. |
Distinct Greater Than |
Um número inteiro de 0 a 8192. |
|
Source IP Count |
O limiar para a contagem de IPs de origem. |
Value Greater Than |
Um número inteiro de 0 a 8192. |
Por padrão, o Agentic API Security analisa dados confidenciais nas respostas por meio de amostragem. Para configurar a detecção de Data Statistics para Response Sensitive Data Type e Sensitivity Level of Response Sensitive Data em uma Custom Policy em Security Event Configurations, ative a chave Traceability do objeto protegido correspondente em Policy Configurations > Applicable Object Configurations. Isso garante que todos os dados confidenciais nas respostas do objeto protegido sejam totalmente registrados e analisados.
Condições de correspondência de autenticação
|
Campo de correspondência |
Subcondição |
Operador lógico |
Descrição |
|
Domain Name |
Não suportado |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
API |
Não suportado |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada valor. |
|
Request Header |
cabeçalho personalizado |
Exists, Length Equal To, Length Less Than, Length Greater Than |
|
|
Request Cookie |
cookie-exact personalizado |
Exists, Length Equal To, Length Less Than, Length Greater Than |
|
|
Request Query |
parâmetro personalizado |
Exists, Length Equal To, Length Less Than, Length Greater Than |
|
|
Request Body |
post-arg personalizado |
Exists, Length Equal To, Length Less Than, Length Greater Than |
Configuração de finalidade de negócios
|
Campo de correspondência |
Operador lógico |
Valor |
|
Domain Name |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores e pressione Enter após cada um. |
|
API |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores e pressione Enter após cada um. |
|
Request Header Parameter Name |
Contains One of Multiple Values, Equals One of Multiple Values |
Insira até 50 valores e pressione Enter após cada um. |
|
Request Cookie Parameter Name |
Contains One of Multiple Values, Equals One of Multiple Values |
Insira até 50 valores e pressione Enter após cada um. |
|
Request Query Parameter Name |
Contains One of Multiple Values, Equals One of Multiple Values |
Insira até 50 valores e pressione Enter após cada um. |
|
Request Body Parameter Name |
Contains One of Multiple Values, Equals One of Multiple Values |
Insira até 50 valores e pressione Enter após cada um. |
|
Request Sensitive Data Type |
Contains One of Multiple Values, Equals One of Multiple Values |
Selecione um ou mais tipos de dados confidenciais. |
|
Response Sensitive Data Type |
Contains One of Multiple Values, Equals One of Multiple Values |
Selecione um ou mais tipos de dados confidenciais. |
|
Response Parameter Name |
Contains One of Multiple Values, Equals One of Multiple Values |
Insira até 50 valores e pressione Enter após cada um. |
Condições de correspondência (lista de permissões)
Lista de permissões de detecção de riscos
|
Campo de correspondência |
Operador lógico |
Valor |
|
Domain Name |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada um. |
|
API |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada um. |
Lista de permissões de eventos de segurança
|
Campo de correspondência |
Operador lógico |
Valor |
|
Domain Name |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada um. |
|
API |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada um. |
|
IP |
Belongs To, Does Not Belong To |
Insira um endereço IP ou um bloco CIDR (por exemplo, 1.1.X.X/24). Não há suporte para expressões regulares. Insira até 50 entradas. Separe-as com vírgulas ou pressione Enter após cada entrada. |
|
Account |
Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value |
Insira até 50 valores. Pressione Enter após cada um. |
Campos de entrega de assinatura de log
Ativos
Parâmetro | Descrição | Formato | Exemplo |
user_id | O | string | 123456 |
service_host | O | string | api.alibabacloud.com |
api_format | O | string | /api/v1/getuserbyid/${param} |
request_method | O | string | GET |
api_tag | Um array que indica o | array | ['QueryInfo'] |
api_type | Um array que indica o | array | ['PublicAPI'] |
auth_key | Um array de nomes de | array | ['id_token', 'access_token'] |
api_status | O status de | string | NewbornInterface |
api_sensitive_level | O | string | L1 |
api_sensitive_req | Um array de IDs para os | array | ['1014', '1017', '1002'] |
api_sensitive_res | Um array de IDs para os | array | ['1009', '1013', '1003', '1014', '1002'] |
farthest_ts | O | long | 1713237135 |
latest_ts | O | long | 1716452318 |
abnormal_num | O | integer | 1 |
event_num | O | integer | 2 |
struct_baseline | Um array de strings JSON, cada uma descrevendo uma | array | ['{"key":"Trace-Id","location":"request_header","format":"string","required":"true"}', '{"key":"pageNum","location":"request_query","format":"integer","required":"true"}', '{"key":"tlogTraceId","location":"response_header","format":"integer","required":"true"}', '{"key":"Strict-Transport-Security","location":"request_header","format":"string","required":"true"}', '{"key":"X-Forwarded-ClientSrcPort","location":"request_header","format":"integer","required":"true"}', '{"key":"Trace-State","location":"request_header","format":"string","required":"true"}', '{"key":"auth","location":"request_header","format":"string","required":"true"}', '{"key":"Access-Control-Max-Age","location":"response_header","format":"integer","required":"true"}', '{"key":"Enterprise-Hash","location":"request_header","format":"string","required":"true"}', '{"key":"X-Request-ID","location":"request_header","format":"string","required":"true"}', '{"key":"postName","location":"request_query","format":"string","required":"true"}', '{"key":"pageSize","location":"request_query","format":"integer","required":"true"}'] |
matched_hosts | Um array de identificadores de | array | ['*.aliyun.com-waf'] |
hosts | Um array de | array | ['api.alibabacloud.com'] |
server_port | Um array de | array | ['443'] |
server_location | Um array de códigos de país para o | array | ['CN'] |
api_id | O | string | af418cb31036015fddea71b48d06aa4b |
log_type | O | string | asset |
request_header | O | JSON | {"Connection":"Keep-Alive","Host":"api.alibabacloud.com","eagleeye-rpcid":"0.1"} |
querystring | A | string | ?token=7464f593205896e23b1286ba7532dcff |
request_body | O | string | xxx=1 |
response_header | O | JSON | {"Accept-Ranges":["bytes","bytes"],"Cache-Control":"private, max-age=21600, no-transform"} |
response_body | O | string | xxxx |
example_timestamp | Um | long | 1718546694 |
example_traceid | Um | string | 784e2ca717213678365778292e58de |
Riscos
|
Parâmetro |
Descrição |
Formato |
Exemplo |
|
user_id |
O |
string |
123456 |
|
service_host |
O |
string |
api.alibabacloud.com |
|
api_format |
O |
string |
/api/v1/login |
|
request_method |
O |
string |
POST |
|
api_tag |
Um array que indica o |
array |
['LoginAPI'] |
|
abnormal_tag |
O |
string |
Risk_DefaultPasswd |
|
abnormal_type |
O |
string |
default |
|
abnormal_level |
O |
string |
medium |
|
abnormal_discover_ts |
O |
long |
1716343432 |
|
abnormal_info |
|
object |
{'default_passwd':'aliyun123'} |
|
api_id |
O |
string |
2c0f97e10b586208039e60671150bd9b |
|
abnormal_id |
O |
string |
8cfccc0e8c3d41aa1221e94a2fdeffe3 |
|
log_type |
O |
string |
risk |
|
matched_hosts |
Um array de identificadores de |
array |
['*.aliyun.com-waf'] |
|
request_header |
O |
JSON |
{"Connection":"Keep-Alive","Host":"api.alibabacloud.com","eagleeye-rpcid":"0.1"} |
|
querystring |
A |
string |
?token=7464f593205896e23b1286ba7532dcff |
|
request_body |
O |
string |
xxx=1 |
|
response_header |
O |
JSON |
{"Accept-Ranges":["bytes","bytes"],"Cache-Control":"private, max-age=21600, no-transform"} |
|
response_body |
O |
string |
xxxx |
|
example_timestamp |
Um |
long |
1718546694 |
|
example_traceid |
Um |
string |
784e2ca71721367836577858de |
Eventos de ataque
|
Parâmetro |
Descrição |
Formato |
Exemplo |
|
user_id |
O |
string |
123456 |
|
service_host |
O |
string |
api.alibabacloud.com |
|
matched_host |
O |
string |
api.alibabacloud.com-waf |
|
host |
O |
string |
api.alibabacloud.com |
|
api_format |
O |
string |
/api/admin/login |
|
request_method |
O |
string |
POST |
|
api_tag |
Um array que indica o |
array |
['AdminService', 'LoginService'] |
|
event_tag |
O |
string |
Event_LoginCollision |
|
event_origin |
O |
string |
default |
|
event_level |
O |
string |
high |
|
start_ts |
O |
long |
1713886210 |
|
end_ts |
O |
long |
1713887817 |
|
attack_cnt |
O |
integer |
147 |
|
attack_ip_info |
Um array de objetos contendo |
array |
[{"ip": "103.44.XX.XXX", "country_id": "HK", "region_id": "-", "cnt": "147"}] |
|
api_id |
O |
string |
4dfc73b37d2d645fe2ca7f45c08f7398 |
|
event_id |
O |
string |
f09f6802e9b57a58ebb9f1bea212027e |
|
log_type |
O |
string |
event |
|
request_data |
|
JSON |
{"1002":["John Doe","Jane Smith","Sam Chen"],"1004":["13200000001","15200000002"]} |
|
response_data |
|
JSON |
{'postarg.userId':['lisi111','zhangsan123'],'postarg.corpId':['wx1111111'],'postarg.externalUserid':['wm7_KpDgOm6Bm-BGA']} |
Valores dos campos de assinatura de log
Ciclo de vida
Ciclo de vida (api_status)
|
Valor |
Descrição |
|
|
Novo. |
|
|
Inativo. |
|
|
Normal. |
Tipo de API
Tipo de API (api_type)
|
Valor |
Descrição |
|
PublicAPI |
API pública |
|
ThirdPartyAPI |
API de terceiros |
|
InternalAPI |
API interna |
Caso de uso
Caso de uso (api_tag)
|
Valor |
Descrição |
|
LoginByUserPasswd |
login com nome de usuário e senha |
|
LoginByPhoneCode |
login com código de verificação por telefone |
|
LoginByMailCode |
login com código de verificação por e-mail |
|
WeChatLogin |
login com WeChat |
|
AliPayLogin |
login com Alipay |
|
OAuthLogin |
autenticação OAuth |
|
OIDCLogin |
autenticação OIDC |
|
SAMLLogin |
autenticação SAML |
|
SSOLogin |
autenticação SSO |
|
LoginAPI |
service de login |
|
LogoutAPI |
encerramento de sessão |
|
RegisterByUserPasswd |
cadastro com nome de usuário e senha |
|
RegisterByPhoneCode |
cadastro com código de verificação por telefone |
|
RegisterByMailCode |
cadastro com código de verificação por e-mail |
|
WeChatRegister |
cadastro com WeChat |
|
AliPayRegister |
cadastro com Alipay |
|
RegisterAPI |
service de cadastro |
|
SendSMS |
envio de SMS |
|
SendMail |
envio de e-mail |
|
ResetPasswd |
redefinição de senha |
|
CheckVerifyCode |
validação de código de verificação |
|
CheckStatus |
verificação de status |
|
QueryOrder |
consulta de pedido |
|
ExportOrder |
exportação de pedido |
|
UpdateOrder |
atualização de pedido |
|
PayOrder |
pagamento de pedido |
|
QueryLog |
consulta de log |
|
UploadLog |
relatório de log |
|
DownloadLog |
exportação de log |
|
LogService |
Log Service |
|
GraphQL |
GraphQL |
|
SqlService |
service SQL |
|
FileUpload |
upload de arquivo |
|
FileDownload |
download de arquivo |
|
FileService |
service de arquivos |
|
AdminService |
gerenciamento de backend |
|
DashBoard |
painel |
|
MonitorService |
service de monitoramento |
|
SendInfo |
envio de informações |
|
CheckInfo |
verificação de dados |
|
QueryInfo |
consulta de dados |
|
UploadInfo |
upload de dados |
|
DownloadInfo |
download de dados |
|
AddInfo |
adição de dados |
|
EditInfo |
edição de dados |
|
UpdateInfo |
atualização de dados |
|
ShareInfo |
compartilhamento de dados |
|
DeleteInfo |
exclusão de dados |
|
SyncInfo |
sincronização de dados |
|
SubmitInfo |
envio de dados |
|
CopyInfo |
cópia de dados |
|
AuditInfo |
auditoria de dados |
|
SaveInfo |
salvamento de dados |
|
CancelOp |
cancelamento |
|
StartOp |
início |
|
BatchOp |
processamento em lote |
|
PauseOp |
pausa |
|
BindOp |
vinculação |
|
DebugOp |
depuração |
|
SetOp |
configuração |
|
ShutDown |
desligamento |
Tipos de dados sensíveis
Este campo especifica o tipo de dado sensível da requisição (api_sensitive_req) e o tipo de dado sensível da resposta (api_sensitive_res).
|
Valor |
Descrição |
|
1000 |
número do cartão de ID (china continental) |
|
1001 |
cartão de débito |
|
1002 |
nome completo (chinês simplificado) |
|
1003 |
endereço (china continental) |
|
1004 |
número de celular (china continental) |
|
1005 |
endereço de e-mail |
|
1006 |
número de passaporte (china continental) |
|
1007 |
Permissão de Viagem para Residentes de Hong Kong e Macau |
|
1008 |
número de placa de veículo (china continental) |
|
1009 |
número de telefone (china continental) |
|
1010 |
carteira de oficial militar |
|
1011 |
gênero |
|
1012 |
etnia |
|
1013 |
província (china continental) |
|
1014 |
cidade (china continental) |
|
1015 |
número do cartão de ID (Hong Kong, China) |
|
1016 |
nome completo (chinês tradicional) |
|
1017 |
nome completo (inglês) |
|
1018 |
número do cartão de ID (Malásia) |
|
1019 |
número do cartão de ID (Singapore) |
|
1020 |
cartão de crédito |
|
1022 |
código SWIFT |
|
1023 |
SSN |
|
1024 |
número de telefone (Estados Unidos) |
|
1025 |
crença religiosa |
|
2000 |
endereço IP |
|
2001 |
endereço MAC |
|
2002 |
string de conexão JDBC |
|
2003 |
certificado PEM |
|
2004 |
chave privada |
|
2005 |
AccessKey ID |
|
2006 |
AccessKey Secret |
|
2007 |
endereço IPv6 |
|
2009 |
data |
|
2010 |
IMEI |
|
2011 |
MEID |
|
2013 |
arquivo passwd do Linux |
|
2014 |
arquivo shadow do Linux |
|
2015 |
URL |
|
4000 |
número de licença comercial |
|
4001 |
número de certificado de registro fiscal |
|
4002 |
código de organização |
|
4003 |
Código de Crédito Social Unificado |
|
4004 |
número de identificação do veículo (VIN) |
Tipo de risco
tipo de risco
|
Valor |
Descrição |
|
RiskType_Specification |
especificação de segurança |
|
Risk_UnsafeHttpMethod |
método HTTP inseguro |
|
Risk_WeakSignAlgorithm |
algoritmo de assinatura JWT fraco |
|
Risk_UrlParam |
URL como parâmetro |
|
RiskType_Account |
segurança de conta |
|
Risk_PasswdUnencrypt |
transmissão de senha em texto simples |
|
Risk_WeakPasswd |
senha fraca permitida |
|
Risk_InternalWeakPasswd |
credenciais fracas em aplicações internas |
|
Risk_DefaultPasswd |
presença de senha padrão |
|
Risk_PasswdResponse |
senha em texto simples retornada |
|
Risk_PasswdCookie |
senha armazenada em cookies |
|
Risk_LoginRestrict |
falta de limites de tentativas de login |
|
Risk_LoginPrompt |
aviso de falha de login inadequado |
|
Risk_PasswdUrl |
credenciais transmitidas via URL |
|
RiskType_Control |
controle de acesso |
|
Risk_InternalAPI |
aplicação interna acessível pela rede pública |
|
Risk_SourceRestrict |
sem restrição de origem na API |
|
Risk_ClientRestrict |
sem restrição de ferramenta de cliente na API |
|
Risk_SpeedRestrict |
sem limitação de taxa na API |
|
RiskType_Permission |
gerenciamento de permissões |
|
Risk_WeakToken |
credencial de autenticação fraca |
|
Risk_UnauthSensitive |
API sensível sem autenticação |
|
Risk_UnauthInternalAPI |
API interna acessível sem autorização |
|
Risk_TokenUrl |
credenciais transmitidas via URL |
|
Risk_AkLeak |
vazamento de AccessKey |
|
RiskType_Sensitive |
proteção de dados |
|
Risk_SensitiveTypeExcessive |
tipos excessivos de dados sensíveis retornados |
|
Risk_SensitiveNumExcessive |
quantidade excessiva de dados sensíveis retornados |
|
Risk_InvalidDesensitize |
dessensibilização ineficaz de dados sensíveis |
|
Risk_ServerInfoLeak |
vazamento de informações sensíveis do servidor |
|
Risk_InternalIPLeak |
vazamento de endereço IP interno |
|
Risk_SensitiveURL |
dados sensíveis transmitidos via URL |
|
RiskType_Design |
design de API |
|
Risk_ParamTraverse |
parâmetros de requisição iteráveis |
|
Risk_PageSize |
tamanho da página de resposta modificável |
|
Risk_SqlAPI |
API de consulta de banco de dados |
|
Risk_RceAPI |
API de execução de comando |
|
Risk_SmsContent |
envio de conteúdo de SMS arbitrário |
|
Risk_MailContent |
envio de conteúdo de e-mail arbitrário |
|
Risk_SmsVerifyCodeLeak |
vazamento de código de verificação por SMS |
|
Risk_MailVerifyCodeLeak |
vazamento de código de verificação por e-mail |
|
Risk_FileDownload |
download de arquivo arbitrário |
|
Risk_ExceptionLeak |
vazamento de informações de exceção da aplicação |
|
Risk_ExceptionSql |
vazamento de informações de exceção do banco de dados |
Tipo de evento
evento
|
Valor |
Descrição |
|
Event_AbnormalFrequency |
acesso anormal de alta frequência |
|
Event_ExceptionIPInvoke |
acesso à API interna a partir de um endereço IP anormal |
|
Event_ExceptionRegionInvoke |
acesso à API interna a partir de uma região anormal |
|
Event_ExceptionClientInvoke |
acesso a partir de um cliente anormal |
|
Event_ExceptionTimeInvoke |
acesso durante um período de tempo incomum |
|
Event_AbnormalParamValue |
acesso com um valor de parâmetro anormal |
|
Event_InternalLoginWeakPasswd |
login em aplicação interna com senha fraca |
|
Event_LoginAccountBruteForce |
ataque de força bruta ao nome de usuário |
|
Event_LoginPasswdBruteForce |
ataque de força bruta à senha |
|
Event_LoginCollision |
ataque de credential stuffing |
|
Event_MobileVerifyBruteForce |
força bruta de código de verificação por SMS |
|
Event_MailVerifyBruteForce |
força bruta de código de verificação por e-mail |
|
Event_AbnormalRegister |
cadastro em massa |
|
Event_SMSInterfaceAbuse |
abuso de recurso de SMS |
|
Event_EmailInterfaceAbuse |
abuso de recurso de e-mail |
|
Event_AbnormalExport |
download em massa |
|
Event_DataTraverse |
extração de dados por meio de travessia de API |
|
Event_WebAttackAPI |
ataque malicioso à API |
|
Event_ObtainSensitiveUnauthorized |
acesso não autorizado a dados sensíveis |
|
Event_ObtainSensitiveExcessive |
acesso excessivo a dados sensíveis |
|
Event_CrossborderIPSensitiveExcessive |
acesso excessivo a dados sensíveis a partir de um endereço IP no exterior |
|
Event_ExceptionResponse |
resposta de API com mensagem de exceção |
|
Event_ExceptionSql |
resposta de API com mensagem de erro de banco de dados |
|
Event_SystemInfoResponse |
resposta de API contendo informações sensíveis do sistema |
|
Event_AbnormalStatus |
resposta de API com status anormal |