Guías

Xestor de ficheiros para Amazon S3: conéctao a Nubbo

Como conectar un bucket de Amazon S3 a Nubbo: a chave IAM que necesitas, o asistente paso a paso, a regra de CORS e que facer se algo falla.

Nubbo conéctase a Amazon S3 cunha chave de acceso de IAM. En poucos minutos tes o teu bucket nun explorador de ficheiros con subidas directas, ligazóns para compartir e galerías, sen facer nada público. Esta guía segue o asistente de Nubbo paso a paso, cos dous camiños: automático ou cunha chave limitada a un bucket.

Que consegues

  • Explorar o bucket coma un disco: cartafoles, vistas, busca, papeleira, etiquetas e favoritos.
  • Subir e descargar ficheiros directamente entre o teu navegador e Amazon S3. Os ficheiros nunca pasan polos servidores de Nubbo.
  • Compartir ficheiros e cartafoles con contrasinal, caducidade e límite de descargas, recibir ficheiros no teu bucket e crear galerías.
  • As túas chaves gárdanse cifradas con AES-256-GCM e podes desconectar o bucket cando queiras.

Antes de comezar

Necesitas unha conta en Amazon S3 e unha conta de Nubbo. Cada bucket que conectas conta para o límite do teu plan: Gratuíto permite 2, Personal 5 e Pro non ten límite. En AWS hai rexións que veñen desactivadas e que hai que activar na conta antes de usalas (por exemplo, Milán, Zúric ou Cidade do Cabo). Se vas crear o bucket nunha delas, actívaa primeiro. Non fai falta desactivar o bloqueo de acceso público: Nubbo traballa co bucket privado.

Escolle como conectar

O asistente de Nubbo ofrece dous camiños. Os dous rematan igual: o bucket conectado e listo para subir ficheiros desde o navegador.

AutomáticoCon chave limitada
ChaveCon acceso a toda a contaLimitada a un bucket
BucketNubbo usa un teu ou crea un novoCréalo ti antes
CORSNubbo engade a regra por tiEngades ti a regra
Cando escolleloO máis rápidoSe non queres dar acceso a toda a conta

Conexión automática

Paso 1: crea a chave en Amazon S3

  1. Entra na consola de AWS e abre IAM. Usa un usuario de IAM, nunca o usuario raíz da conta.
  2. Vai a Users e preme Create user. Ponlle un nome, por exemplo nubbo, e preme Next.
  3. En Set permissions, escolle Attach policies directly, busca e marca AmazonS3FullAccess e crea o usuario.
  4. Abre o usuario, entra na lapela Security credentials e, en Access keys, preme Create access key.
  5. Como caso de uso escolle Application running outside AWS (se non aparece, Other) e preme Next e Create access key.
  6. Preme Download .csv file. É a única vez que AWS che deixa ver a secret access key.

Paso 2: conecta o bucket en Nubbo

  1. En Nubbo, abre Buckets e preme Conectar bucket. Escolle Amazon S3 e preme Continuar.

    Paso Provedor do asistente de Nubbo con Amazon S3 seleccionado Paso Provedor do asistente de Nubbo con Amazon S3 seleccionado
  2. Escolle Automático e preme Continuar.

    Paso Como conectar coas opcións Automático e Con chave limitada Paso Como conectar coas opcións Automático e Con chave limitada
  3. No paso A túa chave, preme Subir ficheiro e escolle o CSV que descargaches, ou pega o seu contido na caixa de texto. Nubbo le a access key e a secret sen que teñas que copialas a man. Comproba que a Rexión sexa a dos teus buckets. Preme Comprobar chave. Nubbo comproba que a chave funciona e que ten acceso a toda a conta.

    Paso A túa chave para Amazon S3 coa guía rápida e os campos da chave Paso A túa chave para Amazon S3 coa guía rápida e os campos da chave
  4. Escolle un dos teus buckets e preme Usar este bucket, ou marca Crear un novo, escribe un nome (e escolle a rexión, se cha pide) e preme Crear e preparar. Nubbo engade ao bucket unha regra de CORS que só permite subir e descargar desde a app e mantén as regras que xa teña.

    Paso O teu bucket coa lista de buckets e a opción Crear un novo Paso O teu bucket coa lista de buckets e a opción Crear un novo
  5. Revisa as tres comprobacións, cambia o Nome en Nubbo se queres e preme Rematar. O bucket aparece en Buckets e xa podes abrilo no explorador.

    Paso Listo coas comprobacións de conexión, bucket e CORS Paso Listo coas comprobacións de conexión, bucket e CORS

Se Nubbo non pode engadir a regra de CORS coa túa chave, o asistente lévate ao paso CORS. Segue entón a sección Engade a regra de CORS.

Conexión con chave limitada

