com.mulesoft.modules.cryptography.internal.pgp

Class PgpOperations

java.lang.Object

com.mulesoft.modules.cryptography.internal.pgp.PgpOperations

public class PgpOperations
extends Object

GPG operations.

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
PgpOperations()

Method Summary

Modifier and Type	Method and Description
InputStream	pgpBinaryToArmored(InputStream content) Converts an encrypted PGP message or a PGP signature to an ASCII armored representation, suitable for plain text channels.
InputStream	pgpDecrypt(PgpConfiguration config, InputStream content, String fileName) Decrypt a stream using PGP, giving the original data as a result.
InputStream	pgpEncrypt(PgpConfiguration config, InputStream content, PgpEncryptionAlgorithm algorithm, String fileName, PgpKeySelection keySelection) Encrypt a stream using PGP, giving an ASCII-armored stream output as a result.
InputStream	pgpEncryptBinary(PgpConfiguration config, InputStream content, PgpEncryptionAlgorithm algorithm, String fileName, PgpKeySelection keySelection) Encrypt a stream using PGP, giving a binary output as a result.
InputStream	pgpSign(PgpConfiguration config, InputStream content, PgpSignatureAlgorithm algorithm, PgpKeySelection keySelection) Create a detached (standalone) PGP signature of the stream.
InputStream	pgpSignBinary(PgpConfiguration config, InputStream content, PgpSignatureAlgorithm algorithm, PgpKeySelection keySelection) Create a detached (standalone) PGP signature of the stream.
void	pgpValidate(PgpConfiguration config, InputStream value, InputStream expected) Validate a PGP signature against a stream, to authenticate it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PgpOperations

public PgpOperations()

Method Detail

pgpEncrypt

@MediaType(value="text/plain")
 @Throws(value=EncryptionErrorTypeProvider.class)
public InputStream pgpEncrypt(@Config
                                                                                                               PgpConfiguration config,
                                                                                                               @Content
                                                                                                               InputStream content,
                                                                                                               @Optional(defaultValue="AES_256")
                                                                                                               PgpEncryptionAlgorithm algorithm,
                                                                                                               @Optional(defaultValue="stream")
                                                                                                               String fileName,
                                                                                                               @ParameterGroup(name="Key selection")
                                                                                                               PgpKeySelection keySelection)

Encrypt a stream using PGP, giving an ASCII-armored stream output as a result. The encryption is done with the public key of the recipient, so the secret passphrase is not required.

Parameters:

config - the PGP configuration

content - the content to encrypt

algorithm - the symmetric algorithm to use for encryption

fileName - the internal file name to use in the resulting PGP header

keySelection - the key used to encrypt the message

Returns:

the encrypted version of the input, in ASCII armored form

pgpEncryptBinary

@MediaType(value="application/octet-stream",
           strict=false)
 @Throws(value=EncryptionErrorTypeProvider.class)
public InputStream pgpEncryptBinary(@Config
                                                                                                                                                            PgpConfiguration config,
                                                                                                                                                            @Content
                                                                                                                                                            InputStream content,
                                                                                                                                                            @Optional(defaultValue="AES_256")
                                                                                                                                                            PgpEncryptionAlgorithm algorithm,
                                                                                                                                                            @Optional(defaultValue="stream")
                                                                                                                                                            String fileName,
                                                                                                                                                            @ParameterGroup(name="Key selection")
                                                                                                                                                            PgpKeySelection keySelection)

Encrypt a stream using PGP, giving a binary output as a result. The encryption is done with the public key of the recipient, so the secret passphrase is not required.

Parameters:

config - the PGP configuration

content - the content to encrypt

algorithm - the symmetric algorithm to use for encryption

fileName - the internal file name to use in the resulting PGP header

keySelection - the key used to encrypt the message

Returns:

the encrypted version of the input, in binary form

pgpDecrypt

@MediaType(value="application/octet-stream",
           strict=false)
 @Throws(value=DecryptionErrorTypeProvider.class)
public InputStream pgpDecrypt(@Config
                                                                                                                                                      PgpConfiguration config,
                                                                                                                                                      @Content @Optional(defaultValue="#[payload]")
                                                                                                                                                      InputStream content,
                                                                                                                                                      @Optional
                                                                                                                                                      String fileName)

Decrypt a stream using PGP, giving the original data as a result. The decryption is done with the private key, so the secret passphrase must be provided.

Parameters:

config - the PGP configuration

content - the content to decrypt

fileName - the internal file name to decrypt, if not present the first will be used

Returns:

the original unencrypted data

pgpSign

@MediaType(value="text/plain")
 @Throws(value=SignatureErrorTypeProvider.class)
public InputStream pgpSign(@Config
                                                                                                           PgpConfiguration config,
                                                                                                           @Content
                                                                                                           InputStream content,
                                                                                                           @Optional(defaultValue="SHA256")
                                                                                                           PgpSignatureAlgorithm algorithm,
                                                                                                           @ParameterGroup(name="Key selection")
                                                                                                           PgpKeySelection keySelection)

Create a detached (standalone) PGP signature of the stream. The signing is done with the private key of the sender, so the secret passphrase must be provided.

Parameters:

config - the PGP configuration

content - the content to sign

algorithm - the digest (or hashing) algorithm

keySelection - the key used to sign the data

Returns:

the ASCII armored PGP signature (does not contain the original message)

pgpSignBinary

@MediaType(value="application/octet-stream",
           strict=false)
 @Throws(value=SignatureErrorTypeProvider.class)
public InputStream pgpSignBinary(@Config
                                                                                                                                                        PgpConfiguration config,
                                                                                                                                                        @Content
                                                                                                                                                        InputStream content,
                                                                                                                                                        @Optional(defaultValue="SHA256")
                                                                                                                                                        PgpSignatureAlgorithm algorithm,
                                                                                                                                                        @ParameterGroup(name="Key selection")
                                                                                                                                                        PgpKeySelection keySelection)

Create a detached (standalone) PGP signature of the stream. The signing is done with the private key of the sender, so the secret passphrase must be provided.

Parameters:

config - the PGP configuration

content - the content to sign

algorithm - the digest (or hashing) algorithm

keySelection - the key used to sign the data

Returns:

the binary PGP signature (does not contain the original message)

pgpValidate

@Validator
 @Throws(value=ValidationErrorTypeProvider.class)
public void pgpValidate(@Config
                                                                                     PgpConfiguration config,
                                                                                     @Optional(defaultValue="#[payload]")
                                                                                     InputStream value,
                                                                                     InputStream expected)

Validate a PGP signature against a stream, to authenticate it. The validation is done with the public key of the sender, so the secret passphrase is not required.

Parameters:

config - the PGP configuration

value - the message to authenticate

expected - the signature

pgpBinaryToArmored

@MediaType(value="text/plain")
 @Throws(value=ParametersErrorTypeProvider.class)
public InputStream pgpBinaryToArmored(@Content
                                                                                                                       InputStream content)

Converts an encrypted PGP message or a PGP signature to an ASCII armored representation, suitable for plain text channels.

Parameters:

content - the content to convert

Returns:

the string representation of the PGP message/signature