FunCaptcha
e CapMonster Cloud

Solução de captcha, instalação no site e testes.

Preços da solução FunCaptcha

CAPTCHA
Preço (USD)
$ 1.10
1000 tokens
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
<span class="font-bold">Armazene a Private Key apenas no servidor</span>, 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 <span class="font-bold">HTTPS</span> para todas as requisições (cliente → servidor → Verify API) para evitar manipulação de dados.
Coloque links para a <span class="font-bold">Política de Privacidade</span> e os <span class="font-bold">Termos de Uso Arkose Labs</span> 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

Perguntas frequentes sobre FunCaptcha

Sim — o Arkose pode operar em modo invisível, analisar o comportamento em segundo plano e só mostrar um challenge visível quando deteta risco. Em sessões de baixo risco, o script do cliente recolhe sinais e devolve um session token via callback sem mostrar UI.

A integração deve sempre tratar o callback — o caminho de processamento do token é o mesmo nos dois casos.

Um indicador fiável são pedidos de rede a domínios arkoselabs.com. Abra DevTools, separador Network, recarregue a página — pedidos a client-api.arkoselabs.com ou subdomínio semelhante indicam FunCaptcha ativo.

A chave privada pertence à verificação no servidor e nunca deve aparecer no código do cliente. A chave pública serve para a inicialização client-side do Arkose FunCaptcha.

Se um programador trocar as chaves, a integração normalmente falha.

Para garantir que o backend processa verificações Arkose de forma estável e segura, recomendamos testar três cenários críticos:

  • pedido sem session_token — deve ser rejeitado;
  • token expirado — o servidor deve devolver erro;
  • reutilização do mesmo token — a segunda verificação deve ser negada, os tokens são de uso único.

Quando o CapMonster Cloud devolve um token FunCaptcha, deve ser passado à página através do callback registado pelo Arkose na inicialização.

No exemplo Playwright da secção "Colocar o token na página", isto acontece automaticamente:

  • O script liga-se ao contexto de execução JavaScript da página.
  • Verifica se o objeto global Arkose está exposto como FunCaptcha ou ArkoseEnforcement.
  • Faz patch ao método render() para capturar o callback original.
  • Após resolver, chama esse callback com o token.

O token resolvido é injetado na página como esperado, sem ação manual no cliente.