Juhendid

Failihaldur Amazon S3 jaoks: ühenda see Nubboga

Kuidas ühendada Amazon S3 bucket Nubboga: vajalik IAM-võti, viisard samm-sammult, CORS-reegel ja mida teha, kui midagi läheb valesti.

Nubbo ühendub Amazon S3-ga IAM-i ligipääsuvõtme abil. Mõne minutiga on sinu bucket failihalduris koos otseste üleslaadimiste, jagamislinkide ja galeriidega, ilma et peaksid midagi avalikuks tegema. See juhend järgib Nubbo viisardit samm-sammult mõlemal teel: automaatselt või ühe bucketiga piiratud võtmega.

Mida sa saad

  • Sirvi bucketit nagu ketast: kaustad, vaated, otsing, prügikast, sildid ja lemmikud.
  • Laadi faile üles ja alla otse oma brauseri ja Amazon S3 vahel. Failid ei läbi kunagi Nubbo servereid.
  • Jaga faile ja kaustu parooli, aegumise ja allalaadimiste piiranguga, võta faile vastu oma bucketisse ja loo galeriisid.
  • Sinu võtmed salvestatakse AES-256-GCM-iga krüpteeritult ja saad bucketi igal ajal lahti ühendada.

Enne alustamist

Vajad Amazon S3 kontot ja Nubbo kontot. Iga ühendatud bucket arvestatakse sinu paketi limiidi hulka: Tasuta pakett lubab 2, Personal 5 ja Pro puhul piirangut pole. Mõned AWS-i piirkonnad on vaikimisi välja lülitatud ja need tuleb kontol enne kasutamist lubada (näiteks Milano, Zürich või Kaplinn). Kui lood bucketi mõnes neist, luba see kõigepealt. Block Public Accessi pole vaja välja lülitada: Nubbo hoiab bucketi privaatsena.

Vali ühendusviis

Nubbo viisard pakub kahte teed. Mõlemad lõpevad samamoodi: bucket on ühendatud ja valmis brauserist üleslaadimiseks.

AutomaatnePiiratud võtmega
VõtiJuurdepääs kogu kontolePiiratud ühe bucketiga
BucketNubbo kasutab üht sinu omadest või loob uueLood selle kõigepealt ise
CORSNubbo lisab reegli sinu eestLisad reegli ise
Millal validaKiireim viisKui sa ei taha anda juurdepääsu kogu kontole

Automaatne ühendus

1. samm: loo võti Amazon S3-s

  1. Logi sisse AWS-i konsooli ja ava IAM. Kasuta IAM-kasutajat, mitte kunagi konto juurkasutajat (root).
  2. Mine jaotisse Users ja vajuta Create user. Anna kasutajale nimi, näiteks nubbo, ja vajuta Next.
  3. Vali jaotises Set permissions Attach policies directly, otsi üles ja märgi AmazonS3FullAccess ning loo kasutaja.
  4. Ava kasutaja, mine vahekaardile Security credentials ja vajuta jaotises Access keys Create access key.
  5. Vali kasutusjuhuks Application running outside AWS (või Other, kui seda loendis pole) ja vajuta Next ning Create access key.
  6. Vajuta Download .csv file. See on ainus kord, kui AWS lubab salajast ligipääsuvõtit näha.

2. samm: ühenda bucket Nubbos

  1. Ava Nubbos Bucketid ja vajuta Ühenda bucket. Vali Amazon S3 ja vajuta Jätka.

    Nubbo viisardi pakkuja samm, kus on valitud Amazon S3 Nubbo viisardi pakkuja samm, kus on valitud Amazon S3
  2. Vali Automaatne ja vajuta Jätka.

    Ühendusviisi samm valikutega Automaatne ja Piiratud võtmega Ühendusviisi samm valikutega Automaatne ja Piiratud võtmega
  3. Vajuta sammus Sinu võti nuppu Lae fail üles ja vali allalaaditud CSV või kleebi selle sisu tekstikasti. Nubbo loeb ligipääsuvõtme ja salajase võtme, nii et sa ei pea neid käsitsi kopeerima. Kontrolli, et Piirkond oleks sinu bucketite piirkond. Vajuta Kontrolli võtit. Nubbo kontrollib, et võti töötab ja et sellel on juurdepääs kogu kontole.

    Amazon S3 samm Sinu võti koos kiirjuhendi ja võtmeväljadega Amazon S3 samm Sinu võti koos kiirjuhendi ja võtmeväljadega
  4. Vali üks oma bucketitest ja vajuta Kasuta seda bucketit või vali Loo uus, sisesta nimi (ja vali piirkond, kui seda küsitakse) ning vajuta Loo ja valmista ette. Nubbo lisab bucketile CORS-reegli, mis lubab üles- ja allalaadimisi ainult rakendusest, ning säilitab bucketi olemasolevad reeglid.

    Samm Sinu bucket koos bucketite loendi ja valikuga Loo uus Samm Sinu bucket koos bucketite loendi ja valikuga Loo uus
  5. Vaata kolm kontrolli üle, muuda soovi korral välja Nimi Nubbos ja vajuta Lõpeta. Bucket ilmub jaotisse Bucketid ja saad selle failihalduris avada.

    Samm Valmis koos ühenduse, bucketi ja CORS-i kontrollidega Samm Valmis koos ühenduse, bucketi ja CORS-i kontrollidega

Kui Nubbo ei saa sinu võtmega CORS-reeglit lisada, viib viisard sind sammu CORS. Siis järgi juhiseid jaotises Lisa CORS-reegel.

Ühendus piiratud võtmega

