Ir al contenido

Esta página es una traducción automática de la página en inglés, que es la versión de referencia. Leer la página en inglés

Protección contra bots con CAPTCHA (Turnstile / hCaptcha / reCAPTCHA)

El CAPTCHA está desactivado por defecto: el ajuste captcha es none. Las páginas de inicio de sesión, registro y restablecimiento de contraseña no envían entonces nada a terceros. Cuando eliges un servicio de CAPTCHA, el widget del servicio aparece en tres formularios: inicio de sesión (/auth/sign_in), registro (/auth/sign_up) y la solicitud de un enlace de restablecimiento de contraseña (/auth/forgot_password, solo en servidores que envían correo). El servidor verifica el token que produce el widget con la API siteverify del servicio. No se puede proteger solo algunos de los formularios.

captcha Servicio Costo Qué hace el usuario
turnstile (recomendado) Cloudflare Turnstile Gratuito, sin límite Normalmente nada; una casilla solo cuando hace falta
hcaptcha hCaptcha Tiene un nivel gratuito Una casilla, y un desafío con imágenes cuando hace falta
recaptcha Google reCAPTCHA v2 (casilla) Gratuito hasta 10 000 evaluaciones al mes (consulta más abajo) Una casilla, y un desafío con imágenes o audio cuando hace falta

reCAPTCHA v3 (solo puntuación) y reCAPTCHA Enterprise no son compatibles.

Cada servicio te da un par de claves: una clave del sitio pública y una clave secreta que solo tiene el servidor. Registra como dominio el nombre de host de la configuración host (sin el puerto). El servidor rechaza un token cuando el nombre de host de la respuesta de siteverify no coincide con host.

  • Turnstile: en el panel de Cloudflare, añade un widget en «Turnstile» y registra el nombre de host. Elige el modo de widget «Managed».
  • hCaptcha: añade un sitio en el panel de hCaptcha y registra el nombre de host. La clave secreta está en la configuración de la cuenta.
  • reCAPTCHA: en la consola de administración de Google reCAPTCHA, elige el tipo «Challenge (v2)» con la casilla «I’m not a robot» y registra el dominio. Las claves pertenecen a un proyecto de Google Cloud.

Las claves de prueba de cada servicio (las que siempre tienen éxito) sirven para comprobar que el widget aparece y produce un token. Sin embargo, siteverify con claves de prueba devuelve un nombre de host fijo (example.com para Turnstile, dummy-key-pass para hCaptcha, etc.), así que el inicio de sesión y el registro en este servidor fallan con «Completa la comprobación de que no eres un bot e inténtalo de nuevo.» si las usas.

Ventana de terminal
MY_CAPTCHA=turnstile
MY_CAPTCHA_SITE_KEY=0x4AAAAAAA...
MY_CAPTCHA_SECRET_KEY_FILE=/run/secrets/my_captcha_secret_key
  • Pasa la clave secreta solo mediante la variable de entorno MY_CAPTCHA_SECRET_KEY o mediante MY_CAPTCHA_SECRET_KEY_FILE, que apunta a un archivo. Los registros muestran [REDACTED].
  • Si eliges un captcha y falta una clave, my config check informa de un problema y el servidor no arranca.
  • El servidor no prueba las claves al arrancar. Cuando el servicio rechaza la clave secreta o la clave del sitio, la primera verificación registra el ERROR «the CAPTCHA service refused the secret key or the site key». Hasta que lo arregles, las peticiones se tratan como en «Cuando el servicio no está disponible», más abajo.
  • Los cambios surten efecto cuando reinicias el servidor.
  • El orden es: límite de frecuencia, después verificación de CAPTCHA, después comprobación de la contraseña, procesamiento del registro o envío del correo de restablecimiento. Una petición que supera el límite de frecuencia nunca se envía al servicio.
  • Un registro con un código de invitación válido también se verifica.
  • Un inicio de sesión que no supera la verificación cuenta como un inicio de sesión fallido para la dirección IP del cliente. No cuenta contra la cuenta, de modo que nadie puede bloquear a otra persona. Un registro que no supera la verificación cuenta como un intento de registro (consulta el límite de frecuencia en registro). Una solicitud de enlace de restablecimiento cuenta como un intento de solicitud del mismo modo.
  • En Turnstile, el widget lleva un nombre de acción (sign_in / sign_up / password_reset) y el servidor comprueba que la respuesta tiene la misma acción. Un token de un formulario no se puede usar en otro.
  • El servidor no envía al servicio la dirección IP del usuario (remoteip). Un token es de un solo uso, así que el servidor no reintenta. El tiempo de espera es de 10 segundos.

