Panduan

Pengelola file untuk Amazon S3: hubungkan ke Nubbo

Cara menghubungkan bucket Amazon S3 ke Nubbo: key IAM yang diperlukan, wizard langkah demi langkah, aturan CORS dan solusi jika ada masalah.

Nubbo terhubung ke Amazon S3 dengan access key IAM. Dalam beberapa menit, bucket Anda sudah tersedia di penjelajah file dengan unggahan langsung, tautan berbagi dan galeri, tanpa menjadikan apa pun publik. Panduan ini mengikuti wizard Nubbo langkah demi langkah, dengan kedua jalurnya: otomatis atau dengan key yang dibatasi ke satu bucket.

Yang Anda dapatkan

  • Jelajahi bucket seperti sebuah drive: folder, tampilan, pencarian, sampah, label dan favorit.
  • Unggah dan unduh file langsung antara browser Anda dan Amazon S3. File tidak pernah melewati server Nubbo.
  • Bagikan file dan folder dengan kata sandi, masa berlaku dan batas unduhan, terima file ke bucket Anda dan buat galeri.
  • Key Anda disimpan terenkripsi dengan AES-256-GCM dan Anda dapat memutuskan bucket kapan saja.

Sebelum memulai

Anda memerlukan akun Amazon S3 dan akun Nubbo. Setiap bucket yang Anda hubungkan dihitung dalam batas paket Anda: paket Gratis mengizinkan 2, Personal 5 dan Pro tanpa batas. Beberapa Region AWS dinonaktifkan secara default dan harus diaktifkan di akun sebelum digunakan (misalnya Milan, Zurich atau Cape Town). Jika Anda akan membuat bucket di salah satunya, aktifkan terlebih dahulu. Anda tidak perlu menonaktifkan Block Public Access: Nubbo menjaga bucket tetap privat.

Pilih cara menghubungkan

Wizard Nubbo menawarkan dua jalur. Keduanya berakhir dengan cara yang sama: bucket terhubung dan siap menerima unggahan dari browser.

OtomatisDengan key terbatas
KeyAkses ke seluruh akunDibatasi ke satu bucket
BucketNubbo menggunakan bucket Anda atau membuat baruAnda membuatnya terlebih dahulu
CORSNubbo menambahkan aturannya untuk AndaAnda yang menambahkan aturannya
Kapan memilihnyaCara tercepatSaat Anda tidak ingin memberi akses ke seluruh akun

Koneksi otomatis

Langkah 1: buat key di Amazon S3

  1. Masuk ke konsol AWS dan buka IAM. Gunakan pengguna IAM, jangan pernah pengguna root akun.
  2. Buka Users dan tekan Create user. Beri nama, misalnya nubbo, lalu tekan Next.
  3. Di Set permissions, pilih Attach policies directly, cari dan centang AmazonS3FullAccess, lalu buat penggunanya.
  4. Buka pengguna tersebut, masuk ke tab Security credentials dan, di bagian Access keys, tekan Create access key.
  5. Sebagai kasus penggunaan, pilih Application running outside AWS (atau Other jika tidak tercantum), lalu tekan Next dan Create access key.
  6. Tekan Download .csv file. Ini satu-satunya kesempatan AWS menampilkan secret access key kepada Anda.

Langkah 2: hubungkan bucket di Nubbo

  1. Di Nubbo, buka Bucket dan tekan Hubungkan bucket. Pilih Amazon S3 dan tekan Lanjutkan.

    Langkah Provider di wizard Nubbo dengan Amazon S3 terpilih Langkah Provider di wizard Nubbo dengan Amazon S3 terpilih
  2. Pilih Otomatis dan tekan Lanjutkan.

    Langkah Cara menghubungkan dengan opsi Otomatis dan Dengan key terbatas Langkah Cara menghubungkan dengan opsi Otomatis dan Dengan key terbatas
  3. Di langkah Key Anda, tekan Unggah file dan pilih CSV yang Anda unduh, atau tempel isinya ke kotak teks. Nubbo membaca access key dan secret sehingga Anda tidak perlu menyalinnya secara manual. Pastikan Wilayah sesuai dengan wilayah bucket Anda. Tekan Periksa key. Nubbo memeriksa bahwa key berfungsi dan memiliki akses ke seluruh akun.

    Langkah Key Anda untuk Amazon S3 dengan panduan cepat dan kolom key Langkah Key Anda untuk Amazon S3 dengan panduan cepat dan kolom key
  4. Pilih salah satu bucket Anda dan tekan Gunakan bucket ini, atau pilih Buat yang baru, ketik nama (dan pilih wilayah, jika diminta), lalu tekan Buat dan siapkan. Nubbo menambahkan aturan CORS ke bucket yang hanya mengizinkan unggahan dan unduhan dari aplikasi, dan tetap mempertahankan aturan yang sudah ada.

    Langkah Bucket Anda dengan daftar bucket dan opsi Buat yang baru Langkah Bucket Anda dengan daftar bucket dan opsi Buat yang baru
  5. Tinjau ketiga pemeriksaan, ubah Nama di Nubbo jika Anda mau, lalu tekan Selesai. Bucket akan muncul di halaman Bucket dan Anda dapat membukanya di explorer.

    Langkah Selesai dengan pemeriksaan koneksi, bucket dan CORS Langkah Selesai dengan pemeriksaan koneksi, bucket dan CORS

Jika Nubbo tidak dapat menambahkan aturan CORS dengan key Anda, wizard akan membawa Anda ke langkah CORS. Kemudian ikuti bagian Tambahkan aturan CORS.

Koneksi dengan key terbatas

