Cyberduck¶
Cyberduck is a graphical file transfer client available for macOS and Windows.
It support numerous access protocols. These instructions focuses on setting up Cyberduck to access Swestore using the WebDAV protocol.
Cautions¶
Large and/or long-running file transfer sessions from devices with unstable network such as wifi or power saving functions enabled is error-prone and can cause unexpected things to happen if for example power-saving shuts down a transfer session mid-transfer and then tries to resume later. We have seen indications that this can exercise error handling code paths in clients that aren't necessarily well-tested resulting in loss of user data as a result.
We recommend to exercise caution when doing large transfers using laptop/desktop devices:
- Break down large transfers into smaller chunks that you can verify
reasonably easy, for example by not transfering the top-level
directory but instead do each sub-directory individually.
- The max size/time varies, 4-8 hours per transfer is usually OK as long as there is no power-saving features interfering.
- Never move large directory trees, first transfer and verify the target
before deleting the source.
- We have seen client software deleting the source tree on failed transfers with peculiar error cases, however this has not been reproducible.
- Use a wired network connection whenever possible.
Preparation¶
- If not already done, download and install the Cyberduck client from https://cyberduck.io/
- Start Cyberduck
Authenticate with username/password¶
- Prerequisite: Username and password
- In the Open Connection dialog:
- Select WebDAV (HTTPS) as protocol
- Enter Server: webdav.swestore.se
- Enter Port: 443
- Enter your user name in the Username field
- Enter your password in the Password field
- Click Connect
- You should now be logged in
Authenticate with certificate¶
- Prerequisite: Valid client certificate
- In the Open Connection dialog:
- Select WebDAV (HTTPS) as protocol
- Enter Server: webdav.swestore.se
- Enter Port: 443
- Check the Anonymous Login checkbox
- Click Connect
- Choose the correct certificate from the user login keychain
- If you have only one certificate the default is usually correct
- If you were successful, you should now be presented with a directory listing
- To avoid having to enter all connection details again, bookmark this connection by navigating Bookmark -> New Bookmark