'/%3e%3cpath%20id='cross_2'%20data-name='cross%202'%20class='cls-2'%20d='M20.612,30.43h0a5.361,5.361,0,1,0-10.723,0H0A33.709,33.709,0,0,1,30.569,0V9.75a5.361,5.361,0,1,1,0,10.723V30.43Z'%20transform='translate(67.193%200.007)%20rotate(90)'/%3e%3cpath%20id='cross_3'%20data-name='cross%203'%20class='cls-3'%20d='M20.612,30.43h0a5.361,5.361,0,1,0-10.723,0H0A33.709,33.709,0,0,1,30.569,0V9.75a5.361,5.361,0,1,1,0,10.723V30.43Z'%20transform='translate(67.186%2067.041)%20rotate(180)'/%3e%3cpath%20id='cross_4'%20data-name='cross%204'%20class='cls-4'%20d='M20.6,30.5h0a5.361,5.361,0,1,0-10.723,0H0A33.71,33.71,0,0,1,30.56,0V9.818a5.361,5.361,0,1,1,0,10.723V30.5Z'%20transform='translate(0%2067.041)%20rotate(-90)'/%3e%3c/svg%3e)
Configuración de webhooks
Un webhook es una dirección receptora exclusiva que permite a otro programa enviar archivos automáticamente a una carpeta determinada de SpaceBuilder. Por ejemplo, puede guardar sin intervención manual los archivos creados por un escáner, un sistema empresarial o una automatización.
Esta página configura el alcance y los límites de los webhooks de todo el servidor. Para crear uno en una carpeta y utilizar su dirección, consulte Usar webhooks en carpetas.
Antes de configurar
- Para llamar al webhook desde el exterior, debe disponer de una dirección accesible de SpaceBuilder.
- La dirección contiene un secreto de autenticación. Comparta la dirección completa solo con los administradores y responsables del sistema conectado.
- Recomendamos HTTPS si se publica en Internet.
- Los archivos grandes aumentan el consumo de memoria y almacenamiento del servidor.
Configurar la política de webhooks
Elija quién puede utilizar la función y el nivel de seguridad.
| Campo | Descripción |
|---|---|
Enable Inbound Webhooks | Activa la recepción en el servidor. Si se desactiva, tampoco funcionan las direcciones ya creadas. |
Allow User API Key Issuance | Permite crear y administrar direcciones receptoras en carpetas. Si se desactiva, nadie, incluidos los administradores, puede crear webhooks nuevos. |
Allow Webhooks in Personal Folder | Permite crearlos tanto en carpetas personales como de equipo. |
Allow saving into subfolders | Permite activar Subfolders en cada webhook. Los archivos se guardan según la subruta incluida en el nombre y se crean las carpetas inexistentes. Está desactivado por defecto; mientras lo esté, incluso los webhooks configurados como Allowed rechazan archivos con subrutas. |
Force Webhook Signature Verification (Secure) | Aplica una firma adicional a los webhooks nuevos o cuyo secreto se reemplace. Utilícela si el emisor admite HMAC. Está desactivada por defecto. |
Configurar el tamaño y los límites de solicitudes
Defina el tamaño que puede recibirse de una vez y la frecuencia de las solicitudes. En entornos normales puede conservar los valores predeterminados.
| Campo | Valor predeterminado | Descripción |
|---|---|---|
Max Payload Size | 8 MB | Tamaño total del archivo y de los datos de la solicitud. Auméntelo si necesita recibir archivos mayores. |
Global Rate Limit | 5 por segundo | Evita una concentración excesiva de solicitudes. Cámbielo solo si limita solicitudes normales. |
El payload incluye el archivo y todos los datos de la solicitud, por lo que puede ser algo mayor que el archivo.
Si supera el tamaño, el archivo no se guarda y se devuelve 413 Request Entity Too Large. Para transferencias frecuentes de archivos grandes, resulta más adecuada la carga normal de archivos.
Aumentar el tamaño recibido de una vez
Si necesita recibir mediante webhook archivos mayores de 8 MB, cambie la configuración como se indica a continuación.
- Abra
Service Config>File Areay despliegue la tarjetaWebhooks (Auto Data Inbound). - Introduzca el tamaño necesario en
Max Payload Size. - Seleccione
MBoGB. - Guarde la configuración.
- Pruebe primero con un archivo pequeño y después envíe el necesario.
Por ejemplo, para archivos de unos 20 MB, introduzca 20 y seleccione MB. El intervalo admitido es 1 KB–1 GB.
Si publica el webhook en Internet, configure también límites en Cloudflare o Nginx para filtrar las solicitudes anómalas antes de que lleguen al servidor.
Orden de configuración recomendado
- Active los webhooks entrantes.
- Permita claves API de usuario para crear webhooks en carpetas.
- Permita carpetas personales solo si necesita recibir archivos en ellas.
- Mantenga los límites predeterminados.
- Guarde y cree el webhook en la carpeta correspondiente.
- Envíe primero un archivo pequeño y compruebe la ubicación y los permisos.
Solución de problemas
| Síntoma | Comprobación |
|---|---|
| No se reciben archivos | Compruebe que estén activados los webhooks entrantes y las claves de usuario. |
Respuesta 401 | Compruebe el secreto de la dirección o las cabeceras de firma. |
Respuesta 403 | Compruebe la autorización para carpetas personales y los permisos de la carpeta. |
Respuesta 409 | Compruebe si el webhook está pausado o hay un conflicto con la política de archivos del mismo nombre. |
Respuesta 413 | Compruebe que la solicitud completa no supere el tamaño máximo. |
| El servidor se ralentiza | Reduzca el tamaño y la frecuencia y compruebe si se acumulan tareas de OCR o conversión. |