Guias

Gestor de ficheiros para o Amazon S3: ligue-o ao Nubbo

Como ligar um bucket do Amazon S3 ao Nubbo: a chave IAM de que precisa, o assistente passo a passo, a regra CORS e o que fazer se algo correr mal.

O Nubbo liga-se ao Amazon S3 com uma chave de acesso IAM. Em poucos minutos tem o seu bucket num explorador de ficheiros com carregamentos diretos, ligações de partilha e galerias, sem tornar nada público. Este guia segue o assistente do Nubbo passo a passo, pelos dois caminhos: automático ou com uma chave limitada a um bucket.

O que consegue

  • Navegue pelo bucket como se fosse um disco: pastas, vistas, pesquisa, lixo, etiquetas e favoritos.
  • Carregue e transfira ficheiros diretamente entre o seu navegador e o Amazon S3. Os ficheiros nunca passam pelos servidores do Nubbo.
  • Partilhe ficheiros e pastas com palavra-passe, data de expiração e limite de transferências, receba ficheiros no seu bucket e crie galerias.
  • As suas chaves são guardadas encriptadas com AES-256-GCM e pode desligar o bucket a qualquer momento.

Antes de começar

Precisa de uma conta no Amazon S3 e de uma conta no Nubbo. Cada bucket que liga conta para o limite do seu plano: o Grátis permite 2, o Personal 5 e o Pro não tem limite. Algumas regiões da AWS estão desativadas por omissão e têm de ser ativadas na conta antes de as usar (Milão, Zurique ou Cidade do Cabo, por exemplo). Se vai criar o bucket numa delas, ative-a primeiro. Não é preciso desligar o Block Public Access: o Nubbo mantém o bucket privado.

Escolha como ligar

O assistente do Nubbo oferece dois caminhos. Ambos terminam da mesma forma: o bucket ligado e pronto para carregamentos a partir do navegador.

AutomáticoCom uma chave limitada
ChaveAcesso a toda a contaLimitada a um bucket
BucketO Nubbo usa um dos seus ou cria um novoCria-o você primeiro
CORSO Nubbo adiciona a regra por siAdiciona você a regra
Quando o escolherO caminho mais rápidoQuando não quer dar acesso a toda a conta

Ligação automática

Passo 1: crie a chave no Amazon S3

  1. Inicie sessão na consola da AWS e abra o IAM. Use um utilizador IAM, nunca o utilizador root da conta.
  2. Vá a Usuários e prima Criar usuário. Dê-lhe um nome, por exemplo nubbo, e prima Próximo.
  3. Em Definir permissões, escolha Anexar políticas diretamente, procure e assinale AmazonS3FullAccess e crie o utilizador.
  4. Abra o utilizador, vá ao separador Credenciais de segurança e, em Chaves de acesso, prima Criar chave de acesso.
  5. Como caso de utilização, escolha uma aplicação executada fora da AWS (ou Outro, se não aparecer) e prima Próximo e Criar chave de acesso.
  6. Prima Baixar arquivo .csv. É a única vez que a AWS o deixa ver a secret access key.

Passo 2: ligue o bucket no Nubbo

  1. No Nubbo, abra Buckets e prima Ligar bucket. Escolha Amazon S3 e prima Continuar.

    Passo Fornecedor do assistente do Nubbo com o Amazon S3 selecionado Passo Fornecedor do assistente do Nubbo com o Amazon S3 selecionado
  2. Escolha Automático e prima Continuar.

    Passo Como ligar com as opções Automático e Com uma chave limitada Passo Como ligar com as opções Automático e Com uma chave limitada
  3. No passo A sua chave, prima Carregar ficheiro e escolha o CSV que transferiu, ou cole o seu conteúdo na caixa de texto. O Nubbo lê a access key e a secret para não ter de as copiar à mão. Confirme que a Região é a dos seus buckets. Prima Verificar chave. O Nubbo verifica que a chave funciona e que tem acesso a toda a conta.

    Passo A sua chave para o Amazon S3 com o guia rápido e os campos da chave Passo A sua chave para o Amazon S3 com o guia rápido e os campos da chave
  4. Escolha um dos seus buckets e prima Usar este bucket, ou selecione Criar um novo, escreva um nome (e escolha a região, se a pedir) e prima Criar e preparar. O Nubbo adiciona ao bucket uma regra CORS que só permite carregamentos e transferências a partir da aplicação e mantém as regras que já tinha.

    Passo O seu bucket com a lista de buckets e a opção Criar um novo Passo O seu bucket com a lista de buckets e a opção Criar um novo
  5. Reveja as três verificações, altere o Nome no Nubbo se quiser e prima Concluir. O bucket aparece em Buckets e pode abri-lo no explorador.

    Passo Concluído com as verificações da ligação, do bucket e do CORS Passo Concluído com as verificações da ligação, do bucket e do CORS

Se o Nubbo não conseguir adicionar a regra CORS com a sua chave, o assistente leva-o ao passo CORS. Nesse caso, siga Adicione a regra CORS.

Ligação com uma chave limitada

