PGP

Discover more about the PGP component and how to use it on the Digibee Integration Platform.

PGP (Pretty Good Privacy) is a cryptography component that provides authentication and cryptographic privacy for data communication.

Parameters

Take a look at the configuration parameters of the component. Parameters supported by Double Braces expressions are marked with (DB).

Parameter
Description
Default value
Data type

Account

Sets the account to be used by the component. The account should be either Public or Private key.

N/A

String

Operation

Defines the operation type (Encrypt Fields, Decrypt Fields, Encrypt Payload, Decrypt Payload, Encrypt File, or Decrypt File).

Encrypt Fields

String

Fields

Name of the fields to be encrypted inside the JSON entry. The fields must be separated by a comma (e.g., param1, param2). This parameter is available only when Encrypt Fields or Decrypt Fields are selected in the Operation parameter.

parameter

String

Payload (DB)

Can be defined as a single value or by Double Braces to get and set a payload. This parameter is available only when Encrypt Payload or Decrypt Payload are selected in the Operation parameter.

N/A

String

Charset

Charset of the text.

UTF-8

String

File Name (DB)

Name of the file or full file path (i.e. tmp/processed/file.txt) to be encrypted/decrypted. This parameter supports Double Braces expressions and is available only when Encrypt File or Decrypt File are selected in the Operation parameter.

N/A

String

Output File Name (DB)

Name of the encrypted file to be generated. This parameter supports Double Braces expressions and is available only when Encrypt File or Decrypt File are selected in the Operation parameter.

N/A

String

Hexadecimal

If the option is active, the value to be verified/signed must be informed in hex format; otherwise, it will be signed or verified as base64.

True

Boolean

Armor

If the option is active, it will encrypt the messages in ASCII so they are sent in a standard format, such as email.

False

Boolean

Zip

If the option is active, it will zip the message before it gets encrypted.

False

Boolean

Integrity Check

If the option is active, it will check the message integrity.

True

Boolean

Fail On Error

If the option is active, the execution of the pipeline with an error will be interrupted; otherwise, the pipeline execution proceeds, but the result will show a false value for the “success” property.

False

Boolean

Messages flow

Operation Encrypt Fields

Input

{  
    "parameter": "TEXT TO BE ENCRYPTED"
}

Output

{  
    "parameter": "AA01FF" // text encrypted
}

Operation Decrypt Fields

Input

{  
    "parameter": "AA01FF" // text encrypted
}

Output

{  
    "parameter": "TEXT DECRYPTED"
}

Operation Encrypt Payload

Input

{  
    "parameter": "TEXT TO BE ENCRYPTED"
}

Output

{  
    "result": "AA01FF" // text encrypted
}

Operation Decrypt Payload

Input

{  
    "parameter": "AA01FF" // text encrypted
}

Output

{  
    "result": "TEXT DECRYPTED"
}

Operation Encrypt File

Input

{  
    "fileName": "file.txt"
}

Output

{  
    "outputFileName": "file.txt.pgp" // file encrypted
}

Operation Decrypt File

Input

{  
    "fileName": "file.txt.pgp" // file encrypted
}

Output

{  
    "outputFileName": "file.txt.dec" // file decrypted
}

Output with error

{   
    "error": "java.io.FileNotFoundException: data1.csv (No such file or directory)",  
    "success": false
}
  • success: “false” when the operation fails.

  • error: information about the occurred error.

Last updated