PGP relies on two key pairs. One set belongs to the external system, and the other is generated in the platform. Encryption 

Credential Management application

In the Credential Management application, you must:

  • Create a new record. 
  • Use the Type field to specify whether you're creating an internal or external key record. 
    • For data exports:
      • Signing: Create an internal key record. Select the Generate button or paste an existing key in ASCII armored format. You'll use the internal private key to sign data exports. The platform uses the internal private key to sign exports. You provide the internal public key to the external system so it can verify the signature.
      • Encryption: Create an external key record and paste the external system's public key in ASCII armored format. The platform uses the external public key to encrypt exports.
    • For data imports:
      • Signature Verification: Create an external PGP public key record and enter the external system's public key. This verifies the signature on incoming files. This is usually the same key used to encrypt outbound files going to the external system.
      • Decryption: Create an internal key record. Select Generate or paste an existing key in ASCII armored format. The platform uses the internal private key to decrypt imports that are encrypted with the corresponding internal public key in the external system. This is usually the same key used to sign outbound files going to the external system.

Data Import or Data Export Definitions application

In your Data Import or Data Export record, on the Import/Output File Details page, select the Configure Encryption field action below the Inbound File Processing Options field. This allows you to create an Inbound or Outbound File Processing Options record, which you may reuse across other Data Imports and Exports.

In your encryption record, keys are used in the following places:

  • Inbound File Processing Options:
    • PGP Decryption Key field: Select the credential management record holding the internal private key generated in the platform. This decrypts the incoming data which the external system encrypted using your matching internal public key. Leave blank to skip decryption.
    • PGP Signature Verification Key field: Select the credential management record that has the external system's public key. This verifies the file signature. Leave blank to skip signature verification
  • Outbound File Processing Options:
    • PGP Decryption Key field: Select the credential management record holding the external system's public key. This encrypts the outgoing data. Leave blank to skip encryption.
    • PGP Signature Verification Key field: Select the credential management record that has the internal private key generated in the platform. This signs the outgoing data. Leave blank to skip signing.
    • You can optionally choose your hash algorithm and additional encoding options.

Once your File Processing Options record is saved and reference in your Data Import or Export Definition, future imports and exports have corresponding PGP operations applied automatically.