How to use Cyberduck for connecting to NTNU Object Storage (S3) (MacOS)
Host: brage.it.ntnu.no
NTNU IT will provide you with the necessary info when it comes to:
Bucket name
Access key ID
Secret access key
Short version of setup: Download and install the Cyberduck desktop client, and use the described setup file for connecting.
Step-by-step version of setup:
(1) Begin the process by downloading (zipped) or creating a setup file for connecting specifically to brage.it.ntnu.no by using the so called “path style” when connecting. You will need to use a text editor that can handle xml-files to edit the file. Name the file Brage and use the file extension .cyberduckprofile, like this: “Brage.cyberduckprofile”, and copy the content below. If you prefer to go directly to the source of this (modfied) file, look up Cyberduck profiles on Github.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Protocol</key> <string>s3</string>
<key>Vendor</key> <string>s3-https-path-style</string>
<key>Scheme</key> <string>https</string>
<key>Description</key> <string>Brage objektlagring S3</string>
<key>Default Port</key> <string>443</string>
<key>Hostname Configurable</key> <true/>
<key>Username Configurable</key> <true/>
<key>Path Configurable</key> <true/>
<key>Default Hostname</key>
<string>brage.it.ntnu.no</string>
<key>Properties</key> <array> <string>s3.bucket.virtualhost.disable=true</string> </array>
</dict>
</plist>Note on the configuration: The last string value above forces Cyberduck to use path style connections (and this is necessary in our case).
(2) Save your cyberduck profile file at a convenient location in your setup.
(3) Then download the Cyberduck desktop client, preferably from App Store (because downloading from App Store will resulting in a very easy installation process). (4) If you prefer downloading from cyberduck.io/download: Then download, unzip and move the unzipped application bundle Cyberduck.app from to the /Applications folder on your hard disk.
(5) Try to open the Cuberduck application for the first time. If MacOS gives you a warning when opening the first time, try to right click (or control click) and choose open, and confirm opening if prompted about your confidence around opening the file).
(6) Then close the Cyberduck application again, and double click your configuration file (the profile file then should open as a configuration file in Cyberduck.
(7) Fill in the provided Access key ID (“Adgangsnøkkel-ID”), Secret access key (“Hemmelig adgangsnøkkel”) and Bucket name (in the field “Sti”, or in English: “Path”)
(8) And finally, connect to Brage by double clicking on the new “bookmark” you now have created in Cyberduck.