Antes de empezar
Todo lo que necesitas está en tu área de cliente de Dongee, dentro de Servicios > Mis Servicios, abriendo tu servicio de Dongee Storage. Desde ahí verás:
El usuario y la contraseña para entrar a tu portal de almacenamiento.
Tus credenciales S3 (Access Key y Secret Key), que usarás desde cualquier programa.
Los endpoints de conexión y las llaves que crees para cada bucket.
1. Entra a tu portal de almacenamiento
Desde https://storage.dongee.com puedes administrar (crear y borrar) tus buckets de almacenamiento.
Los datos de inicio de sesión son compartidos en el mensaje de bienvenida, sin embargo también son visibles desde tu manager.
2. Crea tu primer bucket
Un bucket es el contenedor donde vivirán tus archivos. Puedes crear los que necesites: por ejemplo uno para copias de seguridad y otro para los archivos de tu sitio web.
Al entrar al portal verás la página Buckets. Haz clic en Create Bucket.
Escribe el nombre del bucket.
Elige la región donde quieres que resida.
Haz clic en Create.
Reglas para el nombre. El nombre forma parte de la dirección de tus archivos, así que debe cumplir:
Entre 3 y 63 caracteres, en minúsculas, números, puntos o guiones.
Empezar por una letra minúscula o un número.
Sin guiones bajos, sin terminar en guion, sin puntos consecutivos y sin guiones pegados a un punto.
El nombre debe ser único entre todos los buckets existentes. Si el que elegiste ya está tomado, prueba con otro.
La región importa. Cada región tiene su propia dirección de conexión, y tendrás que usar la que corresponda al bucket.
Región | Endpoint |
Toronto (ca-central-1) | ca-central.storage.dongee.com |
Ámsterdam (eu-central-1) | eu-central.storage.dongee.com |
París (eu-west-2) | eu-west.storage.dongee.com |
N. Virginia (us-east-1) | us-east.storage.dongee.com |
Oregón (us-west-1) | us-west.storage.dongee.com |
3. Tus credenciales y el endpoint de tu región
En tu área de cliente, dentro del servicio, encontrarás el panel Credenciales S3 con tu Access Key y tu Secret Key. Estas llaves tienen acceso a todos tus buckets
Si necesitas una llave que sólo pueda acceder a un bucket, la puedes crear desde la sección Llaves por bucket
4. Llaves limitadas a un solo bucket
Si vas a conectar varias aplicaciones, lo recomendable es darle a cada una su propia llave, limitada al bucket que le corresponde: cada proyecto sólo ve su contenido, sin riesgo a mostrar información donde no se debe
En tu área de cliente, en el panel Llaves por bucket, haz clic en Crear llave e indica:
Un nombre para reconocerla, por ejemplo «copias del servidor».
El bucket al que tendrá acceso.
El nivel de permisos.
Nivel | Permite | Úsalo para |
Lectura y escritura | Subir, descargar y borrar | Uso general |
Escritura sin borrado | Subir y descargar, pero no borrar | Copias de seguridad |
Solo lectura | Descargar y listar | Publicar o consultar archivos |
5. Conecta tu herramienta S3
Dongee Storage funciona con cualquier programa compatible con S3: Cyberduck, S3 Browser, WinSCP, Rclone, Mountain Duck o tu propia aplicación. Todos te pedirán los mismos cuatro datos:
Endpoint o servidor: el de la región de tu bucket (punto 2).
Access Key
Secret Key
Región: por ejemplo ca-central-1. Algunos programas no la piden.
Activa el modo «path style». Este es el ajuste que más consultas genera, así que no lo pases por alto. En tu programa busca una casilla llamada path style, forzar estilo de ruta o path-style access y actívala. Según la herramienta aparece como «Use path style requests», «Force path-style» o similar.
Sin esa casilla activada el programa usará el modo virtual host, que no es compatible con nuestros endpoints, y verás errores de acceso denegado aunque tus credenciales sean correctas.
6. Volver a generar la Access Key
Si necesitas rotar las credenciales de tu cuenta —porque sospechas que alguien más las tiene, o simplemente por mantenimiento— usa el botón Volver a generar la Access Key.
Antes de hacerlo, ten presente que se elimina la Access Keys general de la cuenta y se reemplazan por una nueva. Cualquier aplicación o programa que esté usando las anteriores dejará de funcionar hasta que lo actualices.
Las llaves limitadas a un bucket no se ven afectadas: siguen funcionando con normalidad.
7. Si algo no funciona
«Access Denied» al listar o subir archivos, con credenciales correctas.
Casi siempre es una de estas dos causas:
No activaste el modo path style en tu programa (punto 5). Es el motivo más frecuente.
Estás usando el endpoint de otra región. Un bucket creado en Toronto solo responde en el endpoint de Toronto; desde otro endpoint verás acceso denegado, no un aviso de región equivocada. Comprueba la región de tu bucket en el portal.
Un error que menciona «ListAllMyBuckets».
Significa que tu programa está pidiendo la lista completa de buckets en lugar de entrar al tuyo, y ocurre cuando sigue en modo virtual host. Activa path style y vuelve a probar.
No encuentro mi bucket en la lista del programa.
Si estás usando una llave limitada a un bucket, es lo esperado: no puede listar buckets. Escribe el nombre del bucket directamente en la configuración de tu herramienta.
No recuerdo la contraseña del portal.
Cámbiala desde el botón Cambiar Contraseña de tu área de cliente. La nueva queda activa de inmediato.
¿Te quedaste con dudas? Escríbenos a través de nuestro chat de soporte y con gusto te colaboramos