Integraciones – Cloudflare R2

En esta guía, te proporcionaremos instrucciones detalladas para configurar Cloudflare R2 y vincularlo con Gestioo® como proveedor externo para el almacenamiento de archivos.

A lo largo del procedimiento, aprenderás a activar Cloudflare R2, crear un bucket, habilitar su acceso público, obtener las credenciales necesarias y completar la configuración dentro de Gestioo®.

Confiamos en que este manual te ayudará a aprovechar al máximo el Software

Crear una cuenta en Cloudflare #

Antes de comenzar con la configuración, debes disponer de una cuenta activa en Cloudflare.

1. Ingresa al sitio de Cloudflare desde la siguiente dirección:

https://dash.cloudflare.com

2. Regístrate para crear una nueva cuenta o inicia sesión si ya dispones de una.
3. Una vez dentro del panel de Cloudflare, dirígete a la sección «Almacenamiento y bases de datos».
4. Realiza clic en «R2 Almacenamiento de objetos».

Activar Cloudflare R2 #

Al ingresar por primera vez a «R2 Almacenamiento de objetos», Cloudflare muestra la información correspondiente al servicio y los límites de uso mensual incluidos.

Actualmente, la clase de almacenamiento Estándar de R2 incluye mensualmente:

A Almacenamiento: 10 GB-mes.

B Operaciones de Clase A: 1 millón de operaciones.

C Operaciones de Clase B: 10 millones de operaciones.

D Transferencia de datos hacia Internet: Sin cargo de salida.

Estos límites corresponden al nivel gratuito de la clase de almacenamiento Estándar.

Para habilitar R2:

1. Realiza clic en «Agregar suscripción a R2 a mi cuenta».
2. Completa los datos de facturación y del método de pago solicitados por Cloudflare.
3. Acepta los términos y condiciones correspondientes.
4. Realiza clic en «Activar R2».

Cloudflare utiliza un esquema de facturación basado en el consumo. Mientras el uso se mantenga dentro de los límites mensuales incluidos, no se generan cargos por ese consumo; al superarlos, se aplican las tarifas correspondientes.

Crear un bucket #

Una vez activado Cloudflare R2, crea el bucket que utilizarás para almacenar los archivos.

Un bucket funciona como el espacio donde se almacenan los objetos y archivos dentro de R2.

1. Dirígete a «R2 Almacenamiento de objetos».
2. Realiza clic en «Crear bucket».

3. Ingresa un nombre para identificar el bucket.

4. Selecciona la ubicación correspondiente. Puedes mantener la opción «Automático» si no necesitas establecer una jurisdicción específica.
5. En «Clase de almacenamiento predeterminada», selecciona «Estándar».

6. Realiza clic en «Crear bucket».

Cloudflare crea el bucket y permite acceder a sus opciones de administración.

Habilitar la URL pública del bucket #

Los buckets creados en Cloudflare R2 no tienen acceso público de manera predeterminada. Para vincular el almacenamiento con Gestioo®, necesitas obtener una dirección pública para el bucket.

1. Ingresa al bucket creado.
2. Dirígete a la pestaña «Configuración».
3. Busca la sección «Public Development URL» (URL pública de desarrollo).
4. Realiza clic en «Enable» (Habilitar) para habilitarla.
5. Confirma la habilitación del acceso público cuando Cloudflare lo solicite.

Una vez activada esta opción, Cloudflare genera una URL pública con el dominio r2.dev. Copia esta dirección, ya que debes ingresarla posteriormente en Gestioo®.

Obtener el ID de cuenta de Cloudflare #

Además de la URL pública, necesitas obtener el identificador de tu cuenta de Cloudflare.

1. Regresa a «R2 Almacenamiento de objetos».
2. Localiza la sección «Detalles de la cuenta».
3. Identifica el campo «ID de cuenta».
4. Copia el valor y consérvalo para utilizarlo posteriormente en Gestioo®.

Desde esta misma sección también puedes acceder a la administración de los tokens necesarios para generar las credenciales de conexión.

Acceder a la administración de tokens de API #

Desde la sección «Detalles de la cuenta»:

1. Realiza clic en «Gestionar tokens de la API».
2. Cloudflare muestra las opciones disponibles para crear las credenciales de acceso.

Puedes generar uno de los siguientes tipos de token:

A Token de API de Account: Se vincula directamente con la cuenta de Cloudflare. Puede utilizarse por sistemas autorizados y permanece activo hasta que se revoque manualmente. Solo un usuario con permisos de Superadministrador puede visualizarlo o crearlo.

