Nuestra integración con Cloudflare utiliza la solución de código de borde de Cloudflare Cloudflare Workers para ofrecerle un servicio de sala de espera que funciona directamente desde su CDN sin necesidad de que realice ningún cambio en el código de su aplicación ni en sus servidores web.

Introducción

Este artículo le guiará a través de los cuatro pasos necesarios para integrar CrowdHandler con Cloudflare.

Si en algún momento de la guía te quedas atascado o tienes alguna pregunta, no dudes en ponerte en contacto con nosotros a través de https://www.crowdhandler.com.

Requisitos previos

  1. Una cuenta CrowdHandler activa. Si aún no te has registrado, puedes hacerlo aquí.
  2. Una cuenta de Cloudflare.
  3. The domain you intend to protect should be configured as "Proxied" in Cloudflare. DNS only mode will not work.

Paso 1: Crear un Cloudflare Worker.

  1. Inicie sesión en su cuenta de Cloudflare.
  2. Seleccione uno de sus sitios web:
  3. Seleccione Rutas de los trabajadores Menú de navegación a la izquierda
  4. Hay un botón "Gestionar trabajadores" en la parte superior derecha de la página, haga clic en él y continúe con el siguiente paso.


  5. En la parte superior derecha, haga clic en el botón "Crear aplicación"


  6. En esta página, hay un botón en el centro "Crear trabajador", haga clic en él y continúe.

     
  7. Ahora puedes establecer el nombre de tu trabajador, ponlo en crowdhandler-integration
    Nota: No se puede cambiar el código todavía. Es sólo una configuración básica de los trabajadores.


  8. Proceda a crear el trabajador haciendo clic en "Desplegar"


  9. Ahora, apliquemos la integración del código pulsando "Editar código"
  10. Puedes ver el código predeterminado de Hola Mundo

  11. Copie nuestro código de integración de GitHub y pégalo en el script.


  12. Haga clic en el botón Guardar y desplegar.



Paso 2: Configurar las variables del trabajador.

  1. Pulsa el botón Atrás en la página de edición del script.



  2. Vaya a Configuración -> Variables.

  • Añada las siguientes variables y haga clic en guardar y desplegar.
    1. API_ENDPOINT = https://api.crowdhandler.com/v1
    2. CLAVE_API = SU_CLAVE_PÚBLICA_AQUÍ (Se puede encontrar en la sección Cuenta -> API del panel de control de administración de CrowdHandler).
    3. (Opcional ) WHITELABEL = falso ( por defecto) | true
    4. (Opcional ) NO_BYPASS = TU_TOKEN_ALEATORIO_AQUÍ
    5. (Opcional ) FAIL_TRUST = falso(por defecto) | verdadero
    6. (Opcional ) SAFETY_NET_SLUG = SU_SLUG_DE_SALA_DE_ESPERA_AQUÍ

VARIABLES OPCIONALES

WHITELABEL (por defecto false) Por defecto, los usuarios se pondrán en cola en el dominio wait.crowdhandler.com de CrowdHandler. Si WHITELABEL se establece en true, los usuarios se pondrán en cola en el dominio que CrowdHandler está protegiendo. Por ejemplo, si CrowdHandler ha sido configurado para proteger www.example.com, los usuarios serán puestos en cola en la ruta www.example.com/ch/. No es necesario que la ruta /ch/ exista en su aplicación. 
Lea más sobre salas de espera con etiqueta blanca aquí.

El valor NO_BYPASS se enviará a su origen como el valor de la cabecera x-ch-no-bypass. Puede comprobar este encabezado en su aplicación para verificar que la solicitud ha pasado por CrowdHandler. Puede encontrar ejemplos de implementación en la sección "Ejemplos de integración" de este artículo.

FAIL_TRUST (por defecto true) Por defecto, los usuarios que no se registren con la API de CrowdHandler serán de confianza. Si se establece en false, los usuarios que no se registren con la API de CrowdHandler serán enviados a una sala de espera de red de seguridad hasta que CrowdHandler pueda tomar una decisión sobre qué hacer con ellos.
Lea más sobre Trust on Fail aquí.

Si se define SAFETY_NET_SLUG y FAIL_TRUST se establece en false, esta sala de espera slug se utilizará como sala de red de seguridad. Si no se define un valor de SAFETY_NET_SLUG y FAIL_TRUST se establece en false, se utilizará una plantilla de sala de espera genérica como sala de red de seguridad. 

Puede encontrar el slug de su sala de espera en el panel de control de CrowdHandler, en el campo URL de la configuración de su sala.

Paso 3: Configurar rutas protegidas.

  1. En el menú de navegación de la izquierda, haga clic en Sitios web y, a continuación, en el dominio en el que está integrando CrowdHandler.

  2. Utilizando de nuevo la navegación de la izquierda, seleccione Rutas para trabajadores

  3. Añada la ruta que desea proteger.
El patrón anterior activará el trabajador CrowdHandler para todas las rutas de su sitio, excepto para las rutas excluidas que configure en el siguiente paso. Recomendamos comenzar con este patrón a menos que esté seguro de que su sitio no se inundará con tráfico a rutas no protegidas.

Puede realizar configuraciones de rutas de sala de espera más detalladas a través de la consola de administración de CrowdHandler.

Paso 4: Excluir rutas.

  1. Excluya las rutas que no deben tener protección CrowdHandler añadiendo rutas adicionales seleccionando "Ninguna" en el desplegable del trabajador.

CrowdHandler no intentará automáticamente poner en cola rutas con las siguientes extensiones de archivo. 

"avi","css","csv","eot","gif","ico","jpg","js","json","map","mov","mp4","mpeg","mpg","ogg","ogv","ott","pdf","png","svg","ttf","webmanifest","wmv","woff","woff2","xml".

Es su responsabilidad omitir los patrones y rutas que no deban ponerse en cola. 

Algunos ejemplos comunes son:

* Rutas utilizadas para almacenar activos estáticos y multimedia, por ejemplo /wp-includes/*.
* URL de devolución de llamada realizadas por proveedores de pago de terceros. 
* JSON y canales RSS.

Paso 5: Finalice la configuración.

CrowdHandler está integrado con su cuenta de Cloudflare y ahora le toca a usted personalizar su configuración de CrowdHandler a través de la consola de administración de CrowdHandler. Estos son algunos artículos de soporte recomendados que cubren los aspectos básicos:

  1. Primeros pasos (Puedes ignorar las partes sobre la instalación de la integración de Javascript).
  2. Salas de espera
  3. Configuración del dominio

Paso 6 (Recomendado): Elimine Cloudflare Workers Rate Limiting.

En el momento de redactar este documento, el plan gratuito de Cloudflare workers está sujeto a un límite de tasa de ráfagas de 1.000 solicitudes por minuto y a un límite de solicitudes diarias de 100.000 solicitudes. Si cree que estos límites pueden ser demasiado bajos para usted, le recomendamos que actualice al plan de pago de Cloudflare workers para eliminar los límites.