Como instalar a integração IPQualityScore URL Validation

IPQualityScore URL Validation é uma integração de Firewall que escaneia URLs em tempo real para detectar malware, links de phishing, domínios suspeitos, domínios estacionados e spam. Ela realiza mais de 20 verificações por requisição, usando modelos de machine learning para classificar ameaças — incluindo links de phishing zero-day e domínios recém-registrados — antes que cheguem à sua origem.

Quando uma requisição chega ao edge, a função extrai a URL da fonte configurada (query string, corpo da requisição ou header), consulta a API do IPQualityScore Malicious URL Scanner e bloqueia a requisição, descarta a conexão ou adiciona um header com o resultado — dependendo da ação configurada.

Pré-requisitos

Para começar a usar esta integração, você precisa:

Criar uma conta no IPQualityScore.
Obter sua API Key no painel do IPQualityScore após a criação da conta.

Obtenha a integração

Para instalar esta integração:

Acesse Azion Console > Marketplace.
Na página inicial do Marketplace, selecione o cartão da URL Validation.
Na página de integração, clique no botão Install.

Você verá uma mensagem indicando que sua integração foi instalada com sucesso.

Configure a integração

Depois de instalar a integração IPQualityScore URL Validation, conclua as etapas abaixo para configurá-la.

Configure um Firewall

Siga estes passos:

No canto superior esquerdo, abra o Products menu e selecione Firewall na seção Secure.
Clique no botão + Firewall.
Dê um nome fácil de lembrar ao seu firewall.
Ative a opção Functions na seção Modules.
- Esta ação dá acesso a functions no firewall.
Clique no botão Save.

Pronto. Agora você instanciou o firewall para sua função e tem acesso a functions em seu firewall.

Configure uma função no Firewall

Enquanto ainda estiver na página do Firewall:

Selecione a aba Functions Instances.
Clique no botão + Function Instance.
Dê um nome fácil de lembrar à sua instância.
No menu suspenso, selecione a função IPQualityScore URL Validation.
Na caixa Arguments, passe suas variáveis:

{
  "api_key": "SuaAPIKeyIPQS",
  "fast": true,
  "get_data_from": "querystring",
  "data_name": "url",
  "when_score_above": 85,
  "execute": "deny"
}

Onde:

Variável	Obrigatório	Descrição
`api_key`	Sim	Sua API Key do IPQualityScore
`fast`	Não	Ativa o modo de validação rápida. Quando `true`, algumas verificações forenses são ignoradas para menor latência. Recomendado: `true`. Padrão: `false`
`get_data_from`	Sim	Define de onde a URL será extraída. Valores aceitos: `querystring`, `body`, `header`
`data_name`	Sim	O nome do parâmetro de query string, campo do corpo ou header que contém a URL a ser validada
`when_score_above`	Não	Threshold de score de risco (0–100) que aciona a ação definida em `execute`. Scores ≥ 85 indicam suspeita de phishing ou malware; score 100 confirma atividade maliciosa. Se não definido, nenhuma ação é executada
`execute`	Não	Ação a ser executada quando o score ultrapassar `when_score_above`. Valores aceitos: `deny`, `drop`, `add_header`

Os valores de execute se comportam da seguinte forma:

Valor	Comportamento
`deny`	Executa o behavior Deny, retornando uma resposta `403 Forbidden`
`drop`	Executa o behavior Drop, encerrando a conexão sem resposta
`add_header`	Adiciona o header `ipqs-limit-score-reached` à requisição e deixa ela seguir. Use quando quiser tratar o resultado no Rules Engine ou na origem

Clique no botão Save.

Configure uma regra no Rules Engine

Para concluir, você deve configurar uma regra no Rules Engine para definir os critérios (criteria) e o comportamento (behavior) para executar a função.

Ainda na página do Firewall:

Selecione a aba Rules Engine.
Clique no botão + Rule Engine.
Dê um nome fácil de lembrar à sua nova regra.
Selecione um criteria (critério) para definir quais requisições acionam a verificação de URL.
- Exemplo: if Host matches seudominio.com.
Abaixo, selecione Run Function como behavior e escolha a instância da função URL Validation criada anteriormente.
Clique no botão Save.

Associe o Firewall ao seu domínio

No Console, você deve agora configurar seu domínio para que ele seja protegido pelo seu Firewall.

No Products menu, selecione Workloads.
Clique no workload que contém o domínio que você deseja proteger com sua função URL Validation.
Na seção Deployment Settings, clique no seletor de Firewall e escolha o Firewall que você acabou de criar.
Clique no botão Save.

Pronto. Agora a integração IPQualityScore URL Validation está em execução e escaneando URLs no edge.