Usar o Google reCAPTCHA em um formulário adaptável AEM com base em componentes principais using-reCAPTCHA-in-adaptive-forms

Aplica-se a
Link do artigo
Formulário adaptável com base nos Componentes principais
Este artigo
Formulário adaptável baseado em componentes de base
Clique aqui

O CAPTCHA (um teste de Turing público e completamente automatizado para diferenciar computadores e humanos) é um programa comumente usado em transações online para distinguir entre humanos e programas ou bots automatizados. O recurso apresenta um desafio e avalia a resposta do usuário para determinar se é um humano ou um bot interagindo com o site. O CAPTCHA impede que o usuário prossiga se o teste falhar e ajuda a tornar as transações online seguras, evitando que bots publiquem spam ou outro conteúdo mal-intencionado.

O AEM Forms as a Cloud Service é compatível com as seguintes soluções CAPTCHA:

Conecte seus Componentes principais do AEM Forms com o serviço reCAPTCHA da Google connect-your-forms-environment-with-recaptcha-service-by-google

Os autores de formulários podem usar o serviço reCAPTCHA pelo Google para implementar o reCAPTCHA no Adaptive Forms. Ele oferece recursos avançados de CAPTCHA para proteger o site. Para obter mais informações sobre como o reCAPTCHA funciona, consulte Google reCAPTCHA. Use-o para apresentar um desafio de CAPTCHA no envio do formulário.O AEM Forms as a Cloud Service oferece suporte ao Google reCAPTCHA v2 e reCAPTCHA Enterprise. Nenhuma outra versão é compatível. Observe também que o reCAPTCHA no Adaptive Forms não é compatível no modo offline no aplicativo AEM Forms.

Com base em seu requisito, você pode configurar o serviço reCAPTCHA para habilitar:

Configurar o reCAPTCHA Enterprise steps-to-implement-reCAPTCHA-enterprise-in-forms-core-components

  1. Crie ou selecione um projeto do Google Cloud e habilite a API corporativa do reCAPTCHA.

  2. Obtenha a ID do Projeto e crie uma chave de API e uma chave de site para sites.

  3. Criar contêiner de configuração para serviços em nuvem.

    1. Vá para Ferramentas > Geral > Navegador de Configuração.

    2. Selecione uma pasta ou crie uma pasta e ative a pasta para configurações de nuvem seguindo estas etapas:

      1. No Navegador de Configuração, selecione a pasta e selecione Propriedades.
      2. Na caixa de diálogo Propriedades de Configuração, habilite Configurações de Nuvem.
      3. Selecione Salvar e fechar para salvar a configuração e sair da caixa de diálogo.
  4. Configure o serviço de nuvem para reCAPTCHA Enterprise.

    1. Na instância do autor do Experience Manager, vá para tools-1 > Cloud Service.
    2. Selecione reCAPTCHA. A página Configurações é aberta. Selecione o contêiner de configuração criado e selecione Criar.
    3. Selecione a versão como reCAPTCHA Enterprise e especifique o Nome, a ID do Projeto, a Chave do Site e a Chave da API (Obtida na Etapa 2) para o serviço reCAPTCHA Enterprise.
    4. Selecione o tipo de chave; o tipo de chave deve ser igual à chave do site que você configurou no projeto do Google Cloud, por exemplo, Chave do site da caixa de seleção ou Chave do site com base em pontuação.
    5. Especifique uma pontuação de limite no intervalo de 0 a 1. Pontuações maiores ou iguais às pontuações de limite identificam a interação humana, caso contrário, são consideradas interação de bot.
    6. Selecione Criar para criar a configuração do serviço de nuvem.

Quando o serviço reCAPTCHA Enterprise estiver ativado, ele estará disponível para uso em formulários adaptáveis. Consulte usando CAPTCHA em formulários adaptáveis.

Configurar o Google reCAPTCHA v2 steps-to-implement-reCAPTCHA-v2-in-forms

  1. Obtenha o par de chaves da API do reCAPTCHA da Google. Inclui uma chave do site e uma chave secreta.

    Criar configuração do Google reCAPTCHA do site da Google para obter chaves reCAPTCHA

  2. Crie o contêiner de configuração em seu ambiente as a Cloud Service do AEM Forms. Um Contêiner de configuração contém as Configurações de nuvem usadas para conectar o AEM a serviços externos. Para criar e configurar um Contêiner de configuração para conectar seu ambiente do AEM Forms com o serviço reCAPTCHA do Google:

    1. Abra a instância as a Cloud Service do AEM Forms.

    2. Vá para Ferramentas > Geral > Navegador de Configuração. No Navegador de configuração, é possível:

    3. Selecione uma pasta existente ou crie uma pasta. Você pode criar uma pasta e ativar a opção Configurações de nuvem para ela ou Ativar a opção Configurações de nuvem para uma pasta existente:

      • Para criar uma pasta e ativar a opção Configurações de nuvem para ela:

        1. No Navegador de Configuração, clique em Criar.
        2. Na caixa de diálogo Criar Configuração, especifique o nome, o título e selecione a opção Configurações de Nuvem.
        3. Clique em Criar
      • Para ativar a opção Configurações de nuvem para uma pasta existente:

        1. No Navegador de Configuração, selecione a pasta e selecione Propriedades.
        2. Na caixa de diálogo Propriedades de Configuração, habilite Configurações de Nuvem.
        3. Selecione Salvar e fechar para salvar a configuração e sair da caixa de diálogo.
  3. Configure o Cloud Service:

    1. Na instância do autor AEM, vá para tools-1 > Cloud Service e selecione reCAPTCHA.
    2. Selecione um Contêiner de configuração, criado ou atualizado na seção anterior. Selecione Criar.
    3. Especifique Título, Nome, Chave do Site e Chave Secreta para o serviço reCAPTCHA (Obtido na Etapa 1). Selecione Criar.

    Configure o Cloud Service para conectar seu ambiente do AEM Forms com o serviço reCAPTCHA da Google

    Depois que o serviço reCAPTCHA é configurado, ele é disponibilizado para uso em um Formulário adaptável. Para obter mais informações, consulte usando o Google reCAPTCHA em um Formulário adaptável.