1. samm: valmista Amazon S3-s ette bucket ja võti

  1. Vali konsoolis ülaribalt piirkond, ava S3 ja vajuta jaotises General purpose buckets Create bucket. Anna sellele nimi (3 kuni 63 tähemärki: väiketähed, numbrid, punktid ja sidekriipsud) ja loo see nii, et Block Public Access on sees.
  2. Loo jaotises IAM ilma õigusteta kasutaja (Users, Create user).
  3. Ava kasutaja, vahekaart Permissions, Add permissions, Create inline policy. Lülitu redaktorile JSON, kleebi see poliitika, asendades YOUR-BUCKET oma bucketi nimega, ja salvesta see mingi nimega.
  4. Loo võti jaotises Security credentials, Create access key, nagu automaatse ühenduse puhul, ja laadi CSV alla.
{
  "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. samm: ühenda bucket Nubbos

  1. Vajuta jaotises Bucketid Ühenda bucket, vali Amazon S3 ja seejärel Piiratud võtmega.
  2. Laadi võtme CSV üles või kleebi selle sisu ja vali bucketi piirkond. Vajuta Kontrolli võtit.
  3. Sisesta bucketi täpne nimi ja vajuta Kontrolli juurdepääsu.
  4. Viisard liigub sammu CORS koos reegliga, mille pead lisama.

Lisa CORS-reegel

CORS-reegel lubab brauseril sinu bucketist faile üles ja alla laadida aadressil https://nubbo.app. See on sama reegel, mida viisard näitab sammus CORS.

  1. Ava S3 konsoolis bucket ja mine vahekaardile Permissions.
  2. Keri alla jaotiseni Cross-origin resource sharing (CORS) ja vajuta Edit.
  3. Kleebi reegel ja vajuta Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
CORS-i samm koos reegliga, mis tuleb bucketile lisada CORS-i samm koos reegliga, mis tuleb bucketile lisada

Kui see on salvestatud, mine tagasi Nubbosse ja vajuta Lisasin, kontrolli. Mõnel teenusepakkujal kulub selle rakendamiseks minut. Kui sinu võtmel on õigus CORS-i muuta, teeb Proovi see minu eest seadistada selle sinu eest ära.

Kui midagi läheb valesti

Teade NubbosMida teha
“Vigased mandaadid. Kontrolli ligipääsuvõtit ja salajast ligipääsuvõtit.”Kopeeri mõlemad võtmed uuesti, ilma tühikuteta alguses või lõpus.
“See võti näib olevat piiratud ühe bucketiga. Võid jätkata piiratud teed või luua täieliku juurdepääsuga võtme.”Vajuta Jätka piiratud võtmega või loo võti, millel on juurdepääs kogu kontole, ja vajuta Proovi teist võtit.
“Bucketit ei leitud. Kontrolli nime ja regiooni.”Kontrolli bucketi täpset nime ja et valitud piirkond oleks bucketi piirkond.
“Sinu võtmel pole õigust bucketeid luua.”Kasuta täieliku juurdepääsuga võtit või loo bucket oma paneelil ja vajuta Lõin selle oma paneelil.
“See nimi on selle teenusepakkuja juures juba kasutusel; proovi mõnda teist.”Bucketite nimed on kogu teenusepakkuja ulatuses unikaalsed: vali mõni teine.
“Sinu võtmel pole õigust seda seadistada.”Lisa CORS-reegel käsitsi, nagu ülal kirjeldatud.
“See ei tööta veel. Vaata reegel üle ja kontrolli uuesti; mõnel pakkujal kulub selle rakendamiseks minut.”Kontrolli, et päritolu oleks täpselt https://nubbo.app ilma kaldkriipsuta lõpus, oota minut ja kontrolli uuesti.
“See bucket on juba kasutusel.”See bucket on Nubbos juba ühendatud, sinu kontol või mõnel teisel.
“Bucket asub teises regioonis. Kontrolli seadistatud regiooni.”Vali sammus Sinu võti piirkond, kus bucket asub.
“Me ei leidnud sellest failist võtmeid; kleebi need käsitsi.”Laadi üles CSV, mille võtme loomisel alla laadisid, või kleebi selle sisu muutmata kujul.

Mis see maksab

Amazon S3 võtab tasu salvestuse, päringute ja väljamineva andmeedastuse eest. Selgitame seda näidetega artiklis Amazon S3 hinnad.

Korduma kippuvad küsimused

Kas pean Nubbo kasutamiseks oma S3 bucketi avalikuks tegema?

Ei. Nubbo hoiab bucketi privaatsena ja Block Public Access võib sisse jääda. Üles- ja allalaadimised kasutavad aeguvaid presigned URL-e.

Milliseid õigusi AWS-i võti vajab?

Automaatse tee jaoks poliitikat AmazonS3FullAccess. Piiratud võtme puhul piisab inline-poliitikast, mis annab juurdepääsu ainult sinu bucketile: objektide loetlemine, lugemine, kirjutamine ja kustutamine.

Kas saan kasutada AWS-i juurkasutaja võtmeid?

See pole hea mõte ja AWS soovitab seda vältida. Loo IAM-kasutaja ainult Nubbo jaoks; siis saad selle võtme deaktiveerida ilma midagi muud puutumata.

Miks Nubbos pole AWS-i võtme jaoks välju?

Sest AWS annab võtme CSV-failina. Nubbo loeb selle otse: laadid faili üles või kleebid selle sisu ega kopeeri salajast võtit kunagi käsitsi.

Kas saan ühendada mitu S3 bucketit?

Jah. Iga bucket arvestatakse sinu paketi limiidi hulka: Tasuta pakett lubab 2, Personal 5 ja Pro puhul piirangut pole ning bucketid võivad olla eri AWS-i kontodelt.

Allikad

Hinnad ja piirangud pärinevad allpool toodud ametlikelt lehtedelt. Teenusepakkujad muudavad neid, seega kontrolli enne otsustamist.