Passo 1: prepare o bucket e a chave no Amazon S3

  1. Na consola, escolha a região na barra superior, abra o S3 e, em Buckets de uso geral, prima Criar bucket. Dê-lhe um nome (de 3 a 63 caracteres: letras minúsculas, números, pontos e hífenes) e crie-o com o Block Public Access ativo.
  2. No IAM, crie um utilizador sem permissões (Usuários, Criar usuário).
  3. Abra o utilizador, separador Permissões, Adicionar permissões, Criar política em linha. Mude para o editor JSON, cole esta política substituindo YOUR-BUCKET pelo nome do seu bucket e guarde-a com um nome.
  4. Crie a chave em Credenciais de segurança, Criar chave de acesso, tal como na ligação automática, e transfira 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/*"
    }
  ]
}

Passo 2: ligue o bucket no Nubbo

  1. Em Buckets, prima Ligar bucket, escolha Amazon S3 e depois Com uma chave limitada.
  2. Carregue o CSV da chave ou cole o seu conteúdo e escolha a região do bucket. Prima Verificar chave.
  3. Escreva o nome exato do bucket e prima Verificar acesso.
  4. O assistente passa ao passo CORS com a regra que tem de adicionar.

Adicione a regra CORS

A regra CORS permite que o navegador carregue e transfira ficheiros do seu bucket em https://nubbo.app. É a mesma regra que o assistente mostra no passo CORS.

  1. Na consola do S3, abra o bucket e vá ao separador Permissões.
  2. Desça até Compartilhamento de recursos de origem cruzada (CORS) e prima Editar.
  3. Cole a regra e guarde as alterações.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Passo CORS com a regra a adicionar ao bucket Passo CORS com a regra a adicionar ao bucket

Depois de a guardar, volte ao Nubbo e prima Já a adicionei, verificar. Alguns fornecedores demoram um minuto a aplicá-la. Se a sua chave tiver permissão para alterar o CORS, Tentar configurá-lo por mim faz isso por si.

Se algo correr mal

Mensagem no NubboO que fazer
“Credenciais inválidas. Verifique a chave de acesso e a chave de acesso secreta.”Copie de novo as duas chaves, sem espaços no início nem no fim.
“Esta chave parece limitada a um bucket. Pode continuar pelo caminho limitado ou criar uma chave com acesso total.”Prima Continuar com chave limitada, ou crie uma chave com acesso a toda a conta e prima Experimentar outra chave.
“Bucket não encontrado. Verifique o nome e a região.”Confirme o nome exato do bucket e que a região escolhida é a do bucket.
“A sua chave não tem permissão para criar buckets.”Use uma chave com acesso total, ou crie o bucket no seu painel e prima Já o criei no meu painel.
“Esse nome já está em uso neste fornecedor; experimente outro.”Os nomes de bucket são únicos em todo o fornecedor: escolha outro.
“A sua chave não tem permissão para o configurar.”Adicione a regra CORS à mão, como explicado acima.
“Ainda não funciona. Reveja a regra e volte a verificar; alguns fornecedores demoram um minuto a aplicá-la.”Confirme que a origem é exatamente https://nubbo.app, sem barra no fim, espere um minuto e volte a verificar.
“Este bucket já está a ser utilizado.”Esse bucket já está ligado no Nubbo, na sua conta ou noutra.
“O bucket está numa região diferente. Verifique a região configurada.”No passo A sua chave, escolha a região onde está o bucket.
“Não encontrámos as chaves nesse ficheiro; cole-as manualmente.”Carregue o CSV que transferiu quando criou a chave, ou cole o seu conteúdo tal como está.

Quanto custa

O Amazon S3 cobra pelo armazenamento, pelos pedidos e pela transferência de dados para fora. Explicamos tudo com exemplos em Preços do Amazon S3.

Perguntas frequentes

Tenho de tornar o meu bucket S3 público para usar o Nubbo?

Não. O Nubbo mantém o bucket privado e o Block Public Access pode continuar ativo. Os carregamentos e as transferências usam URLs pré-assinados que expiram.

Que permissões precisa a chave da AWS?

Para o caminho automático, a política AmazonS3FullAccess. Com uma chave limitada, basta uma política inline que só dê acesso ao seu bucket: listar, ler, escrever e eliminar objetos.

Posso usar as chaves do utilizador root da AWS?

Não é boa ideia e a AWS desaconselha-o. Crie um utilizador IAM só para o Nubbo; assim pode desativar a sua chave sem mexer em mais nada.

Porque é que o Nubbo não tem campos para a chave da AWS?

Porque a AWS lhe dá a chave num CSV. O Nubbo lê-o diretamente: carrega o ficheiro ou cola o seu conteúdo e nunca copia a secret à mão.

Posso ligar vários buckets S3?

Sim. Cada bucket conta para o limite do seu plano: o Grátis permite 2, o Personal 5 e o Pro não tem limite, e podem vir de contas da AWS diferentes.

Fontes

Os preços e limites vêm das páginas oficiais abaixo. Os fornecedores alteram-nos, por isso confirme antes de se comprometer.