Este documento te guiará en la configuración y uso de tu cuenta de Hosting S3 en Imagina Colombia utilizando clientes S3 como S3Browser o Cyberduck. Estas herramientas te permiten administrar tus archivos en la nube de manera eficiente desde un dispositivo Windows o Mac y con una interfaz gracia sencilla. Recuerda que también puedes usar la línea de comandos con la aplicación AWS-CLI

2. Requisitos Previos

• Credenciales S3: Llave de acceso (Access Key) y llave secreta (Secret Key) proporcionadas por Imagina Colombia.
• Cliente S3: S3Browser (Windows) o Cyberduck (Windows/Mac).
• Conexión a Internet.
• Bucket Proporcionado: Imagina Colombia te proporcionará el nombre del bucket al que tendrás acceso.

3. Descarga e Instalación del Cliente S3

3.1 S3Browser (Recomendado)

1. Descarga: Visita https://s3browser.com y descarga la última versión.
2. Instalación: Ejecuta el archivo descargado y sigue las instrucciones de instalación.
3. Inicia S3Browser: Una vez instalado, abre el programa.

3.2 Cyberduck

1. Descarga: Visita https://cyberduck.io y descarga la versión correspondiente a tu sistema operativo.
2. Instalación: Ejecuta el archivo descargado y sigue las instrucciones de instalación.
3. Inicia Cyberduck: Una vez instalado, abre el programa.

4. Configuración del Cliente S3

4.1 S3Browser

1. Añadir una Nueva Cuenta:
   • Abre S3Browser.
   • Haz clic en "Accounts" y luego en "Add New Account".
2. Introducir Credenciales:
   • Display Name: Un nombre descriptivo por si vas a agregar mas cuentas S3 posteriormente, (ej. ServerName S3).
   • Account Type: Selecciona "S3 Compatible Storage".
   • REST Endpoint: Ingresa la URL del endpoint de Wasabi o Backblaze (proporcionado por Imagina Colombia). ej: s3.wasabisys.com
   • Access Key ID: Ingresa la llave de acceso proporcionada.
   • Secret Access Key: Ingresa la llave secreta proporcionada.
   • Use Secure Transfer (SSL): Marca la opción si el servicio lo soporta.
     
3. Agregar el Bucket:
   • Una vez configurada la cuenta, haz click en el boton:  "Add External Bucket" e ingresa el nombre del Bucket previamente proporcionado por Imagina Colombia.
   • Deberás poder visualizar a la izquierda el nombre de tu bucket y a la derecha los archivos que esten dentro del mismo:
     

4.2 Cyberduck

1. Añadir una Nueva Conexión:
   • Abre Cyberduck.
   • Haz clic en "Open Connection" (abrir conexión).
2. Seleccionar Protocolo:
   • En el menú desplegable "Protocol", selecciona "Amazon S3".
3. Introducir Credenciales:
   • Server: Ingresa la URL del endpoint de Wasabi o Backblaze (proporcionado por Imagina Colombia).
   • Access Key ID: Ingresa la llave de acceso proporcionada.
   • Secret Access Key: Ingresa la llave secreta proporcionada.
4. Seleccionar el Bucket:
   • Después de conectarte, verás una lista de buckets disponibles. Selecciona el bucket proporcionado por Imagina Colombia.
5. Guardar Conexión:
   • Haz clic en "Connect" para conectarte al servidor S3.
   • Puedes guardar esta conexión para acceso rápido en el futuro.

5. Gestión de Archivos

5.1 S3Browser

• Subir Archivos: Haz clic derecho en el bucket seleccionado y elige "Upload". Selecciona los archivos desde tu computadora.
• Descargar Archivos: Haz clic derecho en el archivo dentro del bucket que deseas descargar y selecciona "Download".

5.2 Cyberduck

• Subir Archivos: Arrastra y suelta los archivos desde tu computadora al bucket en Cyberduck.
• Descargar Archivos: Haz clic derecho en el archivo dentro del bucket que deseas descargar y selecciona "Download".

6. Resolución de Problemas

• Conexión Fallida: Verifica que el endpoint, Access Key ID y Secret Access Key estén correctamente ingresados.
• Problemas de Permisos: Asegúrate de que la cuenta tenga los permisos necesarios para acceder a los recursos.

7. Soporte Técnico

Si encuentras algún problema o necesitas asistencia, no dudes en contactar al equipo de soporte de Imagina Colombia a través de [email protected].