logo
bars

FunCaptcha
e CapMonster Cloud

Solução de captcha, instalação no site e testes.
Herdou um site com captcha ou outra proteção mas sem acesso ao código-fonte? É natural perguntar qual solução está instalada, se está configurada corretamente e como testá-la.

Neste artigo procurámos responder a todas as questões importantes. Para começar a resolver o problema, o primeiro passo é identificar que sistema de proteção está a ser utilizado. Para isso, pode consultar a lista de captchas e sistemas de proteção antibot mais populares, onde encontrará exemplos visuais e sinais principais que ajudam a perceber rapidamente com o que está a lidar.

Se verificar que o seu site utiliza FunCaptcha (Arkose Labs CAPTCHA), o passo seguinte é analisar mais detalhadamente as suas características e o seu funcionamento. Neste mesmo artigo também pode consultar o guia de integração de FunCaptcha (Arkose Labs CAPTCHA), para compreender totalmente como o sistema funciona no seu site. Isto permitirá não só entender a proteção atual, como também planear corretamente a sua manutenção.

O que é FunCaptcha
O que é FunCaptcha
FunCaptcha é um sistema interativo de proteção contra bots desenvolvido pela Arkose Labs. Ele verifica se o usuário é humano por meio de desafios visuais e jogáveis, que são fáceis para pessoas, mas difíceis de automatizar. FunCaptcha é usado para proteger registros, logins, pagamentos online, campanhas de marketing e prevenir fraudes, spam e ações automatizadas em massa.
Background
Exemplos de FunCaptcha
Rotação de objeto 3D
Rotação de objeto 3D
O usuário gira um modelo 3D ou figura para posicioná-lo corretamente.
Selecionar objetos conforme a regra
Selecionar objetos conforme a regra
É necessário selecionar imagens ou elementos que correspondam a uma regra (por exemplo, 'selecione todas as maçãs').
Tarefas interativas (arrastar e soltar / seguir caminho)
Tarefas interativas (arrastar e soltar / seguir caminho)
O usuário realiza ações com elementos, como arrastá-los por um caminho específico.
Perguntas de áudio
Perguntas de áudio
O usuário ouve o áudio e escolhe a resposta correta (usado com menos frequência como alternativa aos desafios visuais).

Como resolver FunCaptcha via CapMonster Cloud

Ao testar formulários com FunCaptcha, muitas vezes é necessário verificar se o captcha está funcionando corretamente e integrado corretamente.
Você pode testar manualmente o captcha adicionado ao seu site.
  • Abra a página com o formulário e verifique se o captcha está visível.
  • Tente enviar o formulário sem resolver o captcha — o servidor deve retornar um erro.
  • Após a resolução bem-sucedida do captcha — o formulário deve ser enviado sem erros.
Para reconhecimento automático de captcha, você pode usar serviços especializados, como CapMonster Cloud — uma ferramenta que recebe os parâmetros do captcha, processa-os em seus servidores e retorna um token pronto. Esse token pode ser inserido no formulário para passar na verificação sem a intervenção do usuário.

Trabalhar com o CapMonster Cloud através da API normalmente envolve os passos seguintes:

Criação da tarefaCriação da tarefa
arrow
Envio do pedido APIEnvio do pedido API
arrow
Receção do resultadoReceção do resultado
arrow
Aplicação do token na páginaAplicação do token na página
arrow
Como conectar FunCaptcha ao seu site
Para entender bem o funcionamento do captcha no seu site, compreender a lógica de verificação e reconectar ou reconfigurar, recomendamos estudar esta seção. Ela descreve o processo de conexão da proteção e ajuda a entender rapidamente todos os detalhes.
  1. Registre-se na Arkose Labs e obtenha acesso ao Arkose Command Center (você pode enviar um chat com seus dados no formulário — por exemplo, aqui ou aqui).
  2. Após o acesso, obtenha duas chaves (Public / Private) na seção Settings → Keys.

    HowTo Connect image 1

  3. Se necessário, contate o Customer Success Manager (CSM) para:

    • obter domínios API customizados;
    • verificar esquemas de requisições e respostas API.

Recomendações Arkose

  • Use a Development Key para testes.
  • Use uma Production Key separada para cada workflow (login, registro, compra etc.).
  • Use chaves diferentes para sites diferentes.

Processo geral de funcionamento

  • O cliente coleta dados e, se necessário, exibe um desafio.
  • O cliente recebe um token de sessão único.
  • O servidor verifica o token via Arkose Verify API.

Passo 1. Integração do lado do cliente

No navegador (Arkose Bot Manager):

  • analisa o comportamento do usuário;
  • exibe, se necessário, Enforcement Challenge;
  • retorna um token de sessão.

Client API:

  • Para testes pode-se usar:
    client-api.arkoselabs.com
  • Para produção, recomenda-se indicar um domínio customizado:
    <company>-api.arkoselabs.com

Principais requisitos

Resultado do cliente — token a ser enviado ao servidor.

Passo 2. Verificação no servidor

No servidor, o token é verificado via Arkose Verify API.

Verify API endpoint

Parâmetros obrigatórios do pedido

Exemplo de corpo POST

A resposta da API contém informações da sessão e o resultado da verificação.

Pontos-chave

Como funciona:

Background
Possíveis erros e depuração
Bug Icon
Parâmetros de pedido incorretos
Certifique-se de fornecer a Public Key correta para o cliente e a Private Key para o servidor, e enviar o session_token correto para a Verify API.
Bug Icon
session_token vazio ou incorreto
O servidor receberá resultado vazio ou erro de verificação. Verifique se o cliente envia corretamente o token após resolver a captcha.
Bug Icon
Tempo de resolução esgotado
Se o usuário não completar a verificação a tempo, o servidor Arkose pode retornar erro ou rejeitar a verificação. Aumente o tempo de espera permitido no servidor.
Verificações de robustez
Recomendações de segurança e otimização
<b>Armazene a Private Key apenas no servidor</b>, não inclua no código JS do cliente.
Registre respostas completas da Arkose Verify API, incluindo status, código de erro e parâmetros enviados — isso ajuda na rápida resolução de problemas.
Use <b>HTTPS</b> para todas as requisições (cliente → servidor → Verify API) para evitar manipulação de dados.
Coloque links para a <b>Política de Privacidade</b> e os <b>Termos de Uso Arkose Labs</b> no site, conforme exigido pela licença.
Conclusão

Se herdou um site que já tem um captcha ou outro sistema de proteção instalado e não tem acesso ao código, não há problema! É bastante fácil identificar qual a tecnologia que está a ser utilizada. Para verificar se tudo está a funcionar corretamente, pode usar o serviço de reconhecimento CapMonster Cloud num ambiente de teste isolado, para garantir que o mecanismo de processamento de tokens e a lógica de verificação estão a funcionar corretamente.

No caso de FunCaptcha, basta identificar o sistema, analisar o seu comportamento e confirmar que a proteção está a funcionar corretamente. No artigo, mostramos como identificar FunCaptcha e onde encontrar instruções para a sua integração ou reconfiguração, para que possa manter a proteção com confiança e controlar o seu funcionamento.

Conclusion