Langkah 1: siapkan bucket dan key di Amazon S3

  1. Di konsol, pilih Region di bilah atas, buka S3 dan, di bagian General purpose buckets, tekan Create bucket. Beri nama (3 hingga 63 karakter: huruf kecil, angka, titik dan tanda hubung) dan buat dengan Block Public Access aktif.
  2. Di IAM, buat pengguna tanpa izin apa pun (Users, Create user).
  3. Buka pengguna tersebut, tab Permissions, Add permissions, Create inline policy. Beralih ke editor JSON, tempel kebijakan ini dengan mengganti YOUR-BUCKET dengan nama bucket Anda, lalu simpan dengan sebuah nama.
  4. Buat key di Security credentials, Create access key, seperti pada koneksi otomatis, lalu unduh CSV-nya.
{
  "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/*"
    }
  ]
}

Langkah 2: hubungkan bucket di Nubbo

  1. Di Bucket, tekan Hubungkan bucket, pilih Amazon S3, lalu Dengan key terbatas.
  2. Unggah CSV key atau tempel isinya dan pilih wilayah bucket. Tekan Periksa key.
  3. Ketik nama bucket yang persis dan tekan Periksa akses.
  4. Wizard berpindah ke langkah CORS dengan aturan yang perlu Anda tambahkan.

Tambahkan aturan CORS

Aturan CORS memungkinkan browser mengunggah dan mengunduh file dari bucket Anda di https://nubbo.app. Ini adalah aturan yang sama dengan yang ditampilkan wizard di langkah CORS.

  1. Di konsol S3, buka bucket dan masuk ke tab Permissions.
  2. Gulir ke bawah ke Cross-origin resource sharing (CORS) dan tekan Edit.
  3. Tempel aturannya dan tekan Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Langkah CORS dengan aturan yang perlu ditambahkan ke bucket Langkah CORS dengan aturan yang perlu ditambahkan ke bucket

Setelah tersimpan, kembali ke Nubbo dan tekan Sudah ditambahkan, periksa. Beberapa provider memerlukan waktu satu menit untuk menerapkannya. Jika key Anda diizinkan mengubah CORS, Coba konfigurasikan untuk saya akan melakukannya untuk Anda.

Jika ada masalah

Pesan di NubboYang harus dilakukan
“Kredensial tidak valid. Periksa access key dan secret access key.”Salin kembali kedua key, tanpa spasi di awal atau di akhir.
“Key ini tampaknya dibatasi ke satu bucket. Anda dapat melanjutkan dengan jalur terbatas atau membuat key dengan akses penuh.”Tekan Lanjutkan dengan key terbatas, atau buat key dengan akses ke seluruh akun dan tekan Coba key lain.
“Bucket tidak ditemukan. Periksa nama dan region.”Periksa nama bucket yang persis dan pastikan wilayah yang dipilih adalah wilayah bucket tersebut.
“Key Anda tidak diizinkan membuat bucket.”Gunakan key dengan akses penuh, atau buat bucket di panel Anda dan tekan Saya sudah membuatnya di panel saya.
“Nama itu sudah digunakan di provider ini; coba nama lain.”Nama bucket bersifat unik di seluruh provider: pilih nama lain.
“Key Anda tidak diizinkan untuk mengaturnya.”Tambahkan aturan CORS secara manual, seperti dijelaskan di atas.
“Belum berfungsi. Tinjau aturannya lalu periksa lagi; beberapa provider memerlukan waktu satu menit untuk menerapkannya.”Pastikan origin persis https://nubbo.app tanpa garis miring di akhir, tunggu satu menit dan periksa lagi.
“Bucket ini sudah digunakan.”Bucket tersebut sudah terhubung di Nubbo, di akun Anda atau di akun lain.
“Bucket berada di region yang berbeda. Periksa region yang dikonfigurasi.”Di langkah Key Anda, pilih wilayah tempat bucket berada.
“Kami tidak menemukan key di file tersebut; tempel secara manual.”Unggah CSV yang Anda unduh saat membuat key, atau tempel isinya apa adanya.

Berapa biayanya

Amazon S3 mengenakan biaya untuk penyimpanan, permintaan dan transfer data keluar. Kami menjelaskannya dengan contoh di Harga Amazon S3.

Pertanyaan yang sering diajukan

Apakah saya harus menjadikan bucket S3 publik untuk menggunakan Nubbo?

Tidak. Nubbo menjaga bucket tetap privat dan Block Public Access boleh tetap aktif. Unggahan dan unduhan menggunakan presigned URL yang kedaluwarsa.

Izin apa yang dibutuhkan key AWS?

Untuk jalur otomatis, kebijakan AmazonS3FullAccess. Dengan key terbatas, cukup kebijakan inline yang hanya memberi akses ke bucket Anda: mencantumkan, membaca, menulis dan menghapus objek.

Bisakah saya menggunakan key pengguna root AWS?

Itu bukan ide yang baik dan AWS tidak menyarankannya. Buat pengguna IAM khusus untuk Nubbo; nanti Anda dapat menonaktifkan key-nya tanpa menyentuh hal lain.

Mengapa Nubbo tidak memiliki kolom untuk key AWS?

Karena AWS memberikan key dalam bentuk CSV. Nubbo membacanya langsung: Anda mengunggahnya atau menempelkan isinya dan tidak pernah menyalin secret secara manual.

Bisakah saya menghubungkan beberapa bucket S3?

Ya. Setiap bucket dihitung dalam batas paket Anda: paket Gratis mengizinkan 2, Personal 5 dan Pro tanpa batas, dan bucket tersebut bisa berasal dari akun AWS yang berbeda.

Sumber

Harga dan batas berasal dari halaman resmi di bawah ini. Provider dapat mengubahnya, jadi periksa sebelum Anda memutuskan.