> ## Documentation Index
> Fetch the complete documentation index at: https://syteca.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfer Files with WinSCP

> Transfer files between the Connection Manager computer and a remote host through a Syteca secret using the WinSCP application, over SCP, SFTP, or FTP.

The File Transfer feature lets users of a secret move files between the Connection Manager computer and the remote computer the secret accesses, using the **WinSCP** (Windows Secure Copy) application version 6.0 or higher. WinSCP must be installed and added to the `PATH` environment variable on the Client computer.

When File Transfer is configured and permitted, a user transfers files through the secret in WinSCP instead of connecting directly to the remote computer.

<Info>
  This works in the desktop Syteca Connection Manager and, in a similar way, directly from the Management Tool using [Syteca Web Connection Manager](/docs/pam/access/web-connection-manager).
</Info>

## Supported secret types and protocols

| Secret type              | SCP | SFTP | FTP |
| ------------------------ | --- | ---- | --- |
| Active Directory account | ✗   | ✓    | ✓   |
| Windows account          | ✗   | ✓    | ✓   |
| Unix account (SSH)       | ✓   | ✓    | ✓   |

<Note>
  **Active Directory and Windows accounts:** SFTP requires an OpenSSH server on the remote computer; FTP requires an FTP server on the remote computer.

  **Unix account (SSH):** SCP and SFTP require an OpenSSH server on the remote computer.
</Note>

## 1. Configure file transfer for a secret

<Steps>
  <Step title="Open the secret">
    Sign in to the Management Tool with the [Management Tool Access permission](/docs/administration/users/administrative-permissions), then [add a new secret](/docs/pam/secrets/add-secret) or edit an existing one.
  </Step>

  <Step title="Set the protocol and port (Windows and Unix SSH only)">
    On the **Details** tab, in the **File Transfer** section, select the **File Transfer Protocol** (SFTP by default) and enter the **Port** (defaults: `22` for SFTP/SCP, `21` for FTP).

    <Note>
      For Unix account (SSH) secrets, the FTP protocol cannot be used together with the **Use SSH key** option.
    </Note>

    <Note>
      For Active Directory account secrets, the protocol and port are configured later, in a pop-up shown while connecting through WinSCP (see Step 2).
    </Note>
  </Step>

  <Step title="Enable password rotation">
    On the **Automation** tab, select **Enable remote password rotation** and set the rotation frequency. See [Remote password rotation](/docs/pam/secrets/remote-password-rotation).

    <Warning>
      File transfer does not work until the password has been rotated at least once, or if rotation has failed.
    </Warning>
  </Step>

  <Step title="Enable checkout options">
    On the **Security** tab, select both **Requires check out** and **Change password on check in** (and optionally **Check in automatically after**).

    <Warning>
      File transfer will not work unless both of these are selected — and you won't be able to save the secret after enabling File Transfer permissions for any user without them.
    </Warning>
  </Step>

  <Step title="Grant File Transfer permission">
    On the **Permissions** tab, click **Add**, select the users or user groups, and for each set the **Role Type** to **Owner** or **Editor** and select the **File Transfer** checkbox. You can instead inherit users and the File Transfer permission from the parent folder (except "Root folder").
  </Step>

  <Step title="Save and rotate once">
    Click **Save**. Then either wait for the first automatic rotation, or edit the secret and click **Rotate Now** on the **Automation** tab (Rotate Now appears only when editing an existing secret). Save again.
  </Step>
</Steps>

<Frame caption="The File Transfer section on the Details tab.">
  <img src="https://mintcdn.com/syteca/lupMJVIPJBUOgkKJ/images/pam/secrets/file-transfer-details.png?fit=max&auto=format&n=lupMJVIPJBUOgkKJ&q=85&s=84414044af9bd7ac8c72fc9716572f16" alt="Details tab File Transfer section showing protocol and port fields" width="1910" height="970" data-path="images/pam/secrets/file-transfer-details.png" />
</Frame>

## 2. Transfer files

<Steps>
  <Step title="Open file transfer">
    In Syteca Connection Manager, instead of **Connect**, click the dark blue icon in the **File Transfer** column for the secret. (A gray icon means file transfer isn't fully configured for that secret and can't be used.)
  </Step>

  <Step title="Enter connection details (Active Directory only)">
    For Active Directory account secrets, a pop-up opens: enter the remote computer's name or IP, select the **File Transfer Protocol** and **Port** (or use the defaults), then click **Connect**.

    <Note>
      If the secret only allows connections to specific computers in the domain, first expand the parent secret (click the down-arrow) to show its child secrets — one per allowed computer — then click the dark blue File Transfer icon on the row for the computer you want.
    </Note>
  </Step>

  <Step title="Transfer files in WinSCP">
    WinSCP opens (if version 6.0+ is installed) on the Client computer. Transfer files between the Connection Manager computer and the remote host in WinSCP.
  </Step>
</Steps>

<Frame caption="WinSCP opened through a Syteca secret, ready to transfer files.">
  <img src="https://mintcdn.com/syteca/FKrkO8bEqEQ6WSgs/images/pam/secrets/file-transfer-winscp.png?fit=max&auto=format&n=FKrkO8bEqEQ6WSgs&q=85&s=fbad8eb02173edaf525f80ca8503b2e4" alt="WinSCP application opened through a Syteca secret connection" width="1505" height="846" data-path="images/pam/secrets/file-transfer-winscp.png" />
</Frame>

## Related

<CardGroup cols={2}>
  <Card title="Add a secret" icon="key-round" href="/docs/pam/secrets/add-secret">
    Configure file transfer while creating a secret.
  </Card>

  <Card title="Password checkout" icon="user-lock" href="/docs/pam/secrets/password-checkout">
    Both checkout options are required for file transfer.
  </Card>

  <Card title="Remote password rotation" icon="refresh-cw" href="/docs/pam/secrets/remote-password-rotation">
    The password must be rotated once before file transfer works.
  </Card>

  <Card title="Permissions for secrets" icon="users" href="/docs/pam/secrets/permissions">
    The File Transfer advanced permission.
  </Card>
</CardGroup>
