Veiledninger

Filbehandler for Amazon S3: koble den til Nubbo

Slik kobler du en Amazon S3-bucket til Nubbo: IAM-nøkkelen du trenger, veiviseren steg for steg, CORS-regelen og hva du gjør hvis noe går galt.

Nubbo kobler seg til Amazon S3 med en IAM-tilgangsnøkkel. På noen få minutter ligger bucketen din i en filutforsker med direkte opplastinger, delingslenker og gallerier, uten at noe blir offentlig. Denne veiledningen følger veiviseren i Nubbo steg for steg, med begge veiene: automatisk eller med en nøkkel som er begrenset til én bucket.

Dette får du

  • Bla gjennom bucketen som en disk: mapper, visninger, søk, papirkurv, etiketter og favoritter.
  • Last opp og ned filer direkte mellom nettleseren din og Amazon S3. Filene går aldri via Nubbos servere.
  • Del filer og mapper med passord, utløpsdato og nedlastingsgrense, motta filer i bucketen din og lag gallerier.
  • Nøklene dine lagres kryptert med AES-256-GCM, og du kan koble fra bucketen når som helst.

Før du begynner

Du trenger en konto hos Amazon S3 og en Nubbo-konto. Hver bucket du kobler til, teller mot grensen i planen din: Gratis-planen tillater 2, Personal 5 og Pro har ingen grense. Noen AWS-regioner er slått av som standard og må aktiveres i kontoen før du bruker dem (for eksempel Milano, Zürich eller Cape Town). Hvis du skal opprette bucketen i en av dem, må du aktivere den først. Du trenger ikke å slå av Block Public Access: Nubbo holder bucketen privat.

Velg hvordan du kobler til

Veiviseren i Nubbo har to veier. Begge ender på samme måte: bucketen er tilkoblet og klar for opplastinger fra nettleseren.

AutomatiskMed en begrenset nøkkel
NøkkelTilgang til hele kontoenBegrenset til én bucket
BucketNubbo bruker en av dine eller oppretter en nyDu oppretter den først
CORSNubbo legger til regelen for degDu legger til regelen
Når du bør velge denDen raskeste veienNår du ikke vil gi tilgang til hele kontoen

Automatisk tilkobling

Steg 1: opprett nøkkelen i Amazon S3

  1. Logg inn i AWS-konsollen og åpne IAM. Bruk en IAM-bruker, aldri rotbrukeren for kontoen.
  2. Gå til Users og trykk på Create user. Gi den et navn, for eksempel nubbo, og trykk på Next.
  3. Under Set permissions velger du Attach policies directly, søker etter og krysser av for AmazonS3FullAccess og oppretter brukeren.
  4. Åpne brukeren, gå til fanen Security credentials og trykk på Create access key under Access keys.
  5. Velg Application running outside AWS som bruksområde (eller Other hvis det ikke står på listen), og trykk på Next og Create access key.
  6. Trykk på Download .csv file. Det er den eneste gangen AWS lar deg se den hemmelige tilgangsnøkkelen.

Steg 2: koble til bucketen i Nubbo

  1. I Nubbo åpner du Buckets og trykker på Koble til bucket. Velg Amazon S3 og trykk på Fortsett.

    Steget Leverandør i Nubbo-veiviseren med Amazon S3 valgt Steget Leverandør i Nubbo-veiviseren med Amazon S3 valgt
  2. Velg Automatisk og trykk på Fortsett.

    Steget Tilkobling med valgene Automatisk og Med en begrenset nøkkel Steget Tilkobling med valgene Automatisk og Med en begrenset nøkkel
  3. I steget Din nøkkel trykker du på Last opp fil og velger CSV-filen du lastet ned, eller limer inn innholdet i tekstfeltet. Nubbo leser tilgangsnøkkelen og hemmeligheten, så du slipper å kopiere dem manuelt. Sjekk at Region er regionen til bucketene dine. Trykk på Sjekk nøkkel. Nubbo sjekker at nøkkelen fungerer og at den har tilgang til hele kontoen.

    Steget Din nøkkel for Amazon S3 med hurtigveiledningen og nøkkelfeltene Steget Din nøkkel for Amazon S3 med hurtigveiledningen og nøkkelfeltene
  4. Velg en av bucketene dine og trykk på Bruk denne bucketen, eller velg Opprett en ny, skriv inn et navn (og velg regionen hvis du blir spurt) og trykk på Opprett og klargjør. Nubbo legger til en CORS-regel i bucketen som bare tillater opplastinger og nedlastinger fra appen, og beholder reglene som allerede finnes.

    Steget Din bucket med listen over bucketer og valget Opprett en ny Steget Din bucket med listen over bucketer og valget Opprett en ny
  5. Se over de tre sjekkene, endre Navn i Nubbo hvis du vil, og trykk på Fullfør. Bucketen dukker opp under Buckets, og du kan åpne den i utforskeren.

    Steget Ferdig med sjekkene for tilkobling, bucket og CORS Steget Ferdig med sjekkene for tilkobling, bucket og CORS

Hvis Nubbo ikke kan legge til CORS-regelen med nøkkelen din, tar veiviseren deg til steget CORS. Følg da Legg til CORS-regelen.

Tilkobling med en begrenset nøkkel

