Файловий менеджер для Amazon S3: підключіть його до Nubbo

Nubbo підключається до Amazon S3 за ключем доступу IAM. За кілька хвилин ваш бакет опиниться у файловому провіднику з прямими завантаженнями, посиланнями для спільного доступу та галереями, і нічого не доведеться робити публічним. Цей посібник крок за кроком проходить майстер Nubbo обома шляхами: автоматичним або з ключем, обмеженим одним бакетом.

Що ви отримуєте

• Переглядайте бакет як диск: папки, подання, пошук, кошик, мітки й обране.
• Завантажуйте файли напряму між браузером і Amazon S3. Файли ніколи не проходять через сервери Nubbo.
• Діліться файлами й папками з паролем, терміном дії та лімітом завантажень, отримуйте файли у свій бакет і створюйте галереї.
• Ваші ключі зберігаються зашифрованими за допомогою AES-256-GCM, і бакет можна відключити будь-коли.

Перед початком

Вам потрібні обліковий запис Amazon S3 і обліковий запис Nubbo. Кожен підключений бакет враховується в ліміті вашого тарифу: Безкоштовний дозволяє 2, Personal 5, а Pro не має обмежень. Деякі регіони AWS вимкнено за замовчуванням, і їх треба ввімкнути в обліковому записі, перш ніж ними користуватися (наприклад, Мілан, Цюрих чи Кейптаун). Якщо створюватимете бакет в одному з них, спершу ввімкніть його. Вимикати Block Public Access не потрібно: Nubbo залишає бакет приватним.

Виберіть спосіб підключення

Майстер Nubbo пропонує два шляхи. Обидва закінчуються однаково: бакет підключено й готово до завантажень із браузера.

Автоматичне підключення

Крок 1: створіть ключ в Amazon S3

1. Увійдіть у консоль AWS і відкрийте IAM. Використовуйте користувача IAM, ніколи не root-користувача облікового запису.
2. Перейдіть у Users і натисніть Create user. Дайте йому назву, наприклад nubbo, і натисніть Next.
3. У Set permissions виберіть Attach policies directly, знайдіть і позначте AmazonS3FullAccess та створіть користувача.
4. Відкрийте користувача, перейдіть на вкладку Security credentials і в розділі Access keys натисніть Create access key.
5. Як сценарій використання виберіть Application running outside AWS (або Other, якщо його немає в списку) і натисніть Next та Create access key.
6. Натисніть Download .csv file. Це єдиний раз, коли AWS показує секретний ключ доступу.

Крок 2: підключіть бакет у Nubbo

1. У Nubbo відкрийте Бакети й натисніть Підключити бакет. Виберіть Amazon S3 і натисніть Продовжити.

   

2. Виберіть Автоматично й натисніть Продовжити.

   

3. На кроці Ваш ключ натисніть Завантажити файл і виберіть завантажений CSV або вставте його вміст у текстове поле. Nubbo прочитає ключ доступу й секрет, тож вам не доведеться копіювати їх вручну. Переконайтеся, що Регіон збігається з регіоном ваших бакетів. Натисніть Перевірити ключ. Nubbo перевірить, що ключ працює і має доступ до всього облікового запису.

   

4. Виберіть один зі своїх бакетів і натисніть Використати цей bucket або виберіть Створити новий, введіть назву (і виберіть регіон, якщо майстер попросить) та натисніть Створити й підготувати. Nubbo додасть до бакета правило CORS, яке дозволяє завантаження лише із застосунку, і збереже правила, що вже є.

   

5. Перегляньте три перевірки, за бажання змініть Назва в Nubbo і натисніть Завершити. Бакет з’явиться в розділі Бакети, і його можна відкрити в провіднику.

   

Якщо Nubbo не може додати правило CORS з вашим ключем, майстер переведе вас на крок CORS. Тоді виконайте розділ Додайте правило CORS.

Підключення з обмеженим ключем

Крок 1: підготуйте бакет і ключ в Amazon S3

1. У консолі виберіть регіон на верхній панелі, відкрийте S3 і в розділі General purpose buckets натисніть Create bucket. Дайте йому назву (від 3 до 63 символів: малі літери, цифри, крапки й дефіси) і створіть його з увімкненим Block Public Access.
2. В IAM створіть користувача без дозволів (Users, Create user).
3. Відкрийте користувача, вкладка Permissions, Add permissions, Create inline policy. Перейдіть у редактор JSON, вставте цю політику, замінивши YOUR-BUCKET назвою свого бакета, і збережіть її під якоюсь назвою.
4. Створіть ключ у 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: підключіть бакет у Nubbo

1. У розділі Бакети натисніть Підключити бакет, виберіть Amazon S3, а потім З обмеженим ключем.
2. Завантажте CSV із ключем або вставте його вміст і виберіть регіон бакета. Натисніть Перевірити ключ.
3. Введіть точну назву бакета й натисніть Перевірити доступ.
4. Майстер перейде на крок CORS із правилом, яке треба додати.

Додайте правило CORS

Правило CORS дозволяє браузеру завантажувати файли у ваш бакет і з нього на https://nubbo.app. Це те саме правило, яке майстер показує на кроці CORS.

1. У консолі S3 відкрийте бакет і перейдіть на вкладку Permissions.
2. Прокрутіть до Cross-origin resource sharing (CORS) і натисніть Edit.
3. Вставте правило й натисніть Save changes.

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

Коли правило збережено, поверніться в Nubbo й натисніть Готово, перевірити. Деяким провайдерам потрібна хвилина, щоб його застосувати. Якщо ваш ключ має право змінювати CORS, кнопка Спробувати налаштувати за мене зробить це за вас.

Якщо щось пішло не так

Скільки це коштує

Amazon S3 бере плату за зберігання, запити й вихідний трафік. Ми пояснюємо це на прикладах у статті Ціни Amazon S3.