Configuring SCP for Windows

Note:  This topic is for administrators and developers with administration access rights in Episerver Campaign.

This topic explains how to set up secure file transfer via Secure Copy Protocol (SCP) for Windows using WinSCP. File transfer is often needed for data exchange when integrating external systems with Episerver Campaign.

Configuration steps:

  1. Download and install WinSCP.
  2. Create a key pair.
  3. Transmit the keys to Episerver.
  4. Establish a WinSCP connection.

Step 1: Downloading and installing WinSCP

  1. Click http://winscp.net/eng/download.php.
  2. Click Download.
  3. Run the setup program.

Step 2: Creating a key pair

  1. Run the PuTTYGen program (part of WinSCP).

    Image: PuTTY Key Generator

    1. Parameters: Select RSA (Episerver only supports RSA).
    2. Number of bits in a generated key: Enter 2048.
    3. Click Generate.
  2. Make random mouse movements across a gray field to generate key values. A progress bar indicates the progress.

    Image: Generation in progress

    When generation is completed, the keys are displayed.

    Image: PuTTY Key values

  3.  Fill in the fields as follows:
    1. Key comment: Enter a description such as "Episerver Campaign-<your_companyname>".
    2. Key passphrase: Enter a password. For security reasons, use at least an eight-digit word containing letters, numbers and special characters.
    3. Confirm passphrase. Enter the password again.
  4. Click Save public key.
  5. Click Save private key.

Step 3: Transmitting keys to Episerver

  1. Copy the public key and email it to Episerver customer support.
  2. Copy the key fingerprint and email it separately to Episerver customer support.

    Note:  For security reasons, do not send the public key and key fingerprint together.

  3. Episerver sends a confirmation when your SCPSecure copy protocol access is active.

Note:  Protect your keys from unauthorized access. If lost, immediately contact Episerver and generate a new key pair as described above.

Step 4: Establishing a WinSCP connection

  1. Launch the WinSCP program.
  2. In the login window, click New Site .

    Image: Login

  3. Fill out the information as follows.
    • Host name: Enter ftpapi.campaign.episerver.net
    • User name: Enter name as provided by Episerver.
  4. Click Advanced...
  5. Select EnvironmentSFTP and enable Allow SCP fallback.

    Image: Allow SCP fallback

  6. Select SSH > Authentication, click Browse (...) in Private key file and select the previously generated private key.

    Image: Browse for Private key file

  7. Click OK.
  8. Click Save, enter a name for the connection, and click OK.
  9. In the WinSCP login window, select the connection name and click Login.