DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Conecte seu ambiente do AEM Forms com o Turnstile connect-your-forms-environment-with-turnstile-service

Last update: Wed Feb 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
  • Desenvolvedor

Esse recurso faz parte do programa de adoção antecipada. Você pode escrever para aem-forms-ea@adobe.com da sua ID de email oficial para ingressar no programa de adoção antecipada e solicitar acesso ao recurso.

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:

Integrar o ambiente do AEM Forms com o Captcha de tartaruga

O Captcha de torniquete da Cloudflare é uma medida de segurança que visa proteger formulários e sites contra bots automatizados, ataques mal-intencionados, spams e tráfego automatizado indesejado. Ele apresenta uma caixa de seleção no envio do formulário para verificar se ele é humano, antes de permitir que ele envie o formulário. O AEM Forms as a Cloud Service é compatível com o Captcha de tarja nos componentes principais adaptáveis do Forms.

Pré-requisitos para integrar o ambiente do AEM Forms com o Captcha giratório prerequisite

Para configurar o Turnstile para os Componentes principais do AEM Forms, obtenha a Chave de site e a chave secreta do site do Turnstile.

Configurar título steps-to-configure-hcaptcha

Para integrar o AEM Forms ao serviço de Borboleta, execute as seguintes etapas:

  1. Crie um Contêiner de configuração em seu ambiente AEM Forms as a Cloud Service. 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 Turnstile, siga as etapas fornecidas abaixo:

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

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

    3. No Navegador de configuração, crie uma nova pasta e ative as Configurações de nuvem para ela ou ative as Configurações de nuvem para uma pasta existente, conforme explicado abaixo:

      • Para criar uma nova pasta e habilitar as Configurações de Nuvem para ela, siga estas etapas:

        1. No Navegador de Configuração, clique em Criar.
        2. Na caixa de diálogo Criar Configuração, especifique um nome, título e selecione a opção Configurações de Nuvem.
        3. Clique em Criar.

      • Para habilitar a opção Configurações de Nuvem para uma pasta existente:

        1. No Navegador de Configuração, selecione a pasta existente e clique em Propriedades.
        2. Na caixa de diálogo Propriedades de Configuração, habilite Configurações de Nuvem.
        3. Clique em Salvar e fechar para salvar a configuração e sair.

  2. Configure o Cloud Service:

    1. Na instância do autor do AEM, vá para tools-1 > Cloud Services e clique em Girar.

      Borboleta na interface do usuário

    2. Selecione um Contêiner de configuração, criado ou atualizado, conforme descrito na seção anterior. Selecione Criar.

      Estrutura de configuração

    3. Especifique Tipo de Widget como gerenciado, não interativo ou invisível. Para saber mais sobre o Tipo de Widget, visite Widget de Turnstile.

    4. Especifique Título, Nome, Chave do Site e Chave Secreta para o serviço de Borracha obtido no pré-requisito.

    5. Clique em Criar.

      Configure o Cloud Service para conectar seu ambiente do AEM Forms com o Turnstile

    note note
    NOTE
    Os usuários não precisam modificar o URL de validação do JavaScript do lado do cliente e o URL de validação do lado do servidor, pois já estão pré-preenchidos para validação do módulo de montagem.

    Após configurar o serviço Captcha com estrutura de rotação, ele estará disponível para uso em um Formulário adaptável com base nos Componentes principais.

Usar a estrutura giratória em um formulário adaptável using-turnstile-core-components

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

  2. Ir para Forms > Forms e Documentos.

  3. Selecione o formulário adaptável e clique em Propriedades. Na seçã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 Turnstile.

  4. Clique em Salvar e fechar.

    Se você não tiver um Contêiner de Configuração, consulte a seção Configurar Módulo para saber como criar um Contêiner de Configuração.

    Selecionar Contêiner de Configuração

  5. Selecione um Formulário adaptável e clique em Editar para abrir um formulário no editor.

  6. No navegador de componentes, arraste e solte ou adicione o componente EIXO do formulário adaptável no formulário adaptável.
    Adicionar componente captcha de tartaruga

  7. Selecione o componente Estrutura de formulário adaptável e clique no ícone de propriedades ícone de Propriedades . Ele abre a caixa de diálogo de propriedades. Especifique as seguintes propriedades:

    Turnstile v2

    • Nome: Especifique o nome do componente Captcha. Você pode identificar facilmente um componente de formulário com seu nome exclusivo no formulário e no editor de regras.

    • Título: Especifique o título para o componente Captcha. você pode permitir Rich Text para o título e também pode ocultar o título marcando as caixas de seleção.

    • Configurações: Selecione uma Configuração na Nuvem configurada para o serviço Captcha de Borboleta.

      note note
      NOTE
      • Você pode ter várias configurações de nuvem no seu ambiente para uma finalidade semelhante. Então, escolha o serviço com cuidado. Se nenhum serviço estiver listado, consulte a seção Configurar Turnstile para saber como criar um Contêiner de Configuração para conectar seu ambiente do AEM Forms com o serviço Turnstile.

    • Validação: Forneça a validação de Captcha na forma de uma mensagem de erro:

      • Mensagem de Erro: Forneça a mensagem de erro a ser exibida ao usuário quando o envio do Captcha falhar.

        note note
        NOTE
        • Uma mensagem de erro será exibida somente se o CAPTCHA for preenchido no lado do cliente.

  8. Clique em Concluído.

Agora, somente formulários legítimos, em que o preenchimento de formulário apaga com êxito o desafio imposto pelo serviço de Borboleta, são permitidos para o envio do formulário.

Desafio de tartaruga

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 um componente Captcha em um fragmento ou painel marcado para carregamento lento.

Consulte também see-also

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