Paso 1: prepara o bucket e a chave en Amazon S3

  1. Na consola, escolle a rexión na barra superior, abre S3 e, en General purpose buckets, preme Create bucket. Ponlle un nome (de 3 a 63 caracteres: minúsculas, números, puntos e guións) e créao co bloqueo de acceso público activado.
  2. En IAM, crea un usuario sen permisos (Users, Create user).
  3. Abre o usuario, lapela Permissions, Add permissions, Create inline policy. Pasa ao editor JSON, pega esta política cambiando YOUR-BUCKET polo nome do teu bucket e gárdaa cun nome.
  4. Crea a chave en Security credentials, Create access key, como na conexión automática, e descarga o 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/*"
    }
  ]
}

Paso 2: conecta o bucket en Nubbo

  1. En Buckets, preme Conectar bucket, escolle Amazon S3 e despois Con chave limitada.
  2. Sube o CSV da chave ou pega o seu contido e escolle a rexión do bucket. Preme Comprobar chave.
  3. Escribe o nome exacto do bucket e preme Comprobar acceso.
  4. O asistente pasa ao paso CORS coa regra que tes que engadir.

Engade a regra de CORS

A regra de CORS permite que o navegador suba e descargue ficheiros do teu bucket desde https://nubbo.app. É a mesma regra que mostra o paso CORS do asistente.

  1. Na consola de S3, abre o bucket e entra na lapela Permissions.
  2. Baixa ata Cross-origin resource sharing (CORS) e preme Edit.
  3. Pega a regra e preme Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Paso CORS coa regra que hai que engadir ao bucket Paso CORS coa regra que hai que engadir ao bucket

Cando a gardes, volve a Nubbo e preme Xa a engadín, comprobar. Algúns provedores tardan un minuto en aplicala. Se a túa chave ten permiso para cambiar o CORS, Tentar configuralo por min faino por ti.

Se algo falla

Mensaxe en NubboQue facer
«As credenciais non son válidas. Revisa a access key e a secret access key.»Copia de novo as dúas chaves, sen espazos ao principio nin ao final.
«Esta chave parece limitada a un bucket. Podes seguir co camiño limitado ou crear unha chave con acceso completo.»Preme Seguir con chave limitada ou crea unha chave con acceso a toda a conta e preme Probar outra chave.
«Non se atopou o bucket. Verifica o nome e a rexión.»Revisa o nome exacto do bucket e que a rexión escollida sexa a súa.
«A túa chave non ten permiso para crear buckets.»Usa unha chave con acceso completo ou crea o bucket no teu panel e preme Xa o creei no meu panel.
«Ese nome xa está en uso neste provedor; proba con outro.»Os nomes de bucket son únicos en todo o provedor: escolle outro.
«A túa chave non ten permiso para configuralo.»Engade a regra de CORS a man, como se explica arriba.
«Aínda non funciona. Revisa a regra e volve comprobar; algúns provedores tardan un minuto en aplicala.»Comproba que a orixe sexa exactamente https://nubbo.app, sen barra final, agarda un minuto e volve comprobar.
«Este bucket xa está en uso.»Ese bucket xa está conectado en Nubbo, na túa conta ou noutra.
«O bucket está noutra rexión. Verifica a rexión configurada.»Escolle no paso A túa chave a rexión na que está o bucket.
«Non atopamos as chaves nese ficheiro; pégaas a man.»Sube o CSV que descargaches ao crear a chave, ou pega o seu contido tal cal.

Canto custa

Amazon S3 cobra polo almacenamento, as peticións e a saída de datos. Explicámolo con exemplos en Prezos de Amazon S3.

Preguntas frecuentes

Necesito facer público o bucket de S3 para usar Nubbo?

Non. Nubbo traballa co bucket privado e o bloqueo de acceso público pode seguir activado. As subidas e descargas usan URL presinadas que caducan.

Que permisos necesita a chave de AWS?

Para o camiño automático, a política AmazonS3FullAccess. Cunha chave limitada abonda cunha política integrada que dea acceso só ao teu bucket: listar, ler, escribir e borrar obxectos.

Podo usar as chaves do usuario raíz de AWS?

Non é boa idea e AWS desaconséllao. Crea un usuario de IAM só para Nubbo; así podes desactivar a súa chave sen tocar nada máis.

Por que Nubbo non ten campos para a chave de AWS?

Porque AWS dáche a chave nun CSV. Nubbo léeo directamente: súbelo ou pegas o seu contido e nunca copias a secret a man.

Podo conectar varios buckets de S3?

Si. Cada bucket conta para o límite do teu plan: Gratuíto permite 2, Personal 5 e Pro non ten límite, e poden ser de contas de AWS distintas.

Fontes

Os prezos e límites saen das páxinas oficiais de abaixo. Os provedores cámbianos, así que compróbaos antes de decidir.