Guies

Gestor de fitxers per a Amazon S3: connecta'l a Nubbo

Com connectar un bucket d'Amazon S3 a Nubbo: la clau IAM que necessites, l'assistent pas a pas, la regla de CORS i què fer si alguna cosa falla.

Nubbo es connecta a Amazon S3 amb una clau d’accés IAM. En pocs minuts tens el bucket en un explorador de fitxers amb pujades directes, enllaços per compartir i galeries, sense fer res públic. Aquesta guia segueix l’assistent de Nubbo pas a pas, pels dos camins: automàtic o amb una clau limitada a un bucket.

Què aconsegueixes

  • Explora el bucket com si fos un disc: carpetes, vistes, cerca, paperera, etiquetes i preferits.
  • Puja i baixa fitxers directament entre el teu navegador i Amazon S3. Els fitxers mai passen pels servidors de Nubbo.
  • Comparteix fitxers i carpetes amb contrasenya, caducitat i límit de baixades, rep fitxers al teu bucket i crea galeries.
  • Les teves claus es guarden xifrades amb AES-256-GCM i pots desconnectar el bucket quan vulguis.

Abans de començar

Necessites un compte d’Amazon S3 i un compte de Nubbo. Cada bucket que connectes compta per al límit del teu pla: Gratuït en permet 2, Personal 5 i Pro no té límit. Algunes regions d’AWS estan desactivades per defecte i s’han d’activar al compte abans de fer-les servir (Milà, Zuric o Ciutat del Cap, per exemple). Si hi crearàs el bucket, activa-la primer. No cal desactivar Block Public Access: Nubbo manté el bucket privat.

Tria com connectar

L’assistent de Nubbo ofereix dos camins. Tots dos acaben igual: el bucket connectat i preparat per pujar fitxers des del navegador.

AutomàticAmb clau limitada
ClauAccés a tot el compteLimitada a un bucket
BucketNubbo en fa servir un dels teus o en crea un de nouEl crees tu primer
CORSNubbo hi afegeix la regla per tuHi afegeixes tu la regla
Quan triar-loLa via més ràpidaQuan no vols donar accés a tot el compte

Connexió automàtica

Pas 1: crea la clau a Amazon S3

  1. Inicia la sessió a la consola d’AWS i obre IAM. Fes servir un usuari IAM, mai l’usuari root del compte.
  2. Ves a Users i prem Create user. Posa-li un nom, per exemple nubbo, i prem Next.
  3. A Set permissions, tria Attach policies directly, cerca i marca AmazonS3FullAccess i crea l’usuari.
  4. Obre l’usuari, ves a la pestanya Security credentials i, a Access keys, prem Create access key.
  5. Com a cas d’ús tria Application running outside AWS (o Other si no apareix) i prem Next i Create access key.
  6. Prem Download .csv file. És l’única vegada que AWS et deixa veure la secret access key.

Pas 2: connecta el bucket a Nubbo

  1. A Nubbo, obre Buckets i prem Connecta un bucket. Tria Amazon S3 i prem Continua.

    Pas Proveïdor de l'assistent de Nubbo amb Amazon S3 seleccionat Pas Proveïdor de l'assistent de Nubbo amb Amazon S3 seleccionat
  2. Tria Automàtic i prem Continua.

    Pas Com connectar amb les opcions Automàtic i Amb clau limitada Pas Com connectar amb les opcions Automàtic i Amb clau limitada
  3. Al pas La teva clau, prem Puja un fitxer i tria el CSV que has baixat, o enganxa’n el contingut al quadre de text. Nubbo llegeix l’access key i el secret perquè no els hagis de copiar a mà. Comprova que la Regió és la dels teus buckets. Prem Comprova la clau. Nubbo comprova que la clau funciona i que té accés a tot el compte.

    Pas La teva clau d'Amazon S3 amb la guia ràpida i els camps de la clau Pas La teva clau d'Amazon S3 amb la guia ràpida i els camps de la clau
  4. Tria un dels teus buckets i prem Fes servir aquest bucket, o selecciona Crea’n un de nou, escriu un nom (i tria la regió, si te la demana) i prem Crea i prepara. Nubbo afegeix al bucket una regla de CORS que només permet pujades i baixades des de l’app, i conserva les regles que ja tenia.

    Pas El teu bucket amb la llista de buckets i l'opció Crea'n un de nou Pas El teu bucket amb la llista de buckets i l'opció Crea'n un de nou
  5. Revisa les tres comprovacions, canvia el Nom a Nubbo si vols i prem Acaba. El bucket apareix a Buckets i el pots obrir a l’explorador.

    Pas Fet amb les comprovacions de connexió, bucket i CORS Pas Fet amb les comprovacions de connexió, bucket i CORS

Si Nubbo no pot afegir la regla de CORS amb la teva clau, l’assistent et porta al pas CORS. Llavors segueix Afegeix la regla de CORS.

Connexió amb clau limitada

