Vodniki

Upravitelj datotek za Amazon S3: poveži ga z Nubbo

Kako povezati bucket Amazon S3 z Nubbo: ključ IAM, ki ga potrebuješ, čarovnik po korakih, pravilo CORS in kaj storiti, če gre kaj narobe.

Nubbo se z Amazon S3 poveže z dostopnim ključem IAM. V nekaj minutah imaš svoj bucket v raziskovalcu datotek z neposrednim nalaganjem, povezavami za deljenje in galerijami, ne da bi karkoli naredil javno. Ta vodnik po korakih sledi čarovniku Nubbo in pokriva obe poti: samodejno ali s ključem, omejenim na en bucket.

Kaj dobiš

  • Brskaš po bucketu kot po disku: mape, pogledi, iskanje, koš, oznake in priljubljene.
  • Datoteke nalagaš in prenašaš neposredno med brskalnikom in Amazon S3. Datoteke nikoli ne gredo skozi strežnike Nubbo.
  • Deliš datoteke in mape z geslom, rokom veljavnosti in omejitvijo prenosov, prejemaš datoteke v svoj bucket in ustvarjaš galerije.
  • Tvoji ključi so shranjeni šifrirani z AES-256-GCM, bucket pa lahko kadar koli odklopiš.

Preden začneš

Potrebuješ račun pri Amazon S3 in račun Nubbo. Vsak bucket, ki ga povežeš, se šteje v omejitev tvojega paketa: paket Brezplačno jih dovoli 2, Personal 5, Pro pa nima omejitve. Nekatere regije AWS so privzeto onemogočene in jih moraš pred uporabo omogočiti v računu (na primer Milano, Zürich ali Cape Town). Če boš bucket ustvaril v eni od njih, jo najprej omogoči. Block Public Access ni treba izklopiti: Nubbo bucket ohrani zasebnega.

Izberi način povezave

Čarovnik Nubbo ponuja dve poti. Obe se končata enako: bucket je povezan in pripravljen za nalaganje iz brskalnika.

SamodejnoZ omejenim ključem
KljučDostop do celotnega računaOmejen na en bucket
BucketNubbo uporabi enega od tvojih ali ustvari novegaNajprej ga ustvariš sam
CORSNubbo doda pravilo namesto tebePravilo dodaš sam
Kdaj ga izbratiNajhitrejša potKo ne želiš dati dostopa do celotnega računa

Samodejna povezava

1. korak: ustvari ključ v Amazon S3

  1. Prijavi se v konzolo AWS in odpri IAM. Uporabi uporabnika IAM, nikoli korenskega uporabnika računa.
  2. Pojdi na Users in pritisni Create user. Daj mu ime, na primer nubbo, in pritisni Next.
  3. V Set permissions izberi Attach policies directly, poišči in označi AmazonS3FullAccess ter ustvari uporabnika.
  4. Odpri uporabnika, pojdi na zavihek Security credentials in pod Access keys pritisni Create access key.
  5. Kot primer uporabe izberi Application running outside AWS (ali Other, če ga ni na seznamu) in pritisni Next ter Create access key.
  6. Pritisni Download .csv file. To je edini trenutek, ko ti AWS pokaže skrivni dostopni ključ.

2. korak: poveži bucket v Nubbo

  1. V Nubbo odpri Bucketi in pritisni Poveži bucket. Izberi Amazon S3 in pritisni Nadaljuj.

    Korak Ponudnik v čarovniku Nubbo z izbranim Amazon S3 Korak Ponudnik v čarovniku Nubbo z izbranim Amazon S3
  2. Izberi Samodejno in pritisni Nadaljuj.

    Korak Način povezave z možnostma Samodejno in Z omejenim ključem Korak Način povezave z možnostma Samodejno in Z omejenim ključem
  3. V koraku Tvoj ključ pritisni Naloži datoteko in izberi preneseni CSV ali pa njegovo vsebino prilepi v polje z besedilom. Nubbo prebere dostopni ključ in skrivnost, zato ju ni treba prepisovati ročno. Preveri, ali je Regija regija tvojih bucketov. Pritisni Preveri ključ. Nubbo preveri, ali ključ deluje in ali ima dostop do celotnega računa.

    Korak Tvoj ključ za Amazon S3 s hitrim vodnikom in polji za ključ Korak Tvoj ključ za Amazon S3 s hitrim vodnikom in polji za ključ
  4. Izberi enega od svojih bucketov in pritisni Uporabi ta bucket ali pa označi Ustvari novega, vpiši ime (in izberi regijo, če jo zahteva) ter pritisni Ustvari in pripravi. Nubbo bucketu doda pravilo CORS, ki dovoljuje nalaganje in prenašanje samo iz aplikacije, obstoječa pravila pa ohrani.

    Korak Tvoj bucket s seznamom bucketov in možnostjo Ustvari novega Korak Tvoj bucket s seznamom bucketov in možnostjo Ustvari novega
  5. Preglej tri preverjanja, po želji spremeni Ime v Nubbo in pritisni Končaj. Bucket se prikaže v razdelku Bucketi in ga lahko odpreš v raziskovalcu.

    Korak Končano s preverjanji povezave, bucketa in CORS Korak Končano s preverjanji povezave, bucketa in CORS

Če Nubbo s tvojim ključem ne more dodati pravila CORS, te čarovnik pelje na korak CORS. Takrat sledi razdelku Dodaj pravilo CORS.

Povezava z omejenim ključem

