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. You must first create a public and private key pair before you can add the public key to Airship.

  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 PuTTYgen generates the key pair. When PuTTYgen generates the key, it replaces the blank area with a series of text boxes, including one that shows the public key.
    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 your Public key. You’ll provide this key to Airship in later steps. 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 filename for your new keys.

    This process generates two files based on the filename you provide:

    • <filename> contains your private key.
    • <filename>.pub contains your public key.

    By default, these files are id_rsa and id_rsa.pub. You will need to copy the contents of your .pub file to provide Airship with your public key.

  2. Add your public key to Airship.

    1. Go to Settings » APIs & Integrations » SFTP and click Add key.
    2. Select Static Lists (audience lists) or Attributes.
    3. Enter a Name for the key. This helps you identify the key in Airship.
    4. Paste the contents of your <filename>.pub key file (or the <filename>.ppk file for Windows users) in the Public key field.
    5. 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.