WinSCP¶

WinSCP is a graphical file transfer client available for Windows.

It support numerous access protocols. These instructions focuses on setting up WinSCP 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 WinSCP client from https://winscp.net/
Start WinSCP

Setup¶

Authenticate with username/password¶

Prerequisite: Username and password

Select WebDAV as File protocol
Select TLS/SSL Implicit encryption as Encryption
Enter Host name: webdav.swestore.se
Enter port number: 443
Enter your user name in the User name field
Enter your password in the Password field
Click Login

You should now be logged in

Authenticate with certificate¶

Prerequisite: [Client certificate][../access/certificates/index.md)
In the Login dialog:
Select WebDAV as File protocol
Select TLS/SSL Implicit encryption as Encryption
Enter Host name: webdav.swestore.se
Enter port number: 443
Click Advanced

Navigate to Connection -> TLS/SSL
Choose your Client certificate file
Click OK

Back in the Login dialog:
- Click Login
In the Client certificate passphrase dialog:
- Enter the password of your client certificate file.
- Click OK

You should now be logged in