Vodiči

Upravitelj datoteka za Amazon S3: poveži ga s Nubbom

Kako povezati Amazon S3 bucket s Nubbom: IAM ključ koji ti treba, čarobnjak korak po korak, CORS pravilo i što učiniti ako nešto pođe po zlu.

Nubbo se s Amazon S3 povezuje pomoću IAM pristupnog ključa. Za nekoliko minuta tvoj je bucket u pregledniku datoteka s izravnim prijenosima, poveznicama za dijeljenje i galerijama, a da ništa ne postaje javno. Ovaj vodič prati Nubbov čarobnjak korak po korak, s oba puta: automatski ili s ključem ograničenim na jedan bucket.

Što dobivaš

  • Pregledavaj bucket kao disk: mape, prikazi, pretraživanje, smeće, oznake i favoriti.
  • Prenosi i preuzimaj datoteke izravno između svog preglednika i Amazon S3. Datoteke nikad ne prolaze kroz Nubbove servere.
  • Dijeli datoteke i mape s lozinkom, istekom i ograničenjem preuzimanja, primaj datoteke u svoj bucket i izrađuj galerije.
  • Tvoji se ključevi spremaju šifrirani algoritmom AES-256-GCM i bucket možeš odspojiti u bilo kojem trenutku.

Prije nego što počneš

Trebaš račun na Amazon S3 i Nubbo račun. Svaki bucket koji povežeš ulazi u ograničenje tvog plana: plan Besplatno dopušta 2, Personal 5, a Pro nema ograničenja. Neke AWS regije zadano su isključene i moraju se omogućiti na računu prije korištenja (na primjer Milano, Zürich ili Cape Town). Ako ćeš bucket izraditi u jednoj od njih, najprije je omogući. Nema potrebe isključivati Block Public Access: Nubbo bucket drži privatnim.

Odaberi način povezivanja

Nubbov čarobnjak nudi dva puta. Oba završavaju jednako: bucket je povezan i spreman za prijenose iz preglednika.

AutomatskiS ograničenim ključem
KljučPristup cijelom računuOgraničen na jedan bucket
BucketNubbo koristi jedan od tvojih ili izrađuje noviIzradiš ga najprije sam
CORSNubbo dodaje pravilo umjesto tebePravilo dodaješ ti
Kada ga odabratiNajbrži načinKad ne želiš dati pristup cijelom računu

Automatsko povezivanje

Korak 1: izradi ključ u Amazon S3

  1. Prijavi se u AWS konzolu i otvori IAM. Koristi IAM korisnika, nikad root korisnika računa.
  2. Idi na Users i pritisni Create user. Daj mu ime, na primjer nubbo, i pritisni Next.
  3. U Set permissions odaberi Attach policies directly, potraži i označi AmazonS3FullAccess te izradi korisnika.
  4. Otvori korisnika, idi na karticu Security credentials i pod Access keys pritisni Create access key.
  5. Kao slučaj korištenja odaberi Application running outside AWS (ili Other ako nije na popisu) i pritisni Next i Create access key.
  6. Pritisni Download .csv file. To je jedini put kad ti AWS dopušta vidjeti tajni pristupni ključ.

Korak 2: poveži bucket u Nubbu

  1. U Nubbu otvori Bucketi i pritisni Poveži bucket. Odaberi Amazon S3 i pritisni Nastavi.

    Korak Pružatelj usluge u Nubbovom čarobnjaku s odabranim Amazon S3 Korak Pružatelj usluge u Nubbovom čarobnjaku s odabranim Amazon S3
  2. Odaberi Automatski i pritisni Nastavi.

    Korak Način povezivanja s opcijama Automatski i S ograničenim ključem Korak Način povezivanja s opcijama Automatski i S ograničenim ključem
  3. U koraku Tvoj ključ pritisni Učitaj datoteku i odaberi CSV koji si preuzeo ili zalijepi njegov sadržaj u tekstni okvir. Nubbo čita pristupni ključ i tajnu kako ih ne bi morao ručno prepisivati. Provjeri je li Regija regija tvojih bucketa. Pritisni Provjeri ključ. Nubbo provjerava radi li ključ i ima li pristup cijelom računu.

    Korak Tvoj ključ za Amazon S3 s brzim vodičem i poljima ključa Korak Tvoj ključ za Amazon S3 s brzim vodičem i poljima ključa
  4. Odaberi jedan od svojih bucketa i pritisni Koristi ovaj bucket ili odaberi Izradi novi, upiši naziv (i odaberi regiju, ako je traži) te pritisni Izradi i pripremi. Nubbo dodaje bucketu CORS pravilo koje dopušta prijenos i preuzimanje samo iz aplikacije i zadržava pravila koja bucket već ima.

    Korak Tvoj bucket s popisom bucketa i opcijom Izradi novi Korak Tvoj bucket s popisom bucketa i opcijom Izradi novi
  5. Pregledaj tri provjere, po želji promijeni Naziv u Nubbu i pritisni Završi. Bucket se pojavljuje u odjeljku Bucketi i možeš ga otvoriti u pregledniku.

    Korak Gotovo s provjerama veze, bucketa i CORS-a Korak Gotovo s provjerama veze, bucketa i CORS-a

Ako Nubbo tvojim ključem ne može dodati CORS pravilo, čarobnjak te vodi na korak CORS. Tada slijedi Dodaj CORS pravilo.

Povezivanje s ograničenim ključem

