Το Nubbo συνδέεται με το Amazon S3 μέσω ενός access key του IAM. Σε λίγα λεπτά το bucket σου βρίσκεται σε έναν εξερευνητή αρχείων με απευθείας ανεβάσματα, συνδέσμους κοινοποίησης και γκαλερί, χωρίς να κάνεις τίποτα δημόσιο. Αυτός ο οδηγός ακολουθεί τον βοηθό του Nubbo βήμα προς βήμα, και με τους δύο τρόπους: αυτόματα ή με κλειδί περιορισμένο σε ένα bucket.
Τι κερδίζεις
- Εξερεύνησε το bucket σαν δίσκο: φάκελοι, προβολές, αναζήτηση, κάδος, ετικέτες και αγαπημένα.
- Ανέβασε και κατέβασε αρχεία απευθείας μεταξύ του browser σου και του Amazon S3. Τα αρχεία δεν περνούν ποτέ από τους servers του Nubbo.
- Μοιράσου αρχεία και φακέλους με κωδικό, λήξη και όριο λήψεων, λάβε αρχεία στο bucket σου και δημιούργησε γκαλερί.
- Τα κλειδιά σου αποθηκεύονται κρυπτογραφημένα με AES-256-GCM και μπορείς να αποσυνδέσεις το bucket όποτε θέλεις.
Πριν ξεκινήσεις
Χρειάζεσαι έναν λογαριασμό στο Amazon S3 και έναν λογαριασμό στο Nubbo. Κάθε bucket που συνδέεις μετράει στο όριο του πλάνου σου: το Δωρεάν επιτρέπει 2, το Personal 5 και το Pro δεν έχει όριο. Ορισμένες περιοχές AWS είναι απενεργοποιημένες από προεπιλογή και πρέπει να τις ενεργοποιήσεις στον λογαριασμό πριν τις χρησιμοποιήσεις (για παράδειγμα Μιλάνο, Ζυρίχη ή Κέιπ Τάουν). Αν θα δημιουργήσεις το bucket σε μία από αυτές, ενεργοποίησέ την πρώτα. Δεν χρειάζεται να απενεργοποιήσεις το Block Public Access: το Nubbo κρατά το bucket ιδιωτικό.
Διάλεξε πώς θα συνδεθείς
Ο βοηθός του Nubbo προσφέρει δύο τρόπους. Και οι δύο καταλήγουν στο ίδιο: το bucket συνδεδεμένο και έτοιμο για ανεβάσματα από τον browser.
| Αυτόματα | Με περιορισμένο κλειδί | |
|---|---|---|
| Κλειδί | Πρόσβαση σε όλο τον λογαριασμό | Περιορισμένο σε ένα bucket |
| Bucket | Το Nubbo χρησιμοποιεί ένα δικό σου ή δημιουργεί νέο | Το δημιουργείς εσύ πρώτα |
| CORS | Το Nubbo προσθέτει τον κανόνα για σένα | Προσθέτεις εσύ τον κανόνα |
| Πότε να το επιλέξεις | Ο πιο γρήγορος τρόπος | Όταν δεν θέλεις να δώσεις πρόσβαση σε όλο τον λογαριασμό |
Αυτόματη σύνδεση
Βήμα 1: δημιούργησε το κλειδί στο Amazon S3
- Συνδέσου στην κονσόλα AWS και άνοιξε το IAM. Χρησιμοποίησε έναν χρήστη IAM, ποτέ τον root user του λογαριασμού.
- Πήγαινε στο Users και πάτησε Create user. Δώσε του ένα όνομα, για παράδειγμα
nubbo, και πάτησε Next. - Στο Set permissions, επίλεξε Attach policies directly, αναζήτησε και τσέκαρε το AmazonS3FullAccess και δημιούργησε τον χρήστη.
- Άνοιξε τον χρήστη, πήγαινε στην καρτέλα Security credentials και, στο Access keys, πάτησε Create access key.
- Ως use case επίλεξε Application running outside AWS (ή Other αν δεν εμφανίζεται) και πάτησε Next και Create access key.
- Πάτησε Download .csv file. Είναι η μόνη φορά που το AWS σού δείχνει το secret access key.
Βήμα 2: σύνδεσε το bucket στο Nubbo
Στο Nubbo, άνοιξε την ενότητα Buckets και πάτησε Σύνδεση bucket. Επίλεξε Amazon S3 και πάτησε Συνέχεια.
Επίλεξε Αυτόματα και πάτησε Συνέχεια.
Στο βήμα Το κλειδί σου, πάτησε Ανέβασμα αρχείου και διάλεξε το CSV που κατέβασες ή επικόλλησε το περιεχόμενό του στο πλαίσιο κειμένου. Το Nubbo διαβάζει το access key και το secret, ώστε να μην χρειάζεται να τα αντιγράψεις με το χέρι. Έλεγξε ότι η Περιοχή είναι η περιοχή των buckets σου. Πάτησε Έλεγχος κλειδιού. Το Nubbo ελέγχει ότι το κλειδί λειτουργεί και ότι έχει πρόσβαση σε όλο τον λογαριασμό.
Διάλεξε ένα από τα buckets σου και πάτησε Χρήση αυτού του bucket ή επίλεξε Δημιουργία νέου, γράψε ένα όνομα (και διάλεξε την περιοχή, αν σου ζητηθεί) και πάτησε Δημιουργία και προετοιμασία. Το Nubbo προσθέτει στο bucket έναν κανόνα CORS που επιτρέπει ανεβάσματα και λήψεις μόνο από την εφαρμογή και κρατά τους κανόνες που ήδη έχει.
Έλεγξε τους τρεις ελέγχους, άλλαξε το Όνομα στο Nubbo αν θέλεις και πάτησε Ολοκλήρωση. Το bucket εμφανίζεται στην ενότητα Buckets και μπορείς να το ανοίξεις στον εξερευνητή.
Αν το Nubbo δεν μπορεί να προσθέσει τον κανόνα CORS με το κλειδί σου, ο βοηθός σε πηγαίνει στο βήμα CORS. Τότε ακολούθησε την ενότητα Πρόσθεσε τον κανόνα CORS.
Σύνδεση με περιορισμένο κλειδί
Βήμα 1: ετοίμασε το bucket και το κλειδί στο Amazon S3
- Στην κονσόλα, επίλεξε την περιοχή στην πάνω μπάρα, άνοιξε το S3 και, στο General purpose buckets, πάτησε Create bucket. Δώσε του ένα όνομα (3 έως 63 χαρακτήρες: πεζά γράμματα, αριθμοί, τελείες και παύλες) και δημιούργησέ το με ενεργό το Block Public Access.
- Στο IAM, δημιούργησε έναν χρήστη χωρίς δικαιώματα (Users, Create user).
- Άνοιξε τον χρήστη, καρτέλα Permissions, Add permissions, Create inline policy. Πέρασε στον editor JSON, επικόλλησε αυτή την πολιτική αντικαθιστώντας το
YOUR-BUCKETμε το όνομα του bucket σου και αποθήκευσέ την με ένα όνομα. - Δημιούργησε το κλειδί στο Security credentials, Create access key, όπως στην αυτόματη σύνδεση, και κατέβασε το 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: σύνδεσε το bucket στο Nubbo
- Στην ενότητα Buckets, πάτησε Σύνδεση bucket, επίλεξε Amazon S3 και μετά Με περιορισμένο κλειδί.
- Ανέβασε το CSV του κλειδιού ή επικόλλησε το περιεχόμενό του και επίλεξε την περιοχή του bucket. Πάτησε Έλεγχος κλειδιού.
- Γράψε το ακριβές όνομα του bucket και πάτησε Έλεγχος πρόσβασης.
- Ο βοηθός περνά στο βήμα CORS με τον κανόνα που πρέπει να προσθέσεις.
Πρόσθεσε τον κανόνα CORS
Ο κανόνας CORS επιτρέπει στον browser να ανεβάζει και να κατεβάζει αρχεία από το bucket σου στο https://nubbo.app. Είναι ο ίδιος κανόνας που δείχνει ο βοηθός στο βήμα CORS.
- Στην κονσόλα S3, άνοιξε το bucket και πήγαινε στην καρτέλα Permissions.
- Κατέβα στο Cross-origin resource sharing (CORS) και πάτησε Edit.
- Επικόλλησε τον κανόνα και πάτησε Save changes.
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
"AllowedOrigins": ["https://nubbo.app"],
"ExposeHeaders": ["ETag"],
"MaxAgeSeconds": 3600
}
]
Μόλις αποθηκευτεί, γύρνα στο Nubbo και πάτησε Τον πρόσθεσα, έλεγχος. Ορισμένοι πάροχοι χρειάζονται ένα λεπτό για να τον εφαρμόσουν. Αν το κλειδί σου έχει δικαίωμα να αλλάζει το CORS, το Δοκίμασε να το ρυθμίσεις για μένα το κάνει για σένα.
Αν κάτι πάει στραβά
| Μήνυμα στο Nubbo | Τι να κάνεις |
|---|---|
| «Μη έγκυρα διαπιστευτήρια. Έλεγξε το access key και το secret access key.» | Αντίγραψε ξανά και τα δύο κλειδιά, χωρίς κενά στην αρχή ή στο τέλος. |
| «Αυτό το κλειδί φαίνεται περιορισμένο σε ένα bucket. Μπορείς να συνεχίσεις με τον περιορισμένο τρόπο ή να δημιουργήσεις ένα κλειδί με πλήρη πρόσβαση.» | Πάτησε Συνέχεια με περιορισμένο κλειδί ή δημιούργησε ένα κλειδί με πρόσβαση σε όλο τον λογαριασμό και πάτησε Δοκίμασε άλλο κλειδί. |
| «Το bucket δεν βρέθηκε. Επιβεβαίωσε το όνομα και την περιοχή.» | Έλεγξε το ακριβές όνομα του bucket και ότι η περιοχή που επέλεξες είναι αυτή του bucket. |
| «Το κλειδί σου δεν έχει δικαίωμα να δημιουργεί bucket.» | Χρησιμοποίησε ένα κλειδί με πλήρη πρόσβαση ή δημιούργησε το bucket στον πίνακά σου και πάτησε Το δημιούργησα στον πίνακά μου. |
| «Αυτό το όνομα χρησιμοποιείται ήδη σε αυτόν τον πάροχο· δοκίμασε άλλο.» | Τα ονόματα των buckets είναι μοναδικά σε όλο τον πάροχο: διάλεξε άλλο. |
| «Το κλειδί σου δεν έχει δικαίωμα να το ρυθμίσει.» | Πρόσθεσε τον κανόνα CORS με το χέρι, όπως εξηγείται παραπάνω. |
| «Δεν λειτουργεί ακόμα. Έλεγξε τον κανόνα και δοκίμασε ξανά. Ορισμένοι πάροχοι χρειάζονται ένα λεπτό για να τον εφαρμόσουν.» | Έλεγξε ότι το origin είναι ακριβώς https://nubbo.app χωρίς κάθετο στο τέλος, περίμενε ένα λεπτό και έλεγξε ξανά. |
| «Αυτό το bucket χρησιμοποιείται ήδη.» | Αυτό το bucket είναι ήδη συνδεδεμένο στο Nubbo, στον λογαριασμό σου ή σε άλλον. |
| «Το bucket βρίσκεται σε διαφορετική περιοχή. Επιβεβαίωσε τη ρυθμισμένη περιοχή.» | Στο βήμα Το κλειδί σου, επίλεξε την περιοχή όπου βρίσκεται το bucket. |
| «Δεν βρήκαμε τα κλειδιά σε αυτό το αρχείο. Επικόλλησέ τα χειροκίνητα.» | Ανέβασε το CSV που κατέβασες όταν δημιούργησες το κλειδί ή επικόλλησε το περιεχόμενό του όπως είναι. |
Πόσο κοστίζει
Το Amazon S3 χρεώνει την αποθήκευση, τα αιτήματα και τη μεταφορά δεδομένων προς τα έξω. Το εξηγούμε με παραδείγματα στο Τιμές Amazon S3.
Συχνές ερωτήσεις
Πρέπει να κάνω δημόσιο το S3 bucket μου για να χρησιμοποιήσω το Nubbo;
Όχι. Το Nubbo κρατά το bucket ιδιωτικό και το Block Public Access μπορεί να μείνει ενεργό. Τα ανεβάσματα και οι λήψεις χρησιμοποιούν presigned URLs που λήγουν.
Τι δικαιώματα χρειάζεται το κλειδί AWS;
Για τον αυτόματο τρόπο, την πολιτική AmazonS3FullAccess. Με περιορισμένο κλειδί αρκεί μια inline policy που δίνει πρόσβαση μόνο στο bucket σου: λίστα, ανάγνωση, εγγραφή και διαγραφή αντικειμένων.
Μπορώ να χρησιμοποιήσω τα κλειδιά του root user του AWS;
Δεν είναι καλή ιδέα και το AWS το αποθαρρύνει. Δημιούργησε έναν χρήστη IAM μόνο για το Nubbo: έτσι μπορείς αργότερα να απενεργοποιήσεις το κλειδί του χωρίς να αγγίξεις τίποτα άλλο.
Γιατί το Nubbo δεν έχει πεδία για το κλειδί AWS;
Επειδή το AWS σού δίνει το κλειδί σε ένα CSV. Το Nubbo το διαβάζει απευθείας: το ανεβάζεις ή επικολλάς το περιεχόμενό του και δεν αντιγράφεις ποτέ το secret με το χέρι.
Μπορώ να συνδέσω πολλά S3 buckets;
Ναι. Κάθε bucket μετράει στο όριο του πλάνου σου: το Δωρεάν επιτρέπει 2, το Personal 5 και το Pro δεν έχει όριο, και μπορούν να προέρχονται από διαφορετικούς λογαριασμούς AWS.
Πηγές
Οι τιμές και τα όρια προέρχονται από τις επίσημες σελίδες παρακάτω. Οι πάροχοι τα αλλάζουν, γι' αυτό έλεγξέ τα πριν δεσμευτείς.