Manage SFTP Keys

Use SFTP for uploading data to Airship.

For details about adding data from external systems, e.g., CRM or POS databases, see: Use SFTP to Upload Audience Lists and Attributes.

Add Public Key to Airship

Airship’s SFTP implementation uses SSH key pairs for authentication.

  1. Generate private and public keys.

    Windows-based clients
    1. Download and run puttygen.exe.
    2. Select RSA in the Parameters section near the bottom of the page and click Generate.
    3. Move the mouse around in the blank area, as instructed, until the key pair is generated and the Key section updates.
    4. Click Save public key and select the directory where you want to save your public key.
    5. Click Save private key and save the private key in the same folder as your public key.
    6. Copy the contents of the Public key for pasting into OpenSSH authorized_keys file field. You’ll paste this key in Airship in the next step. Make sure to copy the entire key, starting with ssh-rsa.
    MacOS- and Linux-based clients
    1. Open your terminal.

    2. At the command line, enter ssh-keygen -t rsa. You can set other options, but the key type must be set to RSA (-t rsa).

    3. Enter the directory and file name (without extension) for your new keys, e.g., /Users/your_username/Documents/rsa_keys/<filename>, and optionally enter a passphrase and confirm.

      This process generates two files based on the file name you provide:

      • <filename> contains your private key.
      • <filename>.pub contains your public key.
    4. Copy the contents of your .pub file. You’ll paste this key in Airship in the next step.

  2. Add your public key to Airship.

    1. Go to Settings » APIs & Integrations » SFTP.
    2. Click Add key and configure:
      • Purpose: Select Static Lists (audience lists) or Attributes.
      • Name: Enter a name to help you identify the key in Airship.
      • Public key:
        • For Window users, paste the contents of the Public key for pasting into OpenSSH authorized_keys file field you copied in the previous step.
        • For MacOS and Linux users, paste the contents of the <filename>.pub you saved in the previous step.
    3. Click Save key.

View SFTP Information

You can set up any client to use Airship’s SFTP interface, and many CRM platforms natively support SFTP.

  1. Go to Settings » APIs & Integrations » SFTP.
  2. Click   for a key. Use this information to set up your SFTP connection with Airship using SSH or an SFTP client. Authentication also requires your private key.
    • SSH command line: Use the field value.
    • SFTP client: Enter the field values in your client configuration.
      • Username
      • Host: sftp.airship.com (sftp.airship.eu for EU customers)
      • Port: 5222

Delete a Key

  1. Go to Settings » APIs & Integrations » SFTP.
  2. Click   for a key.