Swift (OpenStack Object Storage)#
Connecting#
Connect to a Swift (OpenStack Object Storage) installation. Choose Swift (OpenStack Object Storage) from the list of protocols.
Note
Connection profiles can be installed from Preferences → Profiles.
Authentication Context Path#
Authentication with devauth for Context /v1.0#
Legacy authentication option.
Downloadthe Openstack Swift (v1) profile for preconfigured settings.
Authentication with swauth#
Legacy authentication option.
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. 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>.
Bundled by default since Cyberduck version 4.4.4.
Downloadthe Openstack Swift (Keystone 2) profile for preconfigured settings.
If you have a Swift installation without SSL configured, you need an optional connection profile to connect using HTTP only without transport layer security.
Downloadthe Openstack Swift (Keystone 2 HTTP) profile for preconfigured settings.
Authentication with Keystone 3.0 for Context /v3/tokens#
Bundled by default since Cyberduck version 4.8.
Downloadthe Openstack Swift (Keystone 3) profile for preconfigured settings.
If you have a Swift installation without SSL configured, you need an optional connection profile to connect using HTTP only without transport layer security.
Downloadthe Openstack Swift (Keystone 3 HTTP) 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>.
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 (MacOS ⌘N Windows Ctrl+N) and specify a name. After the container has been created, you may start adding your content to the storage platform.
Cyberduck CLI#
Connect with Cyberduck CLI using the default connection profile using authentication with Keystone 2.0 for context /v2.0/tokens with
duck --username OS_TENANT_ID:OS_USERNAME --password PASSWORD --list swift://SWIFT_KEYSTONE_AUTH_SERVER/CONTAINERNAME
Refer to the Cyberduck CLI documentation for more operations.
Third-Party Providers#
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. The number of connections used can be limited using the toggle in the lower right of the transfer window.
Large uploads can be resumed when interrupted.
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 (Issue #9134).
Known Issues#
Authentication failure with ec2-credentials(Issue #7754)
Multiple OpenStack Swift Containers in Different Regions with the Same Name#
Browsing containers will be erratic. As a workaround, browse a region by using a connection profile limited to a single region as with Rackspace Cloudfiles region profiles.