Preguntas frecuentes

¿Debo usar reCAPTCHA Enterprise?

reCAPTCHA Enterprise ofrece hasta 10,000 evaluaciones por mes sin costo y también proporciona funciones adicionales. Otras funciones, como las estadísticas en tiempo real, proporcionan el mejor punto de partida para la mayoría de los desarrolladores. Comienza aquí.

¿Puedo usar reCAPTCHA con soluciones de terceros?

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

¿Cómo migrar a reCAPTCHA Enterprise desde la versión 2 o 3?

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

¿Debo usar reCAPTCHA v2 o v3?

reCAPTCHA v3 es 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 la seguridad y la 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.

¿reCAPTCHA usa cookies?

reCAPTCHA establece una cookie necesaria (_GRECAPTCHA) cuando se ejecuta con el propósito de proporcionar su análisis de riesgos. Si prefieres no usar el dominio www.google.com, que puede tener otras cookies configuradas, puedes usar www.recaptcha.net en su lugar.

¿Existen límites diarios o de QPS para mi uso de reCAPTCHA?

Si quieres realizar más de 1,000 llamadas por segundo o 1,000,000 de llamadas por mes, debes usar reCAPTCHA Enterprise o completar este formulario y esperar a que se apruebe una excepción. Si una clave de sitio supera las 1,000 QPS, es posible que no se procesen algunas solicitudes. Si una clave de sitio de la versión 3 supera su cuota mensual, es posible que `site_verify` falle y se abra devolviendo una puntuación estática de 0.9 y un mensaje de error `"Over free quota."` durante el resto del mes. No hay indicaciones visibles para el usuario cuando los sitios de la versión 3 superan la cuota. Si una clave de sitio de la versión 2 supera su cuota mensual, es posible que se muestre el siguiente mensaje o uno similar a los usuarios en el widget de reCAPTCHA durante el resto del mes: "Este sitio supera la cuota de reCAPTCHA". Antes de que se aplique la cuota, se notificará a los propietarios del sitio por correo electrónico tres veces y se les dará al menos 90 días para migrar a reCAPTCHA Enterprise. Se considera que las claves de sitio superan 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 en varias claves del mismo dominio.

Me gustaría ocultar la insignia de reCAPTCHA. ¿Qué se permite?

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

This site is protected by reCAPTCHA.

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 independiente para los entornos de pruebas. Es posible que las puntuaciones no sean precisas, ya que reCAPTCHA v3 se basa en el tráfico real.

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

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

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

¿Cómo puedo evitar entrar en el código de reCAPTCHA cuando depuro mi sitio?

Para evitar ingresar al código de reCAPTCHA mientras depuras otro JavaScript en tu sitio, agrega la secuencia de comandos de reCAPTCHA /recaptcha__.+\.js$ a la lista de elementos ignorados de tu navegador. Para obtener instrucciones para Chrome, consulta Ignora una lista personalizada de secuencias de comandos. Hay funciones similares disponibles en otros navegadores.

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

reCAPTCHA informa estadísticas diarias en la consola del administrador.

¿Puedo usar reCAPTCHA en todo el mundo?

Sí, usa "www.recaptcha.net" en tu código cuando no se pueda acceder a "www.google.com".

  • Primero, reemplaza <script src="https://www.google.com/recaptcha/api.js"></script> por <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
  • Después de eso, aplica lo mismo en todos los demás lugares 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, simplemente establece 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 para la versión 3. Solo usa la API de JavaScript para renderizar de forma explícita reCAPTCHA con una clave de sitio de la versión 3 para acceder a opciones como cambiar la posición de la insignia o 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 de sitio.

Hace poco, mi widget de reCAPTCHA comenzó a mostrar el mensaje "Clave de sitio no válida". ¿Qué sucede?

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

Recibo un SecurityError no detectado: se bloqueó un marco con el origen "https://www.google.com" para que no acceda a un marco con el origen "<tu dominio>". ¿Qué debo hacer?

Por lo general, esto ocurre si el elemento HTML del widget de reCAPTCHA se quita de forma programática en algún momento 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.

Uso la Política de Seguridad del Contenido (CSP) en mi sitio web. ¿Cómo puedo configurarlo para que funcione con reCAPTCHA?

Recomendamos usar el enfoque basado en 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 compatibles.

Como alternativa, agrega 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/
  • connect-src https://www.google.com/recaptcha/

Aparece el mensaje de error "Localhost no está en la lista de dominios admitidos". ¿Qué debo hacer?

Los dominios localhost no se admiten de forma predeterminada. Si quieres seguir admitiéndolos para el desarrollo, puedes agregarlos a la lista de dominios admitidos para 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 admitidos. Te recomendamos que uses claves independientes para el desarrollo y la producción, y que solo permitas localhost en la clave de tu sitio de desarrollo.

¿Solo en iOS 10, la página se desplaza hacia abajo cuando el usuario completa el desafío?

Este es un error de enfoque de Apple que ya informamos. Solo afecta a los usuarios de iOS 10 y solo en algunos sitios. Si te afecta, una solución alternativa es mover el widget de reCAPTCHA más arriba o más abajo en la página, o usar reCAPTCHA v3.

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

Si se te redireccionó a esta página desde el widget de reCAPTCHA, es posible que hayas visto un mensaje que decía "Lo sentimos, pero es posible que tu computadora o red estén enviando consultas automáticas. Para proteger a nuestros usuarios, no podemos procesar tu solicitud en este momento".

Lamentablemente, esto puede ocurrirles a los usuarios legítimos por algunos motivos:

  • Es posible que estés en una red compartida que se está usando de forma inadecuada
  • Es posible que tu proveedor de servicios de Internet te haya asignado recientemente una dirección IP sospechosa.
  • Es posible que el sitio al que intentas acceder esté sufriendo un ataque masivo en este momento

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

¿Qué nombres de acciones son válidos?

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