FTP access via SCP (Windows)

An encrypted mode is used when moving files from your computer to the server to protect your data from unauthorized access during transfer. SCP, which stands for Secure Copy Protocol, ensures encryption and proper data transfer. To use this encryption method, you need an SCP program installed on your computer, access data for the server, and a key for server authentication.

This page provides instructions on how to install and set up the program WinSCP, which you can download for free.

Downloading and installing WinSCP

To download WinSCP, perform the following steps:

  1. Click the following link: http://winscp.net/eng/download.php.
  2. Click Installation package.
  3. Perform the installation.

Creating a key pair

To establish a connection to the servers, each user will need a key pair, which consists of a so-called public key and a private key. To create a key pair, perform the following steps:

  1. Run the program PuTTYGen, which is part of WinSCP.
  2. In the Parameters area, select the RSA key type and in the Number of bits in a generated key field, enter the value 2048.

    Make sure to select the correct key type. Episerver only supports the key type RSA.

  3. Click Generate.
  4. While the server is generating the keys, you will be requested to make several random movements with the mouse across a gray field in the window. These arbitrary movements will generate random values for the keys. The bar near the top of the window indicates the progress of the operation.

    Once the keys have been generated, this window will appear:

  5. Fill in the fields as follows:
    (1)Key commentEnter a brief description, such as "Episerver Campaign-<your_companyname>"
    (2)Key passphrase

    Enter a password for the key.

    Secure passwords: Use an eight-digit (or, better yet, a 16-digit) password containing letters, numbers as well as special characters.

    (3)Confirm passphraseEnter the password a second time to confirm.
  6. Click Save public key (4) to save it.
  7. Click Save private key (5) to save it.

Transmitting keys to Episerver

The public key and the key fingerprint must be sent to Episerver separately:

  1. Copy the public key and send it by email to customer support.
  2. Copy the key fingerprint and send it in a separate email to customer support.

    We will then send you a confirmation. Your SCP access is now active.

Protect your keys from unauthorized access

Protect your keys from access by unauthorized persons and keep them in a safe place. If the keys should fall into the wrong hands, immediately notify Episerver and generate a new key pair in the manner previously described.

Establishing a connection through WinSCP

Once your keys have been activated, you can establish a connection to the servers via WinSCP. To do so, perform the following steps:

  1. Launch the WinSCP program.
  2. In the login window, click New Site (1).
  3. Fill in the fields as follows:
  4. (2) Host name ftpapi.campaign.episerver.net
    (3) User name Episerver will provide you with this
  5. Click Advanced... (4).

    The Advanced Site Settings window opens.

  6. On the left side under Environment, click SFTP and on the right side, select the Allow SCP fallback check box (5).
  7. On the left side under SSH, click Authentication and on the right side in the Private key file field, click ... and select the private key previously generated. (6).
  8. Click OK.
  9. Click Save, enter a name for the connection and click OK.
  10. In the WinSCP login window, select the name and click Login to establish a connection.
back to top Episerver image




Episerver | Updated: 2019-03-06 | Send feedback to us