Bestandsbeheer voor Amazon S3: koppel het aan Nubbo

Nubbo maakt verbinding met Amazon S3 via een IAM access key. In een paar minuten staat je bucket in een bestandsverkenner met directe uploads, deellinks en galerijen, zonder iets openbaar te maken. Deze gids volgt de wizard van Nubbo stap voor stap, met beide routes: automatisch of met een sleutel die tot één bucket is beperkt.

Wat je krijgt

• Blader door de bucket alsof het een schijf is: mappen, weergaven, zoeken, prullenbak, labels en favorieten.
• Upload en download bestanden rechtstreeks tussen je browser en Amazon S3. Bestanden gaan nooit via de servers van Nubbo.
• Deel bestanden en mappen met een wachtwoord, vervaldatum en downloadlimiet, ontvang bestanden in je bucket en maak galerijen.
• Je sleutels worden versleuteld met AES-256-GCM bewaard en je kunt de bucket op elk moment loskoppelen.

Voordat je begint

Je hebt een account bij Amazon S3 en een Nubbo-account nodig. Elke bucket die je koppelt telt mee voor de limiet van je abonnement: het Gratis-abonnement staat er 2 toe, Personal 5 en Pro heeft geen limiet. Sommige AWS-regio’s zijn standaard uitgeschakeld en moeten in het account worden ingeschakeld voordat je ze gebruikt (bijvoorbeeld Milaan, Zürich of Kaapstad). Ga je de bucket in een daarvan aanmaken, schakel die regio dan eerst in. Je hoeft Block Public Access niet uit te zetten: Nubbo houdt de bucket privé.

Kies hoe je verbindt

De wizard van Nubbo biedt twee routes. Beide eindigen op dezelfde manier: de bucket verbonden en klaar voor uploads vanuit de browser.

Automatische verbinding

Stap 1: maak de sleutel aan in Amazon S3

1. Log in bij de AWS-console en open IAM. Gebruik een IAM-gebruiker, nooit de root user van het account.
2. Ga naar Users en klik op Create user. Geef een naam op, bijvoorbeeld nubbo, en klik op Next.
3. Kies bij Set permissions voor Attach policies directly, zoek AmazonS3FullAccess op, vink het aan en maak de gebruiker aan.
4. Open de gebruiker, ga naar het tabblad Security credentials en klik onder Access keys op Create access key.
5. Kies als use case Application running outside AWS (of Other als die er niet tussen staat) en klik op Next en Create access key.
6. Klik op Download .csv file. Dit is de enige keer dat AWS je de secret access key laat zien.

Stap 2: verbind de bucket in Nubbo

1. Open in Nubbo Buckets en klik op Bucket koppelen. Kies Amazon S3 en klik op Doorgaan.

   

2. Kies Automatisch en klik op Doorgaan.

   

3. Klik in de stap Je sleutel op Bestand uploaden en kies de CSV die je hebt gedownload, of plak de inhoud in het tekstvak. Nubbo leest de access key en de secret, zodat je ze niet met de hand hoeft over te nemen. Controleer of de Regio die van je buckets is. Klik op Sleutel controleren. Nubbo controleert of de sleutel werkt en of hij toegang heeft tot het hele account.

   

4. Kies een van je buckets en klik op Deze bucket gebruiken, of selecteer Nieuwe maken, typ een naam (en kies de regio, als daarom wordt gevraagd) en klik op Maken en voorbereiden. Nubbo voegt een CORS-regel aan de bucket toe die alleen uploads en downloads vanuit de app toestaat, en laat de regels die er al zijn staan.

   

5. Bekijk de drie controles, wijzig eventueel de Naam in Nubbo en klik op Afronden. De bucket verschijnt in Buckets en je kunt hem openen in de verkenner.

   

Kan Nubbo de CORS-regel niet toevoegen met je sleutel, dan brengt de wizard je naar de stap CORS. Volg in dat geval Voeg de CORS-regel toe.

Verbinding met een beperkte sleutel

Stap 1: bereid de bucket en de sleutel voor in Amazon S3

1. Kies in de console de regio in de bovenste balk, open S3 en klik onder General purpose buckets op Create bucket. Geef hem een naam (3 tot 63 tekens: kleine letters, cijfers, punten en koppeltekens) en maak hem aan met Block Public Access ingeschakeld.
2. Maak in IAM een gebruiker zonder rechten aan (Users, Create user).
3. Open de gebruiker, tabblad Permissions, Add permissions, Create inline policy. Schakel over naar de JSON-editor, plak dit beleid, vervang YOUR-BUCKET door de naam van je bucket en sla het op met een naam.
4. Maak de sleutel aan onder Security credentials, Create access key, net als bij de automatische verbinding, en download de 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/*"
    }
  ]
}

Stap 2: verbind de bucket in Nubbo

1. Klik in Buckets op Bucket koppelen, kies Amazon S3 en daarna Met een beperkte sleutel.
2. Upload de CSV met de sleutel of plak de inhoud en kies de regio van de bucket. Klik op Sleutel controleren.
3. Typ de exacte naam van de bucket en klik op Toegang controleren.
4. De wizard gaat naar de stap CORS met de regel die je moet toevoegen.

Voeg de CORS-regel toe

Met de CORS-regel kan de browser bestanden uploaden naar en downloaden uit je bucket op https://nubbo.app. Het is dezelfde regel die de wizard in de stap CORS toont.

1. Open in de S3-console de bucket en ga naar het tabblad Permissions.
2. Scrol omlaag naar Cross-origin resource sharing (CORS) en klik op Edit.
3. Plak de regel en klik op Save changes.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Is de regel opgeslagen, ga dan terug naar Nubbo en klik op Toegevoegd, controleren. Sommige providers hebben een minuut nodig om hem toe te passen. Mag je sleutel CORS wijzigen, dan regelt Probeer het voor mij in te stellen het voor je.

Als er iets misgaat

Wat het kost

Amazon S3 rekent voor opslag, verzoeken en uitgaand dataverkeer. We leggen het uit met voorbeelden in Prijzen van Amazon S3.