Steg 1: klargjør bucketen og nøkkelen i Amazon S3

  1. I konsollen velger du regionen i den øverste linjen, åpner S3 og trykker på Create bucket under General purpose buckets. Gi den et navn (3 til 63 tegn: små bokstaver, tall, punktum og bindestreker) og opprett den med Block Public Access slått på.
  2. I IAM oppretter du en bruker uten tillatelser (Users, Create user).
  3. Åpne brukeren, fanen Permissions, Add permissions, Create inline policy. Bytt til JSON-redigeringen, lim inn denne policyen, erstatt YOUR-BUCKET med navnet på bucketen din og lagre den med et navn.
  4. Opprett nøkkelen under Security credentials, Create access key, som ved den automatiske tilkoblingen, og last ned CSV-filen.
{
  "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/*"
    }
  ]
}

Steg 2: koble til bucketen i Nubbo

  1. I Buckets trykker du på Koble til bucket, velger Amazon S3 og deretter Med en begrenset nøkkel.
  2. Last opp CSV-filen med nøkkelen eller lim inn innholdet, og velg regionen til bucketen. Trykk på Sjekk nøkkel.
  3. Skriv inn det nøyaktige navnet på bucketen og trykk på Sjekk tilgang.
  4. Veiviseren går videre til steget CORS med regelen du må legge til.

Legg til CORS-regelen

CORS-regelen lar nettleseren laste opp og ned filer fra bucketen din på https://nubbo.app. Det er den samme regelen som veiviseren viser i steget CORS.

  1. I S3-konsollen åpner du bucketen og går til fanen Permissions.
  2. Rull ned til Cross-origin resource sharing (CORS) og trykk på Edit.
  3. Lim inn regelen og trykk på Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Steget CORS med regelen som skal legges til i bucketen Steget CORS med regelen som skal legges til i bucketen

Når den er lagret, går du tilbake til Nubbo og trykker på Jeg har lagt den til, sjekk. Noen leverandører bruker et minutt på å ta den i bruk. Hvis nøkkelen din har lov til å endre CORS, gjør Prøv å konfigurere det for meg det for deg.

Hvis noe går galt

Melding i NubboHva du gjør
«Ugyldig legitimasjon. Sjekk tilgangsnøkkelen og den hemmelige nøkkelen.»Kopier begge nøklene på nytt, uten mellomrom i starten eller slutten.
«Denne nøkkelen ser ut til å være begrenset til én bucket. Du kan fortsette med den begrensede veien eller opprette en nøkkel med full tilgang.»Trykk på Fortsett med begrenset nøkkel, eller opprett en nøkkel med tilgang til hele kontoen og trykk på Prøv en annen nøkkel.
«Fant ikke bucketen. Sjekk navnet og regionen.»Sjekk det nøyaktige navnet på bucketen og at regionen du har valgt, er bucketens region.
«Nøkkelen din har ikke tillatelse til å opprette buckets.»Bruk en nøkkel med full tilgang, eller opprett bucketen i panelet ditt og trykk på Jeg har opprettet den i panelet mitt.
«Det navnet er allerede i bruk hos denne leverandøren; prøv et annet.»Bucketnavn er unike hos hele leverandøren: velg et annet.
«Nøkkelen din har ikke tillatelse til å sette det opp.»Legg til CORS-regelen manuelt, som forklart ovenfor.
«Det fungerer ikke ennå. Gå gjennom regelen og sjekk igjen; noen leverandører bruker et minutt på å ta den i bruk.»Sjekk at opprinnelsen er nøyaktig https://nubbo.app uten skråstrek til slutt, vent et minutt og sjekk igjen.
«Denne bucketen er allerede i bruk.»Den bucketen er allerede tilkoblet i Nubbo, i kontoen din eller i en annen konto.
«Bucketen er i en annen region. Sjekk den konfigurerte regionen.»I steget Din nøkkel velger du regionen bucketen ligger i.
«Vi fant ikke nøklene i den filen; lim dem inn manuelt.»Last opp CSV-filen du lastet ned da du opprettet nøkkelen, eller lim inn innholdet slik det er.

Hva det koster

Amazon S3 tar betalt for lagring, forespørsler og dataoverføring ut. Vi forklarer det med eksempler i Priser for Amazon S3.

Ofte stilte spørsmål

Må S3-bucketen min være offentlig for å bruke Nubbo?

Nei. Nubbo holder bucketen privat, og Block Public Access kan forbli slått på. Opplastinger og nedlastinger bruker forhåndssignerte URL-er som utløper.

Hvilke tillatelser trenger AWS-nøkkelen?

For den automatiske veien trenger du policyen AmazonS3FullAccess. Med en begrenset nøkkel holder det med en inline-policy som bare gir tilgang til bucketen din: liste, lese, skrive og slette objekter.

Kan jeg bruke nøklene til AWS-rotbrukeren?

Det er ingen god idé, og AWS fraråder det. Opprett en IAM-bruker bare for Nubbo; da kan du deaktivere nøkkelen uten å røre noe annet.

Hvorfor har ikke Nubbo felt for AWS-nøkkelen?

Fordi AWS gir deg nøkkelen i en CSV-fil. Nubbo leser den direkte: du laster den opp eller limer inn innholdet, og du kopierer aldri hemmeligheten manuelt.

Kan jeg koble til flere S3-bucketer?

Ja. Hver bucket teller mot grensen i planen din: Gratis-planen tillater 2, Personal 5 og Pro har ingen grense, og de kan komme fra forskjellige AWS-kontoer.

Kilder

Priser og grenser er hentet fra de offisielle sidene nedenfor. Leverandørene endrer dem, så sjekk før du bestemmer deg.