B Token de API de User: Se vincula al usuario que lo crea y utiliza los permisos correspondientes a ese usuario. Si el usuario deja de pertenecer a la cuenta, el token queda inactivo.

Crear las claves de acceso #

1. Selecciona «Crear token de API de Account» o «Crear token de API de User», según el tipo de credencial que necesites.
2. Ingresa un nombre que permita identificar el token.
3. En la configuración de permisos, selecciona «Object Read & Write».

Este permiso permite leer, escribir y listar objetos dentro de los buckets seleccionados.

5. Revisa la configuración.
6. Realiza clic en «Crear token de API».

Al finalizar, Cloudflare muestra las siguientes credenciales:

A Access Key ID: Corresponde a la clave de acceso que debes ingresar en Gestioo®.

B Secret Access Key: Corresponde a la clave secreta que debes ingresar en Gestioo®.

Cloudflare utiliza estas credenciales para permitir el acceso mediante su API compatible con Amazon S3.

Datos necesarios para configurar Gestioo® #

Antes de continuar, verifica que dispones de la siguiente información:

A Account ID de Cloudflare: Se obtiene desde «R2 Almacenamiento de objetos» → «Detalles de la cuenta».

B Clave de acceso: Se obtiene al crear el token de API y corresponde a «Access Key ID».

C Clave secreta: Se obtiene al crear el token de API y corresponde a «Secret Access Key».

D Bucket: Corresponde al nombre del bucket que deseas utilizar.

E URL pública del bucket: Se obtiene desde la pestaña «Configuración» del bucket, al habilitar «Public Development URL».

Acceder a la integración de almacenamiento en Gestioo® #

Una vez obtenidos los datos necesarios desde Cloudflare, configura la vinculación dentro de Gestioo®.

1. Ingresa al menú lateral.
2. Dirígete a «Sistema».
3. Realiza clic en «Integraciones».
4. Selecciona la sección «Almacenamiento de archivos».
5. En el campo «Proveedor de almacenamiento», selecciona «Cloudflare R2».

Configurar Cloudflare R2 en Gestioo® #

Completa los campos disponibles en la sección «Configuración»:

A Proveedor de almacenamiento: Selecciona «Cloudflare R2».

B Origen del bucket: Define cómo deseas configurar el bucket. Las opciones disponibles son:

• «Usar un bucket que ya existe».
• «Crear un bucket nuevo».

Si realizaste previamente la creación desde Cloudflare, selecciona «Usar un bucket que ya existe».

C Account ID de Cloudflare: Ingresa el identificador obtenido previamente desde «R2 Almacenamiento de objetos» → «Detalles de la cuenta».

D Clave de acceso: Ingresa la «Access Key ID» obtenida al crear el token de API.

E Clave secreta: Ingresa la «Secret Access Key» obtenida al crear el token de API.

F Bucket: Indica el bucket que utilizarás para almacenar los archivos. Puedes utilizar uno existente o seleccionar la opción para crear uno nuevo, según el valor definido en «Origen del bucket».

G URL pública del bucket: Ingresa la dirección obtenida previamente al habilitar «Public Development URL» desde la configuración del bucket.

Comprobar la vinculación #

Una vez ingresados todos los datos:

1. Revisa que el «Account ID de Cloudflare», la clave de acceso, la clave secreta, el bucket y la URL pública correspondan a la misma configuración de Cloudflare R2.
2. Realiza clic en «Probar».

Gestioo® comprueba la comunicación con Cloudflare R2 utilizando la información ingresada.

3. Si la comprobación se realiza correctamente, continúa con el guardado de la configuración.

Una vez comprobada correctamente la vinculación:

1. Realiza clic en «Guardar».

El sistema mostrará una alerta confirmando que el proceso fue efectuado correctamente.

A partir de esta configuración, Gestioo® utiliza Cloudflare R2 como proveedor de almacenamiento de archivos de acuerdo con los parámetros establecidos.

Conclusión #

En resumen, esta guía proporciona las instrucciones necesarias para configurar Cloudflare R2 y vincularlo con Gestioo® como proveedor de almacenamiento de archivos.

A través del procedimiento, activas el servicio R2, creas y configuras un bucket, habilitas su URL pública, obtienes el ID de cuenta y generas las credenciales necesarias mediante un token de API. Finalmente, ingresas esta información en «Sistema» → «Integraciones» → «Almacenamiento de archivos», compruebas la conexión y guardas la configuración.

Realizar correctamente cada una de estas configuraciones permite que Gestioo® se comunique con el bucket seleccionado y utilice Cloudflare R2 para el almacenamiento de los archivos de la cuenta.