Usar o Google reCAPTCHA em formulários adaptáveis

Usar o Google reCAPTCHA em um formulário adaptável using-reCAPTCHA

Para usar o reCAPTCHA no Adaptive Forms:

  1. Abra a instância as a Cloud Service do AEM Forms.

  2. Ir para Forms > Forms e Documentos.

  3. Selecione um Forms adaptável e selecione Propriedades. Para a opção Contêiner de Configuração, selecione o Contêiner de Configuração que contém a Configuração na Nuvem que conecta o AEM Forms com o serviço reCAPTCHA pelo Google e selecione Salvar e Fechar.

    Se você não tiver um Contêiner de Configuração como esse, consulte a seção Conecte seu ambiente do AEM Forms com o serviço reCAPTCHA do Google para saber como criar esse Contêiner de Configuração.

    Selecionar Contêiner de Configuração

  4. Selecione um Forms adaptável e selecione Editar. O Formulário adaptável é aberto no Editor Forms adaptável.

  5. No navegador de componentes, arraste e solte o componente Formulário adaptável reCAPTCHA no Formulário adaptável.

    note note
    NOTE
    • A validação do Google reCAPTCHA é sensível ao tempo e expira em cerca de dois minutos. Portanto, a Adobe recomenda colocar o componente Formulário adaptável reCAPTCHA antes do botão Enviar.
  6. Selecione o componente Formulário adaptável reCAPTCHA e selecione o ícone de propriedades Propriedades . Ele abre a caixa de diálogo de propriedades. Especifique as seguintes propriedades obrigatórias:

    • Nome: É possível identificar facilmente um componente de formulário com seu nome exclusivo no formulário e no editor de regras, mas o nome não deve conter espaços ou caracteres especiais.

    • Título: especifique um título para o widget CAPTCHA. O valor padrão é Captcha. Selecione Ocultar título se não quiser que o título seja exibido. Selecione Permitir Rich Text para o Título para editar seu título no formato rich text. Você também pode marcar seu título como Elemento de formulário não vinculado.

    • Configuração do CAPTCHA: Selecione uma configuração no menu suspenso Configurações para reCAPTCHA Enterprise ou reCAPTCHA v2 para apresentar a caixa de diálogo do Google reCAPTCHA para o formulário:

      1. Se você selecionar a versão reCAPTCHA Enterprise, o tipo de chave poderá ser caixa de seleção ou com base na pontuação. Ela será baseada na sua seleção ao configurar a chave do site para sites:

        note note
        NOTE
        • Na configuração da nuvem com tipo de chave como caixa de seleção, a mensagem de erro personalizada será exibida como uma mensagem embutida se a validação de captcha falhar.
        • Na configuração da nuvem com tipo de chave como baseado em pontuação, a mensagem de erro personalizada será exibida como uma mensagem pop-up se a validação de captcha falhar.

        1. Você pode selecionar o tamanho como **Normal** e **Compacto**.

      note note
      NOTE
      • Você pode ter várias configurações de nuvem no seu ambiente para fins semelhantes. Então, escolha o serviço com cuidado. Se nenhum serviço estiver listado, consulte Conecte seu ambiente do AEM Forms com o serviço reCAPTCHA do Google para saber como criar um Cloud Service que conecte seu ambiente do AEM Forms com o serviço reCAPTCHA do Google.
    • Tamanho do Captcha: Você pode selecionar o tamanho de exibição da caixa de diálogo de desafio do Google reCAPTCHA. Use a opção Compactar para exibir uma opção de tamanho pequeno e a opção Normal para exibir uma caixa de diálogo de desafio do Google reCAPTCHA de tamanho relativamente grande.
      Se você selecionar a versão reCAPTCHA v2:

      1. Você pode selecionar o tamanho como Normal ou Compacto para o widget re do reCAPTCHA.
      2. Você pode selecionar a opção Invisível para mostrar o desafio de CAPTCHA somente no caso de uma atividade suspeita.

    O serviço reCAPTCHA é ativado no formulário adaptável. Você pode visualizar o formulário e ver o CAPTCHA funcionando. O símbolo protegido pelo reCAPTCHA, exibido abaixo, é exibido nos formulários protegidos.

    Google protegido pelo selo reCAPTCHA

  7. Selecione Concluído.

    Agora, o protegido pelo reCAPTCHA é exibido no Formulário adaptável. Ele é exibido em todas as Forms adaptáveis configuradas para usar o serviço reCAPTCHA do Google.

    Agora, somente formulários legítimos, nos quais o preenchimento do formulário apaga com êxito o desafio imposto pelo serviço reCAPTCHA do Google, são permitidos para envio.

Perguntas frequentes

P: Posso usar mais de um componente Captcha em um Formulário adaptável?
Ans: Não há suporte para o uso de mais de um componente Captcha em um Formulário adaptável. Além disso, não é recomendável usar o componente Captcha em um fragmento ou painel marcado para carregamento lento.

Consulte também see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab