Como instalar a integração IPQualityScore Phone Validation

IPQualityScore Phone Validation é uma integração de Firewall que valida números de telefone em tempo real, analisando score de risco, país de origem, operadora, tipo de linha e status de conexão. Ela ajuda sua aplicação a detectar números de telefone fraudulentos, linhas inativas e VOIPs de alto risco antes que cheguem à sua origem.

Quando uma requisição chega ao edge, a função extrai o número de telefone da fonte configurada (query string, corpo da requisição ou header), consulta a API do IPQualityScore 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 Phone 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 Phone 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 Phone Validation.
Na caixa Arguments, passe suas variáveis:

{
  "api_key": "SuaAPIKeyIPQS",
  "fast": true,
  "get_data_from": "querystring",
  "data_name": "phone",
  "when_score_above": 80,
  "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 o número de telefone será extraído. Valores aceitos: `querystring`, `body`, `header`
`data_name`	Sim	O nome do parâmetro de query string, campo do corpo ou header que contém o número de telefone
`when_score_above`	Não	Threshold de score (0–100) que aciona a ação definida em `execute`. Scores de fraude ≥ 90 são considerados alto risco. 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 telefone.
- Exemplo: if Host matches seudominio.com.
Abaixo, selecione Run Function como behavior e escolha a instância da função Phone 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 Phone 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 Phone Validation está em execução e validando números de telefone no edge.