Preguntas frecuentes

¿Debo usar reCAPTCHA Enterprise?

reCAPTCHA Enterprise ofrece 1 millón de evaluaciones mensuales por funciones gratuitas y adicionales. Otras funciones, como las estadísticas en tiempo real, son el mejor punto de partida para la mayoría de los desarrolladores. Comienza gratis aquí.

¿Puedo usar reCAPTCHA con soluciones de terceros?

Sí, puedes usar reCAPTCHA (versión no empresarial) y reCAPTCHA Enterprise. Por lo general, la solución de terceros solicita tu clave pública y tu clave secreta o tu clave de API. Asegúrate de proporcionar tu clave secreta y clave de API solo a terceros de confianza.

Cómo migrar a reCAPTCHA Enterprise de la v2 o la v3

El proceso de migración demora entre 5 y 10 minutos en completarse y no requiere cambios en el código.

¿Debo usar reCAPTCHA v2 o v3?

reCAPTCHA v3 es adecuado para los propietarios de sitios que desean obtener más datos sobre su tráfico. Para obtener más información, consulta la guía para desarrolladores de reCAPTCHA v3.

Admitimos seguridad y usabilidad para la versión 2.

Para obtener más información sobre las diferencias entre reCAPTCHA v2 y v3, consulta la comparación de versiones.

¿Puedo ejecutar reCAPTCHA v2 y v3 en la misma página?

Para ello, carga la clave del sitio de la v3 como documented y, luego, procesa v2 de manera explícita con grecaptcha.render.

<html>
  <head>
    <title>reCAPTCHA demo: Running both v2 and v3</title>
    <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script>
    <script>
      grecaptcha.ready(() => {
        grecaptcha.render('html_element', {
           'sitekey' : 'v2_site_key'
        });
      });
    </script>
    <script>
      function onSubmit() {
        grecaptcha.ready(() => {
            grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => {
               ...
            });
        });
      }
    </script>
  </head>
</html>

¿reCAPTCHA usa cookies?

reCAPTCHA configura una cookie necesaria (_GRECAPTCHA) cuando se ejecuta a fin de proporcionar su análisis de riesgos. Si prefiere no usar el dominio www.google.com, que puede tener otras cookies configuradas, puede usar www.recaptcha.net.

¿Hay alguna QPS o límite diario para mi uso de reCAPTCHA?

Si deseas realizar más de 1,000 llamadas por segundo o 1,000,000 de llamadas por mes, debes usar reCAPTCHA Enterprise o llenar este formulario y esperar una aprobación de excepción. Si una clave de sitio supera los 1,000 QPS, es posible que no se procesen algunas solicitudes. Si una clave de sitio v3 excede su cuota mensual, es posible que el sitio_falle y se muestre con una puntuación estática de 0.9 y el mensaje de error “Se superó la cuota gratuita” durante el resto del mes. No hay indicaciones visibles para el usuario cuando los sitios de la versión 3 superen la cuota. Si una clave de sitio v2 supera su cuota mensual, es posible que se muestre el siguiente mensaje (o un mensaje similar) a los usuarios en el widget de reCAPTCHA durante el resto del mes: "Este sitio supera la cuota de reCAPTCHA". Antes de aplicar la cuota, los propietarios del sitio recibirán una notificación por correo electrónico tres veces y tendrán, al menos, 90 días para migrar a reCAPTCHA Enterprise. Las claves de sitios se consideran superadas en la cuota si se usan más de 1,000,000 de llamadas por mes para cualquier dominio. Esto incluye si este volumen se distribuye entre varias claves en el mismo dominio.

Quiero ocultar la insignia de reCAPTCHA. ¿Qué se permite?

Puedes ocultar la insignia siempre y cuando incluyas la marca reCAPTCHA visible en el flujo de usuarios. Incluya el siguiente texto:

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

Por ejemplo:

Nota: Si decides ocultar la insignia, usa 

.grecaptcha-badge { visibility: hidden; }
.

Me gustaría ejecutar pruebas automatizadas con reCAPTCHA. ¿Qué debo hacer?

En el caso de reCAPTCHA v3, crea una clave separada para probar los entornos. Es posible que las puntuaciones no sean precisas, ya que reCAPTCHA v3 depende del tráfico real.

Para reCAPTCHA v2, usa las siguientes claves de prueba. No recibirás CAPTCHA y se aprobarán todas las solicitudes de verificación.

  • Clave del sitio: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
  • Clave secreta: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

El widget de reCAPTCHA mostrará un mensaje de advertencia para garantizar que no se use en el tráfico de producción.

¿Cómo puedo obtener más información sobre el tráfico de mi sitio web?