El servicio no se puede alcanzar, agota el tiempo de espera, devuelve un 5xx o rechaza las claves:

Formulario Tratamiento
Registro y solicitud de un enlace de restablecimiento Se rechaza (503) con «La comprobación de que no eres un bot no está disponible ahora. Inténtalo más tarde.». De lo contrario, los bots podrían provocar correos y registros.
Inicio de sesión Se deja pasar sin CAPTCHA, y el servidor registra el WARN «the CAPTCHA service could not check a sign-in; letting it through». El límite de frecuencia y la comprobación de la contraseña se siguen aplicando.

El inicio de sesión se deja pasar para que una caída del servicio o una clave incorrecta no bloquee a todos, administradores incluidos. Si el WARN sigue apareciendo, comprueba el estado del servicio y las claves.

Por encima del nivel gratuito de 10 000 evaluaciones al mes, el siteverify de reCAPTCHA siempre tiene éxito (así que CAPTCHA no ofrece protección en ese tiempo). El servidor no puede detectar el exceso, así que comprueba tu uso en la consola de Google Cloud.

  • El idioma del widget sigue el idioma de la página y su tema sigue el esquema de color del navegador (claro u oscuro). El widget de Turnstile sigue el esquema de color por sí mismo. hCaptcha y reCAPTCHA se eligen con la pista de cliente Sec-CH-Prefers-Color-Scheme, que envía el navegador; los navegadores que no la envían reciben el tema claro.
  • Junto al widget, la página dice qué servicio realiza la comprobación, que el servicio recibe la dirección IP y la información del navegador, y enlaza a la política de privacidad del servicio (y a los términos de hCaptcha y reCAPTCHA). Para reCAPTCHA esto sirve también como la frase que exige Google: «This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.»
  • Una persona que no puede resolver el CAPTCHA no puede registrarse ni iniciar sesión, y solo puedes ayudarla por otros medios, como crear la cuenta con my admin create o definir captcha = none durante un tiempo.
  • La Content-Security-Policy (CSP) se amplía solo en las páginas de inicio de sesión, registro y solicitud de restablecimiento de contraseña mientras el CAPTCHA está activado. Nunca se añaden 'unsafe-inline' ni 'unsafe-eval'. La CSP del cliente web, la API de cliente, la pantalla de consentimiento, la confirmación de correo y otras páginas no cambia.
captcha Orígenes añadidos
turnstile script-src, frame-src: https://challenges.cloudflare.com
hcaptcha script-src, frame-src, style-src, connect-src: https://hcaptcha.com, https://*.hcaptcha.com
recaptcha 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/

Si un proxy inverso o una CDN delante del servidor sobrescribe la CSP, añade los mismos orígenes para estas tres páginas.

Con CAPTCHA activado, el navegador de cualquiera que abra la página de inicio de sesión, de registro o de solicitud de restablecimiento de contraseña se conecta directamente al servicio, y el servicio recibe la dirección IP, la información del navegador y las cookies. La política de privacidad de la instancia (my instance set privacy_policy, consulta configuración de la instancia) la escribes tú; el servidor no le añade nada. La plantilla de política de privacidad tiene una fila para el servicio. Escribe al menos lo siguiente.

  • Qué servicio (el nombre del proveedor) usas y por qué: para evitar solicitudes automatizadas de inicio de sesión, registro y restablecimiento de contraseña.
  • Qué llega al servicio (dirección IP, información del navegador y del dispositivo, cookies, interacciones con el widget), y que solo lo envían las páginas de inicio de sesión, registro y solicitud de restablecimiento de contraseña.
  • Un enlace a la política de privacidad del servicio (Turnstile: https://www.cloudflare.com/privacypolicy/, hCaptcha: https://www.hcaptcha.com/privacy, reCAPTCHA: https://policies.google.com/privacy).
  • En reCAPTCHA, que se aplican la política de privacidad y los términos de Google (https://policies.google.com/terms).

Para LLM y agentes de programación:llms.txt,llms-full.txt, llms-small.txt

Analítica de este sitio