Как создать ключ DigitalOcean Space и API

DigitalOcean Spaces - это сервис хранения объектов, который позволяет легко и экономично хранить и обслуживать большие объемы данных. Отдельные пространства могут быть созданы и использованы быстро, без необходимости настройки.

В этом руководстве мы будем использовать панель управления DigitalOcean для создания нового пространства. Затем мы получим ключ и секрет API, которые можно использовать для предоставления доступа к Space в любом S3-совместимом клиенте или библиотеке.

Чтобы пройти этот урок, вам понадобится учетная запись DigitalOcean. Если у вас его еще нет, вы можете зарегистрироваться наthe signup page.

Войдите в панель управления DigitalOcean, чтобы начать.

Чтобы создать новое пространство, используйте кнопкуCreate в правом верхнем углу панели управления. Нажмите кнопку, затем выберитеSpaces из раскрывающегося списка:

Если вы никогда раньше не создавали пространство, вы также можете создать его прямо со страницыSpaces. Для этого щелкнитеSpaces в основной навигации Панели управления, затем щелкнитеCreate a space. Любой из вариантов приведет вас к экрануCreate a Space:

Сначала выберите название для вашего пространства. Это имя должно быть уникальным среди всех пробелов (т. Е. Ни один другой пользователь пробелов не может иметь одно и то же имя в любом регионе), должно иметь длину 3–63 символа и может содержать только строчные буквы, цифры и тире.

Затем выберите регион центра обработки данных, в котором вы хотите, чтобы ваше пространство было. На момент создания этого снимка экрана возможны вариантыnyc3 иams3. Больше будет доступно со временем.

Наконец, выберите, хотите ли вы, чтобы неаутентифицированные пользователи могли перечислять все файлы в вашем пространстве. Это не влияет на доступ к отдельным файлам (который устанавливается отдельно для каждого файла), а только на возможность получения списка всех файлов. Выбор по умолчаниюPrivate является безопасным, если у вас нет сценариев или клиентов, которым необходимо получать списки файлов без ключа доступа.

Когда ваше имя и параметры настроены, прокрутите вниз и нажмите кнопкуCreate a Space. Ваше пространство будет создано, и вы попадете в интерфейс файлового браузера:

Если это ваше первое пространство, у вас будет файлwelcome.html, в противном случае пространство будет пустым.

Запишите URL вашего Пространства. Он доступен прямо под именем Space в окне просмотра файлов. В этом примере полный URL-адрес -https://example-name.nyc3.digitaloceanspaces.com. Имя пространства (часто называемое именем сегмента) здесьexample-name. URL-адрес (или адрес) сервера - это оставшаяся часть, состоящая из имени центра данных, за которым следует.digitaloceanspaces.com:https://nyc3.digitaloceanspaces.com.

Есть несколько различных способов, которыми клиенты и библиотеки будут запрашивать эту информацию. Некоторые захотят его в том же формате, который указан в Панели управления. Некоторые требуют, чтобы имя корзины следовало за URL-адресом сервера, напримерhttps://nyc3.digitaloceanspaces.com/example-name. Третьи попросят вас ввести адрес сервера и область памяти или имя пространства отдельно. Обратитесь к документации вашего клиента или библиотеки для получения дополнительной информации здесь.

Далее мы создадим ключ, который нам нужен для доступа к нашим Пространствам от сторонних клиентов.

Чтобы получить доступ к нашим файлам за пределами панели управления DigitalOcean, нам нужно сгенерироватьaccess key иsecret. Это пара случайных токенов, которые служат именем пользователя и паролем для предоставления доступа к вашему Пространству.

Сначала щелкните ссылкуAPI в основной навигации Панели управления. На открывшейся странице перечислены ваши токеныDigitalOcean API и ключи доступаSpaces. Прокрутите вниз до части Spaces:

Если это ваш первый пробел, возможно, у вас нет ключей в списке. Щелкните кнопкуGenerate New Key. Появится диалоговое окноNew Spaces key:

Введите имя для ключа. Вы можете создать столько ключей, сколько захотите, поэтому имейте в виду, что единственный способ отозвать доступ к ключу - это удалить его. Поэтому вы можете разделить ключи по отдельным лицам, командам или клиентскому программному обеспечению, в котором вы их используете.

В этом случае мы создаем ключ с именемexample-token. Нажмите кнопкуGenerate Key, чтобы завершить процесс. Вы вернетесь к экрану API, в котором перечислены все ваши ключи. Обратите внимание, что у нового ключа отображаются два длинных токена:

Первый - это нашaccess key. Это не секрет и по-прежнему будет отображаться в панели управления. Вторая строка - это вашsecret илиsecret key. Это будет отображаться только один раз. Запишите его в безопасном месте для дальнейшего использования. В следующий раз, когда вы посетите страницу API, это значение исчезнет, ​​и его невозможно получить.

Разные S3-совместимые клиенты могут иметь несколько разные имена дляaccess key иsecret. Используемая терминология обычно достаточно близка, чтобы понять, какой токен должен идти и куда. Если нет, обратитесь к документации вашего клиента или библиотеки для получения дополнительной информации.

В этом уроке мы создали новое пространство DigitalOcean, а также новый ключ доступа и секрет. Теперь мы знаем нашиserver URL,bucket name (или имя пространства),access key иsecret. С помощью этой информации вы можете подключить практически любой S3-совместимый клиент или библиотеку к вашему новому DigitalOcean Space!