Pas 1: prepara el bucket i la clau a Amazon S3

  1. A la consola, tria la regió a la barra superior, obre S3 i, a General purpose buckets, prem Create bucket. Posa-li un nom (de 3 a 63 caràcters: minúscules, números, punts i guions) i crea’l amb Block Public Access activat.
  2. A IAM, crea un usuari sense permisos (Users, Create user).
  3. Obre l’usuari, pestanya Permissions, Add permissions, Create inline policy. Canvia a l’editor JSON, enganxa aquesta política substituint YOUR-BUCKET pel nom del teu bucket i desa-la amb un nom.
  4. Crea la clau a Security credentials, Create access key, com a la connexió automàtica, i baixa el CSV.
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "arn:aws:s3:::YOUR-BUCKET"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject",
        "s3:AbortMultipartUpload",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
    }
  ]
}

Pas 2: connecta el bucket a Nubbo

  1. A Buckets, prem Connecta un bucket, tria Amazon S3 i després Amb clau limitada.
  2. Puja el CSV de la clau o enganxa’n el contingut i tria la regió del bucket. Prem Comprova la clau.
  3. Escriu el nom exacte del bucket i prem Comprova l’accés.
  4. L’assistent passa al pas CORS amb la regla que has d’afegir.

Afegeix la regla de CORS

La regla de CORS permet que el navegador pugi i baixi fitxers del teu bucket a https://nubbo.app. És la mateixa regla que l’assistent mostra al pas CORS.

  1. A la consola d’S3, obre el bucket i ves a la pestanya Permissions.
  2. Baixa fins a Cross-origin resource sharing (CORS) i prem Edit.
  3. Enganxa la regla i prem Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Pas CORS amb la regla que cal afegir al bucket Pas CORS amb la regla que cal afegir al bucket

Un cop desada, torna a Nubbo i prem Ja l’he afegida, comprova-ho. Alguns proveïdors triguen un minut a aplicar-la. Si la teva clau té permís per canviar el CORS, Intenta configurar-ho per mi ho fa per tu.

Si alguna cosa falla

Missatge a NubboQuè fer
“Les credencials no són vàlides. Revisa l’access key i la secret access key.”Torna a copiar les dues claus, sense espais al principi ni al final.
“Aquesta clau sembla limitada a un bucket. Pots continuar amb el camí limitat o crear una clau amb accés complet.”Prem Continua amb clau limitada, o crea una clau amb accés a tot el compte i prem Prova una altra clau.
“No s’ha trobat el bucket. Verifica el nom i la regió.”Comprova el nom exacte del bucket i que la regió triada és la del bucket.
“La teva clau no té permís per crear buckets.”Fes servir una clau amb accés complet, o crea el bucket al teu tauler i prem Ja l’he creat al meu tauler.
“Aquest nom ja està en ús en aquest proveïdor; prova’n un altre.”Els noms de bucket són únics a tot el proveïdor: tria’n un altre.
“La teva clau no té permís per configurar-ho.”Afegeix la regla de CORS a mà, com s’explica més amunt.
“Encara no funciona. Revisa la regla i torna-ho a comprovar; alguns proveïdors triguen un minut a aplicar-la.”Comprova que l’origen és exactament https://nubbo.app sense barra final, espera un minut i torna-ho a comprovar.
“Aquest bucket ja està en ús.”Aquest bucket ja està connectat a Nubbo, al teu compte o en un altre.
“El bucket és en una altra regió. Verifica la regió configurada.”Al pas La teva clau, tria la regió on és el bucket.
“No hem trobat les claus en aquest fitxer; enganxa-les a mà.”Puja el CSV que vas baixar en crear la clau, o enganxa’n el contingut tal com és.

Quant costa

Amazon S3 cobra per l’emmagatzematge, les peticions i la transferència de dades de sortida. T’ho expliquem amb exemples a Preus d’Amazon S3.

Preguntes freqüents

He de fer públic el meu bucket d'S3 per fer servir Nubbo?

No. Nubbo manté el bucket privat i Block Public Access pot continuar activat. Les pujades i baixades fan servir URL presignades que caduquen.

Quins permisos necessita la clau d'AWS?

Per al camí automàtic, la política AmazonS3FullAccess. Amb una clau limitada, n'hi ha prou amb una política inline que només doni accés al teu bucket: llistar, llegir, escriure i esborrar objectes.

Puc fer servir les claus de l'usuari root d'AWS?

No és bona idea i AWS ho desaconsella. Crea un usuari IAM només per a Nubbo; així en pots desactivar la clau sense tocar res més.

Per què Nubbo no té camps per a la clau d'AWS?

Perquè AWS et dona la clau en un CSV. Nubbo el llegeix directament: el puges o n'enganxes el contingut i mai copies el secret a mà.

Puc connectar diversos buckets d'S3?

Sí. Cada bucket compta per al límit del teu pla: Gratuït en permet 2, Personal 5 i Pro no té límit, i poden ser de comptes d'AWS diferents.

Fonts

Els preus i els límits surten de les pàgines oficials de sota. Els proveïdors els canvien, així que comprova'ls abans de decidir.