reCAPTCHA informa las estadísticas diarias en la Consola del administrador.

¿Puedo usar reCAPTCHA en todo el mundo?

Sí, usar "www.recaptcha.net" en el código cuando no sea posible acceder a "www.google.com"

  • Primero, reemplace <script src="https://www.google.com/recaptcha/api.js" async defer></script> por <script src="https://www.recaptcha.net/recaptcha/api.js" async defer></script>
  • Luego, aplica lo mismo a todos los demás sitios que usen "www.google.com/recaptcha/" en tu sitio.

¿Puedo personalizar el widget o la insignia de reCAPTCHA?

Sí. reCAPTCHA ofrece dos temas (claro y oscuro), como se muestra a continuación. Para elegir un tema, solo debes configurar el atributo data-theme en el parámetro grecaptcha.render.

Tema claro:

Tema oscuro:

¿Cómo puedo personalizar reCAPTCHA v3?

La API de JavaScript disponible para reCAPTCHA invisible también funciona con la versión 3. Simplemente usa la API de JavaScript para representar explícitamente reCAPTCHA con una clave de sitio v3 para acceder a opciones como cambiar la posición de la insignia o cambiar el tema.

Cuando renderices reCAPTCHA v3 con este método, recuerda establecer el parámetro size en 'invisible' y usar el ID de cliente que muestra grecaptcha.render cuando llames a grecaptcha.execute en lugar de la clave del sitio.

Recientemente, mi widget reCAPTCHA comenzó a mostrar la "Clave de sitio no válida". ¿Qué sucede?

Si ves este error, tu clave de sitio de reCAPTCHA ya no es válida. Para activarla, registra una clave nueva y sigue las instrucciones que se muestran en esa página.

Recibo un mensaje SecurityError no detectado: Bloqueé un marco con origen "https://www.google.com" para que no pueda acceder a un marco con origen "&ltyour domain&gt". ¿Qué debo hacer?

Esto suele ocurrir si el elemento HTML del widget reCAPTCHA se quita de manera programática algún tiempo después de que el usuario final hace clic en la casilla de verificación. Te recomendamos que uses la función de JavaScript grecaptcha.reset() para restablecer el widget de reCAPTCHA.

Estoy usando Política de seguridad de contenido (CSP) en mi sitio web. ¿Cómo puedo configurarlo para que funcione con reCAPTCHA?

Recomendamos usar el enfoque basado en el nonce documentado con CSP3. Asegúrate de incluir tu nonce en la etiqueta de secuencia de comandos api.js de reCAPTCHA, y nosotros nos encargaremos del resto.

Nota: reCAPTCHA también funciona con 'strict-dynamic' en los navegadores que lo admiten.

También puedes agregar los siguientes valores a las directivas:

  • script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
  • frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/

Aparece el error “El host local no está en la lista de dominios compatibles”. ¿Qué debo hacer?

Los dominios localhost no son compatibles de forma predeterminada. Si deseas continuar ofreciéndoles asistencia para el desarrollo, puedes agregarlos a la lista de dominios compatibles de tu clave de sitio. Ve a la consola de reCAPTCHA Enterprise o a la consola de reCAPTCHA, según corresponda, para actualizar la lista de dominios compatibles. Recomendamos usar claves separadas para el desarrollo y la producción, y solo para permitir localhost en la clave del sitio de desarrollo.

Solo en iOS 10, la página se desplaza hacia la parte inferior cuando el usuario completa el desafío.

Es un error específico de Apple que les informamos. Solo afecta a los usuarios de iOS 10 y algunos sitios. Si te ves afectado, una alternativa es mover el widget reCAPTCHA a una posición más alta o más baja en la página, o bien usar reCAPTCHA v3.

¿Es posible que mi computadora o red estén enviando consultas automáticas?

Si se te redirigió a esta página desde el widget reCAPTCHA, habrías visto el mensaje "Lo sentimos, pero tu computadora o red pueden estar enviando consultas automatizadas. Para proteger a nuestros usuarios, no podemos procesar tu solicitud en este momento".

Esto puede ocurrirles a los usuarios buenos por varios motivos:

  • Es posible que estés en una red compartida que se esté usando de forma abusiva.
  • Es posible que tu proveedor de servicios de Internet te haya asignado una dirección IP sospechosa recientemente
  • Es posible que el sitio al que intentas acceder esté actualmente bajo ataques pesados

Para solucionar estos problemas, consulta la página de ayuda de tráfico inusual o vuelve a intentarlo más tarde.

¿Qué nombres de acciones son válidos?

Las acciones pueden contener solo caracteres alfanuméricos, barras diagonales y guiones bajos. Las acciones no deben ser específicas del usuario.