Criar chaves reCAPTCHA para sites

Admin Console

1. Acesse o Admin Console do reCAPTCHA.

   Acessar o Admin Console do reCAPTCHA

2. No campo Rótulo, insira um nome que possa ser usado para identificar seu site.
3. Se quiser criar uma chave baseada em pontuação, selecione Com base em pontuação (v3). Se quiser criar uma chave de caixa de seleção, selecione Desafio (v2).
4. Para adicionar um domínio, digite o nome dele e clique em add .

   Para adicionar outro domínio, repita essa etapa. É possível adicionar até 250 domínios.

5. Se você não conhece o console Google Cloud , leia os Termos de Serviço e marque a caixa de seleção.
6. Clique em Enviar.

Se você não conhece o Google Cloud console, um projeto Google Cloud será criado e as APIs necessárias serão ativadas para você começar. Se você já tem um projeto do Google Cloud , as APIs necessárias estão ativadas para que você possa começar.

Console do Cloud

1. No console Google Cloud , acesse a página reCAPTCHA.

   Acessar o reCAPTCHA

2. Verifique se o nome do projeto aparece no seletor de recursos, na parte superior da página.

   Se você não vir o nome do projeto, clique no seletor de recursos para selecioná-lo.

3. Clique em Criar chave.
4. No campo Nome de exibição, insira um nome de exibição para a chave.
5. Em Tipo de aplicativo, selecione Web.

   A seção Lista de domínios é exibida.

6. Insira o nome do domínio do seu site:

   1. Na seção Lista de domínios, clique em Adicionar um domínio.
   2. No campo Domínio, digite o nome do seu domínio.

   3. Opcional: para adicionar outro domínio, clique em Adicionar um domínio e digite o nome de outro domínio no campo Domínio. É possível adicionar até 250 domínios.

      Para sites, a chave reCAPTCHA é exclusiva para os domínios e subdomínios especificados. É possível especificar mais de um domínio caso seu site seja veiculado em vários. Se você especificar um domínio (por exemplo, examplepetstore.com), não precisará especificar os subdomínios (por exemplo, subdomain.examplepetstore.com).

      Para usar uma chave em mais de 250 domínios, clique na chave Desativar verificação de domínio. O reCAPTCHA vai ignorar a lista de domínios. Você precisa fazer a verificação de domínio por conta própria examinando o campo tokenProperties.hostname nas avaliações que criar.

7. Dependendo do tipo de chave reCAPTCHA que você quer criar para seu site, execute a ação adequada:

Criar chaves reCAPTCHA baseadas em pontuação

1. Para proteger a chave do reCAPTCHA para seu domínio e subdomínios, verifique se a opção Desativar verificação de domínio está desativada.

   Desativar a verificação de domínio é um risco para a segurança porque não há restrições no site, então sua chave reCAPTCHA pode ser acessada e usada por qualquer pessoa.

2. Se você quiser permitir que a chave baseada em pontuação funcione com Accelerated Mobile Pages (AMP), ative a opção Permitir que esta chave funcione com páginas AMP.

3. Para seu ambiente de não produção, se você quiser especificar uma pontuação que a chave retorne quando qualquer avaliação for criada para ela, faça o seguinte:

   1. Clique em Próxima etapa (opcional).
   2. Na etapa "Configurações adicionais", clique na opção Você está criando esta chave apenas para fins de teste?.
   3. Use o controle deslizante Definir pontuação para especificar uma pontuação entre 0 e 1,0.
4. Clique em Criar chave.

A chave recém-criada é listada na página Chaves reCAPTCHA.

Criar chaves reCAPTCHA com caixa de seleção

1. Para proteger a chave do reCAPTCHA para seu domínio e subdomínios, verifique se a opção Desativar verificação de domínio está desativada.

   Desativar a verificação de domínio é um risco para a segurança porque não há restrições no site, então sua chave reCAPTCHA pode ser acessada e usada por qualquer pessoa.

