logo
bars

FunCaptcha
e CapMonster Cloud

Solução de captcha, instalação no site e testes.
Você herdou um site com captcha ou outra camada de proteção, mas não tem acesso ao código-fonte? Então é normal querer saber qual solução está instalada, se a configuração está correta e como testar tudo.

Neste artigo, procuramos responder a todas as principais dúvidas. Para começar a resolver o problema, o primeiro passo é identificar qual sistema de proteção está sendo utilizado. Para isso, você pode consultar a lista de captchas e sistemas de proteção antibot mais populares, onde há exemplos visuais e sinais principais que ajudam a identificar rapidamente com o que você está lidando.

Se você notar que o seu site utiliza FunCaptcha (Arkose Labs CAPTCHA), o passo seguinte é estudar com mais detalhes as suas características e o seu funcionamento. Neste mesmo artigo, você também pode conferir o guia de integração do FunCaptcha (Arkose Labs CAPTCHA), para entender por completo como o sistema opera no seu site. Isso permitirá não apenas compreender a proteção atual, mas também planejar adequadamente 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 através de desafios visuais e jogáveis, 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 colocá-lo na posição correta.
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 menos frequentemente 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.
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 resolver o captcha com sucesso — o formulário deve ser enviado sem erros.
Para reconhecimento automático de captcha, você pode usar serviços especializados como o 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 via API normalmente envolve as etapas abaixo:

Criação da tarefaCriação da tarefa
arrow
Envio da requisição APIEnvio da requisição API
arrow
Recebimento do resultadoRecebimento 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 personalizados;
    • 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 personalizado:
    <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 o 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ção da 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 você 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 tem problema! É bem fácil identificar qual tecnologia está sendo usada. Para verificar se tudo está funcionando corretamente, você pode usar o serviço de reconhecimento CapMonster Cloud em um ambiente de testes isolado, para garantir que o mecanismo de processamento de tokens e a lógica de verificação estejam funcionando corretamente.

No caso de FunCaptcha, basta identificar o sistema, analisar o comportamento dele e se certificar de que a proteção está funcionando corretamente. No artigo, mostramos como identificar FunCaptcha e onde encontrar instruções para a integração ou reconfiguração, para que você consiga manter a proteção com segurança e controlar o funcionamento dela.

Conclusion