Korak 1: pripremi bucket i ključ u Amazon S3

  1. U konzoli odaberi regiju u gornjoj traci, otvori S3 i pod General purpose buckets pritisni Create bucket. Daj mu naziv (od 3 do 63 znaka: mala slova, brojke, točke i crtice) i izradi ga s uključenim Block Public Access.
  2. U IAM izradi korisnika bez dopuštenja (Users, Create user).
  3. Otvori korisnika, kartica Permissions, Add permissions, Create inline policy. Prebaci se na uređivač JSON, zalijepi ovu politiku zamijenivši YOUR-BUCKET nazivom svog bucketa i spremi je pod nekim nazivom.
  4. Izradi ključ pod Security credentials, Create access key, kao kod automatskog povezivanja, i preuzmi 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/*"
    }
  ]
}

Korak 2: poveži bucket u Nubbu

  1. U odjeljku Bucketi pritisni Poveži bucket, odaberi Amazon S3, a zatim S ograničenim ključem.
  2. Učitaj CSV s ključem ili zalijepi njegov sadržaj i odaberi regiju bucketa. Pritisni Provjeri ključ.
  3. Upiši točan naziv bucketa i pritisni Provjeri pristup.
  4. Čarobnjak prelazi na korak CORS s pravilom koje trebaš dodati.

Dodaj CORS pravilo

CORS pravilo dopušta pregledniku prijenos i preuzimanje datoteka iz tvog bucketa na https://nubbo.app. To je isto pravilo koje čarobnjak prikazuje u koraku CORS.

  1. U S3 konzoli otvori bucket i idi na karticu Permissions.
  2. Pomakni se dolje do Cross-origin resource sharing (CORS) i pritisni Edit.
  3. Zalijepi pravilo i pritisni Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Korak CORS s pravilom koje treba dodati bucketu Korak CORS s pravilom koje treba dodati bucketu

Kad ga spremiš, vrati se u Nubbo i pritisni Dodano, provjeri. Nekim pružateljima treba minuta da ga primijene. Ako tvoj ključ smije mijenjati CORS, Pokušaj ga postaviti umjesto mene to radi umjesto tebe.

Ako nešto pođe po zlu

Poruka u NubbuŠto učiniti
“Nevažeće vjerodajnice. Provjeri pristupni ključ i tajni pristupni ključ.”Ponovno kopiraj oba ključa, bez razmaka na početku ili kraju.
“Čini se da je ovaj ključ ograničen na jedan bucket. Možeš nastaviti ograničenim putem ili izraditi ključ s potpunim pristupom.”Pritisni Nastavi s ograničenim ključem ili izradi ključ s pristupom cijelom računu i pritisni Isprobaj drugi ključ.
“Bucket nije pronađen. Provjeri naziv i regiju.”Provjeri točan naziv bucketa i je li odabrana regija ona u kojoj je bucket.
“Tvoj ključ nema dopuštenje za izradu bucketa.”Koristi ključ s potpunim pristupom ili izradi bucket u svojoj upravljačkoj ploči i pritisni Već ga imam u svojoj upravljačkoj ploči.
“Taj se naziv već koristi kod ovog pružatelja usluge; pokušaj s drugim.”Nazivi bucketa jedinstveni su na razini cijelog pružatelja: odaberi drugi.
“Tvoj ključ nema dopuštenje da to postavi.”Dodaj CORS pravilo ručno, kako je objašnjeno iznad.
“Još ne radi. Pregledaj pravilo i provjeri ponovno; nekim pružateljima treba minuta da ga primijene.”Provjeri je li ishodište točno https://nubbo.app bez kose crte na kraju, pričekaj minutu i provjeri ponovno.
“Ovaj bucket se već koristi.”Taj je bucket već povezan u Nubbu, na tvom ili na nekom drugom računu.
“Bucket se nalazi u drugoj regiji. Provjeri postavljenu regiju.”U koraku Tvoj ključ odaberi regiju u kojoj se bucket nalazi.
“U toj datoteci nismo pronašli ključeve; zalijepi ih ručno.”Učitaj CSV koji si preuzeo kad si izradio ključ ili zalijepi njegov sadržaj takav kakav jest.

Koliko košta

Amazon S3 naplaćuje pohranu, zahtjeve i odlazni prijenos podataka. Objašnjavamo to na primjerima u članku Cijene Amazon S3.

Česta pitanja

Moram li svoj S3 bucket učiniti javnim da bih koristio Nubbo?

Ne. Nubbo bucket drži privatnim i Block Public Access može ostati uključen. Prijenosi i preuzimanja koriste presigned URL-ove koji istječu.

Koja dopuštenja treba AWS ključ?

Za automatski put, politiku AmazonS3FullAccess. S ograničenim ključem dovoljna je inline politika koja daje pristup samo tvom bucketu: popis, čitanje, pisanje i brisanje objekata.

Mogu li koristiti ključeve AWS root korisnika?

Nije dobra ideja i AWS to ne preporučuje. Izradi IAM korisnika samo za Nubbo; tada možeš deaktivirati njegov ključ bez diranja bilo čega drugog.

Zašto Nubbo nema polja za AWS ključ?

Zato što ti AWS ključ daje u CSV datoteci. Nubbo je čita izravno: učitaš je ili zalijepiš njezin sadržaj i nikad ne prepisuješ tajnu ručno.

Mogu li povezati više S3 bucketa?

Da. Svaki bucket ulazi u ograničenje tvog plana: plan Besplatno dopušta 2, Personal 5, a Pro nema ograničenja, i mogu biti s različitih AWS računa.

Izvori

Cijene i ograničenja potječu sa službenih stranica u nastavku. Pružatelji ih mijenjaju, pa ih provjeri prije nego što se odlučiš.