1. korak: pripravi bucket in ključ v Amazon S3

  1. V konzoli izberi regijo v zgornji vrstici, odpri S3 in pod General purpose buckets pritisni Create bucket. Daj mu ime (od 3 do 63 znakov: male črke, številke, pike in vezaji) in ga ustvari z vklopljenim Block Public Access.
  2. V IAM ustvari uporabnika brez dovoljenj (Users, Create user).
  3. Odpri uporabnika, zavihek Permissions, Add permissions, Create inline policy. Preklopi na urejevalnik JSON, prilepi ta pravilnik, pri čemer YOUR-BUCKET zamenjaj z imenom svojega bucketa, in ga shrani pod nekim imenom.
  4. Ustvari ključ pod Security credentials, Create access key, kot pri samodejni povezavi, in prenesi 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/*"
    }
  ]
}

2. korak: poveži bucket v Nubbo

  1. V razdelku Bucketi pritisni Poveži bucket, izberi Amazon S3 in nato Z omejenim ključem.
  2. Naloži CSV s ključem ali prilepi njegovo vsebino in izberi regijo bucketa. Pritisni Preveri ključ.
  3. Vpiši natančno ime bucketa in pritisni Preveri dostop.
  4. Čarovnik preide na korak CORS s pravilom, ki ga moraš dodati.

Dodaj pravilo CORS

Pravilo CORS brskalniku omogoča nalaganje in prenašanje datotek iz tvojega bucketa na https://nubbo.app. To je isto pravilo, ki ga čarovnik prikaže v koraku CORS.

  1. V konzoli S3 odpri bucket in pojdi na zavihek Permissions.
  2. Pomakni se do Cross-origin resource sharing (CORS) in pritisni Edit.
  3. Prilepi pravilo in pritisni Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Korak CORS s pravilom, ki ga je treba dodati bucketu Korak CORS s pravilom, ki ga je treba dodati bucketu

Ko je shranjeno, se vrni v Nubbo in pritisni Dodano, preveri. Nekateri ponudniki potrebujejo minuto, da ga uveljavijo. Če ima tvoj ključ dovoljenje za spreminjanje CORS, to namesto tebe naredi Poskusi ga nastaviti namesto mene.

Če gre kaj narobe

Sporočilo v NubboKaj storiti
“Neveljavne poverilnice. Preveri dostopni ključ in skrivni dostopni ključ.”Znova kopiraj oba ključa, brez presledkov na začetku ali koncu.
“Ta ključ je videti omejen na en bucket. Lahko nadaljuješ po omejeni poti ali ustvariš ključ s polnim dostopom.”Pritisni Nadaljuj z omejenim ključem ali ustvari ključ z dostopom do celotnega računa in pritisni Poskusi drug ključ.
“Bucket ni najden. Preveri ime in regijo.”Preveri natančno ime bucketa in ali je izbrana regija tista, v kateri je bucket.
“Tvoj ključ nima dovoljenja za ustvarjanje bucketov.”Uporabi ključ s polnim dostopom ali ustvari bucket v svoji nadzorni plošči in pritisni Že ga imam v svoji nadzorni plošči.
“To ime je pri tem ponudniku že v uporabi; poskusi z drugim.”Imena bucketov so pri ponudniku edinstvena: izberi drugo.
“Tvoj ključ nima dovoljenja, da bi to nastavil.”Pravilo CORS dodaj ročno, kot je razloženo zgoraj.
“Še ne deluje. Preglej pravilo in preveri znova; nekateri ponudniki potrebujejo minuto, da ga uveljavijo.”Preveri, ali je izvor natanko https://nubbo.app brez poševnice na koncu, počakaj minuto in preveri znova.
“Ta bucket je že v uporabi.”Ta bucket je v Nubbo že povezan, v tvojem ali v drugem računu.
“Bucket je v drugi regiji. Preveri nastavljeno regijo.”V koraku Tvoj ključ izberi regijo, v kateri je bucket.
“V tej datoteki nismo našli ključev; prilepi jih ročno.”Naloži CSV, ki si ga prenesel ob ustvarjanju ključa, ali prilepi njegovo vsebino takšno, kot je.

Koliko stane

Amazon S3 zaračunava shranjevanje, zahteve in odhodni prenos podatkov. Na primerih to razložimo v članku Cene Amazon S3.

Pogosta vprašanja

Ali moram za uporabo Nubbo svoj bucket S3 narediti javen?

Ne. Nubbo bucket ohrani zasebnega in Block Public Access lahko ostane vklopljen. Nalaganja in prenosi uporabljajo presigned URL-je, ki potečejo.

Katera dovoljenja potrebuje ključ AWS?

Za samodejno pot pravilnik AmazonS3FullAccess. Z omejenim ključem zadošča vgrajeni pravilnik, ki daje dostop samo do tvojega bucketa: izpis, branje, pisanje in brisanje objektov.

Ali lahko uporabim ključe korenskega uporabnika AWS?

To ni dobra ideja in AWS to odsvetuje. Ustvari uporabnika IAM samo za Nubbo; njegov ključ lahko nato deaktiviraš, ne da bi se dotaknil česar koli drugega.

Zakaj Nubbo nima polj za ključ AWS?

Ker ti AWS ključ da v datoteki CSV. Nubbo jo prebere neposredno: naložiš jo ali prilepiš njeno vsebino in skrivnosti nikoli ne prepisuješ ročno.

Ali lahko povežem več bucketov S3?

Da. Vsak bucket se šteje v omejitev tvojega paketa: paket Brezplačno jih dovoli 2, Personal 5, Pro pa nima omejitve, prihajajo pa lahko iz različnih računov AWS.

Viri

Cene in omejitve so povzete po spodnjih uradnih straneh. Ponudniki jih spreminjajo, zato jih preveri, preden se odločiš.