2. Clique em Próxima etapa (opcional).
3. Na etapa "Configurações adicionais", ative a opção Você vai usar desafios? alternar.
4. Selecione a opção de Teste de segurança apropriada.

   A opção de teste de segurança controla a probabilidade de um usuário receber um teste secundário, em que os usuários precisam selecionar imagens com base em uma categoria identificada. Por exemplo, selecionar as imagens com uma motocicleta ou escadas.

   Se você quiser garantir a melhor proteção antifraude, selecione Difícil.

   Se você selecionar Fácil, a probabilidade de receber o teste visual será menor.

5. Para seu ambiente de não produção, se você quiser especificar uma pontuação que a chave retorne quando qualquer avaliação for criada para ela, faça o seguinte:

   1. Clique na opção Você está criando esta chave apenas para fins de teste?.
   2. Use o controle deslizante Definir pontuação para especificar uma pontuação entre 0 e 1,0.
   3. Selecione a opção de Tipo de teste adequada.
      • O Auto mostra o desafio às vezes.
      • Sem CAPTCHA não mostra um desafio.
      • Desafio sem solução mostra as imagens, mas o desafio não é concluído.
   4. Clique em Criar chave.

   A chave recém-criada é listada na página Chaves reCAPTCHA.

gcloud

Para criar chaves do reCAPTCHA, use o comando gcloud recaptcha keys create.

Antes de usar os dados do comando abaixo, faça estas substituições:

• DISPLAY_NAME: nome da chave. Geralmente, um nome de site.
• INTEGRATION_TYPE: tipo de integração. Dependendo do tipo de chaves, especifique os seguintes valores:
  • score para chaves baseadas em pontuação.
  • checkbox para chaves de caixa de seleção.
• DOMAIN_NAME: domínios ou subdomínios de sites que podem usar a chave.

  Para especificar vários domínios, use um formato de lista separada por vírgulas.

  Para usar uma chave em mais de 250 domínios, especifique --allow-all-domains para desativar a verificação de domínio. O reCAPTCHA vai ignorar a lista de domínios. Você precisa fazer a verificação de domínio por conta própria examinando o campo tokenProperties.hostname nas avaliações que criar.

  Desativar a verificação de domínio é um risco para a segurança porque não há restrições no site, então sua chave reCAPTCHA pode ser acessada e usada por qualquer pessoa.

Execute o comando gcloud recaptcha keys create:

gcloud recaptcha keys create \
        --web \
        --display-name=DISPLAY_NAME  \
        --integration-type=INTEGRATION_TYPE \
        --domains=DOMAIN_NAME

gcloud recaptcha keys create `
        --web `
        --display-name=DISPLAY_NAME  `
        --integration-type=INTEGRATION_TYPE `
        --domains=DOMAIN_NAME

gcloud recaptcha keys create ^
        --web ^
        --display-name=DISPLAY_NAME  ^
        --integration-type=INTEGRATION_TYPE ^
        --domains=DOMAIN_NAME

A resposta contém a chave reCAPTCHA recém-criada.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• DISPLAY_NAME: nome da chave. Geralmente, um nome de site.
• INTEGRATION_TYPE: tipo de integração. Dependendo do tipo de chaves, especifique os seguintes valores:
  • score para chaves baseadas em pontuação.
  • checkbox para chaves de caixa de seleção.
• DOMAIN_NAME: domínios ou subdomínios de sites que podem usar a chave.

  Para especificar vários domínios, use um formato de lista separada por vírgulas.

  Para usar uma chave em mais de 250 domínios, especifique --allow-all-domains para desativar a verificação de domínio. O reCAPTCHA vai ignorar a lista de domínios. Você precisa fazer a verificação de domínio por conta própria examinando o campo tokenProperties.hostname nas avaliações que criar.

  Desativar a verificação de domínio é um risco para a segurança porque não há restrições no site, então sua chave reCAPTCHA pode ser acessada e usada por qualquer pessoa.

Método HTTP e URL:

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys

Corpo JSON da solicitação:

{
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "TYPE_OF_INTEGRATION"
  }
}

Para enviar a solicitação, escolha uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/project-id/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowAllDomains": false,
    "allowedDomains": [
      DOMAINS
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}