Documentation / Product / Integrations / Custom Integrations

Authorization

Lytics uses SSH File Transfer Protocol (SFTP) to import files into Lytics and to export user data into files on an SFTP server. You can use your own SFTP service or Lytics can provide a managed SFTP server account. Adding an authorization for use in an import or export workflow differs if you use our own or a Lytics SFTP account.

Configure Client Managed SFTP Authorization

You can use your own SFTP server to import or export files to or from Lytics. The authorization can be added according to your requirements in one of the following ways:

Create Client SFTP Server Authorization

  1. Navigate to Custom Integrations in the Integrations section of Lytics and select the Custom Integrations tile. custom

  2. Navigate to Authorizations.

  3. Click New Authorization.
  4. Click Create Client SFTP Server Authorization.
  5. In the Host text field, enter the host name or IP address of the SFTP server you want to connect to.
  6. In the Port text field, enter the port number for the SFTP server.
  7. In the Username text field, enter the username for the SFTP server.
  8. In the Password text field, enter the password for the SFTP server. If you wish to use a Private Key, leave this field empty.
  9. In the Private Key text field, enter the private key for the user for the SFTP server. If you choose to provide both, then Lytics will try to connect to the SFTP server with the private key first and if that fails then we will try with the password.
  10. In the Passphrase text field, enter the passphrase for the private key you entered if any.
  11. In the Folder text field, enter the relative path to the folder to import or export file. If the path is not given, then we will export the file to the user's home directory.
  12. In the Description text field, enter a short description to identify this authorization.
  13. Click Authorize. sftp-server-auth

Client SFTP Server Authorization with PGP Private Key

This authorization lets you import JSON or CSV files to Lytics that have been encrypted using your PGP private key. In order to add this authorization, please make sure you have your PGP keys setup first. See PGP encryption for more information.

  1. Follow steps 1 to 10 for adding Client SFTP Server authorization except choose Create Client SFTP Server Authorization with PGP Private Key from New Authorization menu.
  2. In the PGP Private Key text field, enter your PGP private key. See PGP private keys for more information.
  3. In the PGP Private Key Passphrase text field, enter the passphrase for your PGP private key.
  4. In the Folder text field, enter the relative path to the folder to import the file from. If the path is not given, then we will connect to the user's directory.
  5. In the Description text field, enter a short description to identify this authorization.
  6. Click Authorize. sftp-auth-pivate-pgp

Client SFTP Server Authorization with PGP Public Key

This authorization lets you export Lytics audiences to a CSV file while also encrypting the content using the provided PGP public key. In order to add this authorization, please make sure you have your PGP keys setup. See PGP encryption for more information.

  1. Follow steps 1 to 10 for adding Client SFTP Server authorization except choose Create Client SFTP Server Authorization with PGP Public Key from New Authorization menu.
  2. In the PGP Public Key text field, enter PGP public key. See PGP public keys for more information.
  3. In the Folder text field, enter the relative path to the folder to export file to. If the path is not given, then we will connect to the user's directory.
  4. In the Description text field, enter a short description to identify this authorization.
  5. Click Authorize. sftp-auth-public-pgp

Configure Lytics Managed SFTP Authorization

You can also use Lytics managed SFTP server to import or export files to or from Lytics.

The Lytics managed SFTP server URL and port are:

SFTP Host Name: sftp.lytics.io 
SFTP Port Number: 22  

For credentials to connect to Lytics Managed SFTP, you will create it according to your requirements using one of the following ways:

When you add an authorization, Lytics creates a user using the information provided in the Lytics managed SFTP server. You can use those user credentials to upload or download a file.

Lytics Managed SFTP Server Authorization

  1. Navigate to Custom Integrations in the Integrations section of Lytics and select the Custom Integrations tile. custom

  2. Navigate to Authorizations.

  3. Click New Authorization.
  4. Click Lytics Managed SFTP Server Authorization.
  5. In the Username text field, enter a username. This username must be between 3 to 32 characters. Username can have characters a-z, A-Z, 0-9, hyphen(-), and underscore(_). It cannot start with hyphen(-).
  6. In the Password text field, enter a password. The password must be between 8 to 32 characters and include at least one uppercase letter, lowercase letter, number and special character.
  7. In the Description text field, enter a short description to identify this authorization.
  8. Click Authorize. sftp-auth

Lytics Managed SFTP Server Authorization with PGP Private Key

This authorization lets you import JSON or CSV files that have been encrypted with your PGP private key. In order to add this authorization, please make sure you have your PGP keys setup. See PGP encryption for more information.

  1. Create a user forLytics managed SFTP server if you have not already.
  2. Use the credentials of that user and Lytics managed SFTP server host details (Host name: sftp.lytics.io Port: 22) to create SFTP Server authorization with PGP Private Key using Client SFTP Server Authorization with PGP Private Key.

Lytics Managed SFTP Server Authorization with PGP Public Key

This authorization lets you export Lytics audiences to a CSV file while encrypting the content using the provided PGP public key. In order to add this authorization, please make sure you have your PGP keys setup. See PGP encryption for more information.

  1. Create a user for Lytics managed SFTP server if you have not already.
  2. Use the credentials of that user and Lytics managed SFTP server host details (Host name: sftp.lytics.io Port: 22) to create SFTP Server authorization with PGP Public Key using Client SFTP Server Authorization with PGP Public Key.