Cyberduck Help / Howto / Swift (OpenStack Object Storage)

Connect to a ​Swift (OpenStack Object Storage) installation. Choose Swift (OpenStack Object Storage) from the list of protocols.

Providers

• Rackspace Cloud Files (US & UK) with Akamai CDN
• HP Cloud Object Storage with Akamai CDN
• Internap AgileFILES
• Cloud.ca Object Store
• SoftLayer Object Storage
• Memset Memstore Object Storage
• Enter Cloud Suite
• Oracle Storage Cloud Service
• EVault LTS2
• Oktawave Cloud Storage
• SwiftStack
• Cloudwatt
• green.ch
• ​RunAbove
• Cloud A
• AURO
• HubiC (OVH)

Regions

Multiple regions are supported when authenticating with a Keystone (2.0) identity endpoint. Containers from all regions are displayed in the browser. Choose View → Column → Region to display the region in the browser.

Container

On your first login, you will need to create at least one container (folder) to put your content in. Choose File → New Folder (⌘-N) and specify a name. After the container has been created, you may start adding your content to the storage platform.

Authentication Context Path

Authentication with devauth for context /v1.0

Legacy authentication option.

• ​Download the Openstack Swift (v1) profile for preconfigured settings.

Authentication with swauth

Legacy authentication option.

• ​Download the Openstack Swift (Swauth HTTPS) profile for preconfigured settings.
• ​Download the Openstack Swift (Swauth HTTP) profile for preconfigured settings.

Authentication with Keystone 2.0 for context /v2.0/tokens

To get the login tokens from an OpenStack Identity service no configuration change is needed. This is the default since version 4.4.4. You will get prompted to provide the tenant name with a Provide additional login credentials prompt or can provide it with the username in the format <tenant>:<user>.

Authentication with Keystone 3.0 for context /v3/tokens

• ​Download the Openstack Swift (Keystone 3) profile for preconfigured settings.

You will get prompted to provide the project name with a Provide additional login credentials prompt or can provide it with the username in the format <project>:<user>.

Temporary URLs

A private object stored in OpenStack Swift can be made publicly available for a limited time using a signed URL. The signed URL can be used by anyone to download the object, yet it includes a date and time after which the URL will no longer work. Copy the signed URL from Edit → Copy URL→ Signed URL.

• Rackspace. A value must be set on your account metadata for X-Account-Meta-Temp-Url-Key.

Large Uploads

Supported using Static Large Object segmentation. Files larger than 2GB are uploaded in segments using the default threshold. The upload chunk size is 100MB by default with a maximum of 5 concurrent connections.

Large uploads can be resumed when interrupted.

Connect without SSL

If you have a Swift installation without SSL configured, you need an optional connection profile to connect using HTTP only without transport layer security. You will then have the added option Openstack Swift (HTTP) in the protocol dropdown selection in the Connection and Bookmark panels.

• ​Download the Openstack Swift (HTTP) for preconfigured settings.
• ​Download the Openstack Swift (Keystone HTTP) for preconfigured settings.

Distribution (CDN)

You can CDN enable the container using File → Info → Distribution (CDN) if supported by the provider.

Preferences

Large Upload Segment Size

You can set the hidden option openstack.upload.largeobject.size for the segment size in bytes. See #9134.

Known Problems

• Authentication failure with ec2-credentials