Adicionar o Google reCAPTCHA ao Forms no Editor universal
O Google reCAPTCHA ajuda a proteger formulários, diferenciando usuários humanos e bots automatizados. Este guia explica como implementar as versões Enterprise e Standard do reCAPTCHA no Universal Editor.
Objetivos:
- Selecione a solução reCAPTCHA apropriada
- Configurar o reCAPTCHA Enterprise ou Standard
- Adicionar reCAPTCHA aos seus formulários
- Validar e testar a implementação
- Monitorar e otimizar o desempenho
Pré-requisitos
Antes de iniciar, verifique se você tem o seguinte:
Requisitos de acesso
- Acesso de criação ao AEM as a Cloud Service
- Acesso ao Editor universal com permissões de edição de formulário
Requisitos técnicos
- Conta ativa do Google
- Para corporações: projeto da Google Cloud Platform com faturamento ativado
- Para Standard: conta do Google reCAPTCHA
- Propriedade de domínio verificada para seus formulários
Requisitos de conhecimento
- Noções básicas sobre o AEM Forms e o Universal Editor
- Familiaridade com configurações do Cloud Service
- Noções básicas sobre conceitos de segurança de formulário
Por que usar o reCAPTCHA no seu Forms?
Conceito principal: o reCAPTCHA usa o aprendizado de máquina para analisar o comportamento do usuário e atribui uma pontuação (0,0 a 1,0) indicando a probabilidade de interação humana. Pontuações mais altas indicam usuários humanos; pontuações mais baixas sugerem bots.
Exemplo: um formulário de cálculo de imposto que lida com dados confidenciais requer proteção contra ataques automatizados. O reCAPTCHA verifica se os envios são de usuários reais, não de bots.
Escolha sua solução reCAPTCHA
O Edge Delivery Services Forms é compatível com duas opções de reCAPTCHA do Google. Use os critérios a seguir para selecionar a solução correta:
Guia de decisão rápida
Use o reCAPTCHA Enterprise se você tiver:
- Formulários de alto tráfego (>10.000 solicitações/mês)
- Requisitos de conformidade rigorosos (GDPR, SOX, HIPAA)
- Necessidade de análises e relatórios avançados
- Orçamento para recursos de segurança premium
- Implantações complexas de vários domínios
Use o reCAPTCHA Standard se você tiver:
- Tráfego baixo a moderado (<10.000 solicitações/mês)
- Necessidades básicas de segurança
- Orçamento limitado (nível gratuito)
- Configuração simples de domínio único
- São novos no reCAPTCHA
Comparação detalhada
Ambas as soluções fornecem:
- Detecção baseada em pontuação (escala de 0 a 1,0)
- Operação invisível (nenhuma interação do usuário é necessária)
- Detecção de bot habilitada para aprendizado de máquina
- Avaliação de riscos em tempo real
Configurar o reCAPTCHA Enterprise
Requisitos:
- Projeto da Google Cloud com faturamento ativado
- ID do projeto (do painel GCP)
- Verificação de domínio para seus formulários
- Acesso de administrador ao GCP e ao AEM
Instalação:
-
Criar ou selecionar um projeto da Google Cloud
- Ir para o Google Cloud Console
- Criar um novo projeto ou selecionar um já existente
- Anote a ID do projeto
-
Habilitar a API corporativa do reCAPTCHA
- Acesse APIs e serviços > Biblioteca
- Procure por "reCAPTCHA Enterprise API"
- Clique em Ativar
-
Criar credenciais de API
- Acesse APIs e serviços > Credenciais
- Clique em Criar credenciais > Chave de API
- Copie e armazene sua chave de API
-
Criar chave do site
- Acesse Segurança > reCAPTCHA Enterprise
- Clique em Criar chave
- Escolher tipo de chave baseada em pontuação
- Adicionar seu(s) domínio(s)
- Definir pontuação de limite (recomendado: 0,5)
Ponto de Verificação de Validação: Verifique se você tem:
- ID do projeto
- Chave da API
- Chave do site
- Domínio verificado na Google Cloud
Figura: Habilitando configurações de nuvem para o contêiner de formulário
Instalação:
-
Acessar navegador de configuração
- Faça logon na instância de autor do AEM
- Acesse Ferramentas > Geral > Navegador de configuração
-
Ativar configurações em nuvem
- Localize o contêiner de configuração do formulário
- Selecionar propriedades
- Verificar configurações de nuvem
- Clique em Salvar e fechar
-
Verificar configuração
- Confirmar "Configurações de nuvem" aparece nas propriedades do container
Ponto de Verificação de Validação:
- Configurações de nuvem habilitadas para o seu contêiner
- O contêiner é exibido no Navegador de configuração
- As propriedades mostram "Configurações de nuvem" como ativadas
Figura: interface de configuração do reCAPTCHA Enterprise no AEM
Configuração:
-
Acessar a configuração do reCAPTCHA
- Acesse Ferramentas > Serviços da nuvem > reCAPTCHA
- Selecione o contêiner de configuração do seu formulário
- Clique em Criar
-
Definir Configurações Corporativas
- Título: nome descritivo (por exemplo, "Production reCAPTCHA")
- Nome: Nome do sistema (gerado automaticamente ou personalizado)
- Versão: Selecione ReCAPTCHA Enterprise
- ID do projeto: insira sua ID do projeto do Google Cloud
- Chave do site: insira a chave do site na Google Cloud
- Chave da API: insira sua chave da API da Google Cloud
- Tipo de chave: selecione Chave do site com base em pontuação
-
Definir Limite de Segurança
-
Pontuação limite: Definida entre 0,0 e 1,0
-
Valores recomendados:
- 0.7-0.9: Alta segurança (pode bloquear alguns usuários legítimos)
- 0.5-0.7: Segurança equilibrada (recomendado)
- 0.1-0.5: Segurança mais baixa (permite mais usuários)
-
-
Salvar e publicar
- Clique em Criar para salvar a configuração
- Clique em Publicar para disponibilizá-lo
Ponto de Verificação de Validação:
- Configuração salva com sucesso
- Todos os campos obrigatórios foram preenchidos
- Configuração publicada e visível
- Nenhuma mensagem de erro
Configurar o reCAPTCHA Standard
| note important |
|---|
| IMPORTANT |
| O Edge Delivery Services Forms é compatível apenas com o reCAPTCHA v2 (baseado em pontuação). Não use a versão da caixa de seleção. |
Geração de chave:
-
Acessar o console reCAPTCHA do Google
- Ir para o Google reCAPTCHA Admin Console
- Fazer logon com sua conta da Google
-
Criar novo site
- Clique em + para adicionar um novo site
- Label: digite um nome descritivo
- Tipo de reCAPTCHA: selecione reCAPTCHA v2 > "Não sou um robô" Invisível
- Domínios: adicione seu(s) domínio(s) de formulário
- Aceite os termos e clique em Enviar
-
Colete suas chaves
- Chave do site: copie a chave do site (chave pública)
- Chave secreta: copie a chave secreta (chave privada)
Ponto de Verificação de Validação:
-
Site criado no console do reCAPTCHA
-
Chave do site obtida
-
Chave secreta obtida
-
Domínio(s) adicionado(s) e verificado(s)
Siga o mesmo processo da Configuração do Enterprise:
-
Habilitar configurações de nuvem no navegador de configuração
-
Verificar configuração do contêiner
-
Confirmar se as configurações foram salvas
Figura: interface de configuração do reCAPTCHA Standard no AEM
Configuração:
-
Acessar a configuração do reCAPTCHA
- Acesse Ferramentas > Serviços da nuvem > reCAPTCHA
- Selecione o contêiner de configuração do seu formulário
- Clique em Criar
-
Definir Configurações Padrão
- Título: nome descritivo (por exemplo, "Standard reCAPTCHA")
- Nome: Nome do sistema (gerado automaticamente ou personalizado)
- Versão: Selecione ReCAPTCHA v2
- Chave do site: insira sua chave do site Google reCAPTCHA
- Chave secreta: insira sua chave secreta do Google reCAPTCHA
-
Salvar e publicar
- Clique em Criar para salvar a configuração
- Clique em Publicar para disponibilizá-lo
Ponto de Verificação de Validação:
-
Configuração criada sem erros
-
Ambas as chaves foram inseridas corretamente
-
Configuração publicada com sucesso
-
A configuração é exibida na lista
Adicionar reCAPTCHA ao formulário
Após configurar o serviço reCAPTCHA, adicione proteção ao formulário da seguinte maneira:
Figura: Adicionando o componente Captcha Invisível ao formulário
Vá para o formulário no AEM Sites e clique em Editar para abri-lo no Universal Editor. Aguarde até que o editor seja carregado.
- Acesse seu formulário no AEM Sites
- Clique em Editar para abrir no Editor universal
- Aguardar o editor carregar
Na Árvore de conteúdo (painel esquerdo), encontre a seção Formulário adaptável e expanda a estrutura do formulário para ver os pontos de inserção.
- Na Árvore de conteúdo (painel esquerdo), encontre a seção Formulário adaptável
- Expanda a estrutura do formulário para ver pontos de inserção
Adicione o componente Captcha (Invisível) ao formulário.
- Clique no ícone Adicionar (+) na seção do formulário
- Na lista de componentes, selecione Captcha (Invisível)
- Como alternativa, arraste e solte o componente do painel Componentes
Selecione o componente captcha recém-adicionado e verifique se ele usa a configuração do reCAPTCHA.
- Selecione o componente captcha recém-adicionado
- No painel Propriedades, verifique se ele usa a configuração do reCAPTCHA
- Nenhuma configuração adicional é necessária para a configuração básica
Publique suas alterações e verifique se não há erros.
- Clique em Publicar no Universal Editor
- Aguardar confirmação
- Verifique se nenhum erro é exibido
Verificar implementação
Seu formulário protegido agora está disponível em:
https://<branch>--<repo>--<owner>.aem.live/content/forms/af/
<form-name>
Exemplo de URL:
https://main--my-forms--company.aem.live/content/forms/af/
contact-us-form