PGPLib (DidiSoft OpenPGP Library for Java)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.didisoft.pgp
Class PGPLib

java.lang.Object
  com.didisoft.pgp.PGPLib

public class PGPLib
extends java.lang.Object
extends java.lang.Object

OpenPGP Library for Java.
The library provides methods that can work with or without an OpenPGP KeyStore
(Note that the OpenPGP Key Store format this library uses, is different from the JDK Key Store format which is X.509 based.)
Supported JDK versions: 1.4, 1.5, 1.6

Copyright DidiSoft Ltd.
www.didisoft.com

Constructor Summary
`PGPLib()`

Method Summary
`void`	`clearSignFile(java.lang.String inputFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String hashingAlgorithm, java.lang.String outputFileName)` OpenPGP clear signs a file.
`void`	`clearSignFileVersion3(java.lang.String inputFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String hashingAlgorithm, java.lang.String outputFileName)` OpenPGP clear signs a file, using OpenPGP version 3 signature format (old format used by PGP 2.x) Use when needed compatibility with PGP 2.x GPG equivalent command: gpg --force-v3-sigs --clearsign inputFileName Example:
`java.lang.String`	`clearSignString(java.lang.String stringToSign, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String hashingAlgorithm)` OpenPGP clear signs a String Example usage:
`java.lang.String`	`clearSignStringVersion3(java.lang.String stringToSign, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String hashingAlgorithm)` OpenPGP clear signs a String, using OpenPGP version 3 signature format (the old format) Use when needed compatibility with PGP 2.x and PGP 5.x systems.
`boolean`	`decryptAndVerifyFile(java.lang.String encryptedFileName, KeyStore keyStore, java.lang.String privateKeyPassword, java.lang.String outputFileName)` Decrypts and verifies one pass encrypted and signed OpenPGP file Supports OpenPGP version 3 format too (used by PGP 6.5 and below).
`boolean`	`decryptAndVerifyFile(java.lang.String encryptedFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFile, java.lang.String outputFileName)` Decrypts and verifies an OpenPGP encrypted and signed file Supports OpenPGP version 3 format too (used by PGP(r) 5 and below).
`boolean`	`decryptAndVerifyFileTo(java.lang.String encryptedFileName, KeyStore keyStore, java.lang.String privateKeyPassword, java.lang.String outputFolder)` Decrypts and verifies one pass encrypted and signed OpenPGP file Supports OpenPGP version 3 format too (used by PGP 6.5 and below).
`boolean`	`decryptAndVerifyFileTo(java.lang.String encryptedFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFile, java.lang.String outputFolder)` Decrypts and verifies an OpenPGP encrypted and signed file to a folder This methods is very suitable for multi file PGP archives.
`boolean`	`decryptAndVerifyStream(java.io.InputStream encryptedStream, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.InputStream publicKeyStream, java.io.OutputStream outputFileStream)` Decrypts and verifies OpenPGP encrypted and signed stream.
`boolean`	`decryptAndVerifyStream(java.io.InputStream encryptedStream, KeyStore keyStore, java.lang.String privateKeyPassword, java.io.OutputStream outputFileStream)` Decrypts and verifies OpenPGP encrypted and signed stream.
`boolean`	`decryptAndVerifyStreamTo(java.io.InputStream encryptedStream, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.InputStream publicKeyStream, java.lang.String outputFolder)` Decrypts and verifies OpenPGP encrypted and signed stream.
`boolean`	`decryptAndVerifyStreamTo(java.io.InputStream encryptedStream, KeyStore keyStore, java.lang.String privateKeyPassword, java.lang.String outputFolder)` Decrypts and verifies OpenPGP encrypted and signed stream.
`boolean`	`decryptAndVerifyString(java.lang.String message, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFileName, java.lang.StringBuffer decryptedString)` Decrypts and verifies an OpenPGP one pass signed end encrypted message.
`boolean`	`decryptAndVerifyString(java.lang.String message, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFileName, java.lang.StringBuffer decryptedString, java.lang.String charsetName)` Decrypts and verifies an OpenPGP one pass signed end encrypted message.
`java.lang.String`	`decryptFile(java.lang.String encryptedFileName, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.lang.String outputFileName)` Decrypts an OpenPGP encrypted file using Private key input stream.
`java.lang.String`	`decryptFile(java.lang.String encryptedFileName, KeyStore pgpKeyStore, java.lang.String privateKeyPassword, java.lang.String outputFileName)` Decrypts an OpenPGP encrypted file using key from a OpenPGP key store.
`java.lang.String`	`decryptFile(java.lang.String encryptedFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String outputFileName)` Decrypts an OpenPGP encrypted file using Private key file.
`java.lang.String`	`decryptFilePBE(java.lang.String encryptedFileName, java.lang.String decryptionPassword, java.lang.String outputFileName)` Decrypts an OpenPGP file that was encrypted with password (PBE, symmetric key encrypted).
`java.lang.String[]`	`decryptFileTo(java.lang.String encryptedFileName, KeyStore keyStore, java.lang.String privateKeyPassword, java.lang.String outputFolder)` Decrypts the content of an OpenPGP encrypted file into a folder.
`java.lang.String[]`	`decryptFileTo(java.lang.String encryptedFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String outputFolder)` Decrypts the content of an OpenPGP encrypted file into a folder.
`java.lang.String`	`decryptStream(java.io.InputStream encryptedStream, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.OutputStream outputStream)` Decrypts an OpenPGP encrypted stream using Private key input stream.
`java.lang.String`	`decryptStream(java.io.InputStream encryptedStream, KeyStore pgpKeyStore, java.lang.String privateKeyPassword, java.io.OutputStream outputStream)` Decrypts an OpenPGP encrypted stream using Private key input stream.
`java.lang.String[]`	`decryptStreamTo(java.io.InputStream encryptedStream, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.lang.String outputFolder)` Decrypts an OpenPGP encrypted stream to a specified folder.
`java.lang.String[]`	`decryptStreamTo(java.io.InputStream encryptedStream, KeyStore keyStore, java.lang.String privateKeyPassword, java.lang.String outputFolder)` Decrypts an OpenPGP encrypted stream to a specified folder.
`void`	`encryptFile(java.lang.String dataFileName, java.io.InputStream publicKeyStream, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts given file using the first available public key from a key ring input stream Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Example:
`void`	`encryptFile(java.lang.String dataFileName, KeyStore keyStore, long[] recipientsKeyIds, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts a file for multiple recipients. Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Example:
`void`	`encryptFile(java.lang.String dataFileName, KeyStore keyStore, long keyId, java.lang.String outputFileName)` OpenPGP encrypts given file using specified public key, stored in specified OpenPGP key store.
`void`	`encryptFile(java.lang.String dataFileName, KeyStore keyStore, long keyId, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts given file using specified public key, stored in specified OpenPGP key store.
`void`	`encryptFile(java.lang.String dataFileName, KeyStore keyStore, java.lang.String[] recipientsUserIds, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts a file for multiple recipients. Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Example:
`void`	`encryptFile(java.lang.String dataFileName, KeyStore keyStore, java.lang.String userId, java.lang.String outputFileName)` OpenPGP encrypts given file using specified public key, stored in specified OpenPGP key store.
`void`	`encryptFile(java.lang.String dataFileName, KeyStore keyStore, java.lang.String userId, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts given file using specified public key, stored in specified OpenPGP key store.
`void`	`encryptFile(java.lang.String dataFileName, java.lang.String[] publicKeysFileNames, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts a file for multiple recipients. Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Example usage:
`void`	`encryptFile(java.lang.String dataFileName, java.lang.String publicKeyFileName, java.lang.String outputFileName, boolean asciiArmor)` OpenPGP encrypts given file using the public key of the recipient.
`void`	`encryptFile(java.lang.String dataFileName, java.lang.String publicKeyFileName, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts given file using the public key of the recipient.
`int`	`encryptFileByKeyId(KeyStore keyStore, java.lang.String dataFileName, java.lang.String keyIdHex, java.lang.String outputFileName)` Deprecated. Use `instead`
`int`	`encryptFileByUserId(KeyStore keyStore, java.lang.String dataFileName, java.lang.String userID, java.lang.String outputFileName)` Deprecated. Use `instead`
`void`	`encryptFilePBE(java.lang.String dataFileName, java.lang.String password, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` Encrypts a file with a passphrase. The same passphrase is used to decrypt the file Equivalent GnuPG command: gpg -c -e [dataFileName] Compression algorithm used is the one specified with `setCompression(String)` if supported by the public key, otherwise the first supported by the key algorithm is used.
`void`	`encryptFilePBE(java.lang.String dataFileName, java.lang.String publicKeyFileName, java.lang.String alternativePassword, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` Encrypts a file with a public key and a passphrase. The passphrase can be used to decrypt the file if the corressponding private key is lost.
`void`	`encryptFiles(java.lang.String[] dataFileNames, KeyStore keyStore, long[] recipientsKeyIds, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts multiple files into one OpenPGP archive Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Example usage:
`void`	`encryptFiles(java.lang.String[] dataFileNames, KeyStore keyStore, java.lang.String[] recipientsUserIds, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts multiple files into one OpenPGP archive Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Example:
`void`	`encryptFiles(java.lang.String[] dataFileNames, java.lang.String[] publicKeysFileNames, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts multiple files into one OpenPGP archive.
`void`	`encryptStream(java.io.InputStream dataStream, java.lang.String fileName, java.io.InputStream publicKeyStream, java.io.OutputStream out, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP Encrypts Input Stream using the first available Public key from a Key ring input stream Compression algorithm used is the one specified with `setCompression(String)` if supported by the public key, otherwise the first supported by the key algorithm is used.
`void`	`encryptStream(java.io.InputStream dataStream, java.lang.String fileName, KeyStore keyStore, long keyId, java.io.OutputStream out, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts input stream using a recipient public key located in a KeyStore Compression algorithm used is the one specified with `setCompression(String)` if supported by the public key, otherwise the first supported by the key algorithm is used.
`void`	`encryptStream(java.io.InputStream dataStream, java.lang.String fileName, KeyStore keyStore, java.lang.String userId, java.io.OutputStream out, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP Encrypts Input Stream using a Public key located in a KeyStore Compression algorithm used is the one specified with `setCompression(String)` if supported by the public key, otherwise the first supported by the key algorithm is used.
`void`	`encryptStream(java.io.InputStream dataStream, java.lang.String fileName, long streamLength, java.io.InputStream publicKeyStream, java.io.OutputStream out, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts an input stream using the first available public key supplied as an input stream Compression algorithm used is the one specified with `setCompression(String)` if supported by the public key, otherwise the first supported by the key algorithm is used.
`void`	`encryptStream(java.io.InputStream dataStream, java.lang.String fileName, long streamLength, java.lang.String publicKeyFileName, java.io.OutputStream out, boolean asciiArmor)` OpenPGP encrypts stream using the first available public key from a key ring file.
`void`	`encryptStream(java.io.InputStream dataStream, java.lang.String fileName, long streamLength, java.lang.String publicKeyFileName, java.io.OutputStream out, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP encrypts stream using the first available public key from a key ring file.
`void`	`encryptStreamPBE(java.io.InputStream dataStream, java.lang.String fileNameLabel, java.lang.String password, java.io.OutputStream out, boolean asciiArmor, boolean withIntegrityCheck)` Encrypts an input stream with a password based OpenPGP encryption (PBE) Compression algorithm used is the one specified with `setCompression(String)` if supported by the public key, otherwise the first supported by the key algorithm is used.
`java.lang.String`	`getCompression()` Returns the preferred compression algorithm used by all methods that produce OpenPGP messages (e.g Encrypt, Sign, etc.) Default is ZIP
`java.lang.String`	`getCypher()` Returns the preferred symmetric key algorithm used by all methods that produce OpenPGP messages (e.g Encrypt, Sign, etc.) Default is CAST5
`boolean`	`isUseExpiredKeys()` Returns should expired keys still be used Default is false
`boolean`	`isUseRevokedKeys()` Returns should revoked keys still be used Default is false
`void`	`setCompression(java.lang.String compression)` Sets the preferred compression algorithm used by all methods that produce OpenPGP messages (e.g Encrypt, Sign, etc.)
`void`	`setCypher(java.lang.String cypher)` Sets the preferred symmetric key algorithm used by all methods that produce OpenPGP messages (e.g Encrypt, Sign, etc.)
`void`	`setHash(java.lang.String hash)` Sets the preferred hashing algorithm used by all methods that produce OpenPGP signature (all Sign and SigneAndEncrypt methods)
`void`	`setUseExpiredKeys(boolean value)` Sets should expired keys still be used
`void`	`setUseRevokedKeys(boolean value)` Sets should revoked keys still be used
`void`	`signAndEncryptFile(java.lang.String fileName, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.InputStream publicKeyStream, java.io.OutputStream outputStream, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP signs and encrypts a file in one pass.
`void`	`signAndEncryptFile(java.lang.String fileName, KeyStore keyStore, long signKeyId, java.lang.String privateKeyPassword, long encKeyId, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP signs and encrypts a file in one pass.
`void`	`signAndEncryptFile(java.lang.String fileName, KeyStore keyStore, java.lang.String signUserId, java.lang.String privateKeyPassword, java.lang.String encUserId, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP signs and encrypts a file in one pass.
`void`	`signAndEncryptFile(java.lang.String dataFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFile, java.lang.String outputFileName, boolean asciiArmor)` OpenPGP signs and encrypts a file in one pass.
`void`	`signAndEncryptFile(java.lang.String dataFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFile, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP signs and encrypts a file in one pass.
`void`	`signAndEncryptFileVersion3(java.lang.String dataFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFile, java.lang.String outputFileName, boolean asciiArmor)` OpenPGP signs and encrypts a file in one pass, using OpenPGP version 3 signature format (compatible with PGP 6.5 and below) (Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.) Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Hashing algorithm used is the one specified with `setHash(String)` Example:
`void`	`signAndEncryptFileVersion3(java.lang.String dataFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFile, java.lang.String outputFileName, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP signs and encrypts a file in one pass, using OpenPGP version 3 signature format (compatible with PGP 6.5 and below) (Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.) Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Hashing algorithm used is the one specified with `setHash(String)` Example:
`void`	`signAndEncryptStream(java.io.InputStream dataFileStream, java.lang.String internalFileName, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.InputStream publicKeyStream, java.io.OutputStream outputStream, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP signs and encrypts a file in one pass.
`void`	`signAndEncryptStream(java.io.InputStream dataFileStream, java.lang.String internalFileName, KeyStore keyStore, java.lang.String signUserId, java.lang.String privateKeyPassword, java.lang.String encUserId, java.io.OutputStream outputStream, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP signs and encrypts a file in one pass.
`void`	`signAndEncryptStreamVersion3(java.io.InputStream dataFileStream, java.lang.String internalFileName, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.InputStream publicKeyStream, java.io.OutputStream outputStream, boolean asciiArmor)` OpenPGP signs and encrypts a file in one pass, using OpenPGP version 3 signature format (compatible with PGP 6.5 and below) (Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.) Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Hashing algorithm used is the one specified with `setHash(String)` Example:
`void`	`signAndEncryptStreamVersion3(java.io.InputStream dataFileStream, java.lang.String internalFileName, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.InputStream publicKeyStream, java.io.OutputStream outputStream, boolean asciiArmor, boolean withIntegrityCheck)` OpenPGP signs and encrypts a file in one pass, using OpenPGP version 3 signature format (compatible with older PGP 2.x systems) (Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.) Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Hashing algorithm used is the one specified with `setHash(String)` Example:
`java.lang.String`	`signAndEncryptString(java.lang.String stringToEncrypt, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFileName)` OpenPGP signs and encrypts a String message in one pass The input String is assumed to be UTF-8 encoded.
`java.lang.String`	`signAndEncryptString(java.lang.String stringToEncrypt, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFileName, java.lang.String charsetName)` OpenPGP signs and encrypts a String message in one pass Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Hashing algorithm used is the one specified with `setHash(String)` Example:
`java.lang.String`	`signAndEncryptStringVersion3(java.lang.String stringToEncrypt, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFileName)` OpenPGP signs and encrypts a String message in one pass with OpenPGP version 3 signatures The input String is assumed to be UTF-8 encoded.
`java.lang.String`	`signAndEncryptStringVersion3(java.lang.String stringToEncrypt, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String publicKeyFileName, java.lang.String charsetName)` OpenPGP signs and encrypts a String message in one pass creating OpenPGP version 3 signatures Compression algorithm used is the one specified with `setCompression(String)` Symmetric cipher algorithm used is the one specified with `setCypher(String)` Hashing algorithm used is the one specified with `setHash(String)` Example:
`void`	`signFile(KeyStore keyStore, java.lang.String dataFileName, long privateKeyId, java.lang.String privateKeyPassword, java.lang.String outputFileName)` OpenPGP signs given file using specified Private Key, using OpenPGP Key Store.
`void`	`signFile(KeyStore keyStore, java.lang.String dataFileName, java.lang.String keyIdHex, java.lang.String privateKeyPassword, java.lang.String outputFileName)` OpenPGP signs given file using specified Private Key, using OpenPGP Key Store.
`void`	`signFile(java.lang.String fileName, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.OutputStream out, boolean asciiArmor)` OpenPGP signs a file.
`void`	`signFile(java.lang.String dataFileName, KeyStore keyStore, java.lang.String privateKeyUserId, java.lang.String privateKeyPassword, java.lang.String outputFileName, boolean asciiArmor)` OpenPGP signs a file, with private key stored in a KeyStore object.
`void`	`signFile(java.lang.String inputFileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String outputFileName, boolean asciiArmor)` OpenPGP signs a file.
`void`	`signFileVersion3(java.lang.String fileName, java.lang.String privateKeyFileName, java.lang.String privateKeyPassword, java.lang.String outputFileName, boolean asciiArmor)` Signs a file in OpenPGP version 3 format (compatible with PGP 2.x systems) Optional settings: Compression algorithm used is the one specified with `setCompression(String)` Hashing algorithm used is the one specified with `setHash(String)` Example usage:
`void`	`signStream(java.io.InputStream dataInputStream, java.lang.String fileNameLabel, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.OutputStream signedStream, boolean asciiArmor)` OpenPGP signs a stream.
`void`	`signStream(java.io.InputStream dataInputStream, java.lang.String fileNameLabel, KeyStore keyStore, long signingKeyId, java.lang.String privateKeyPassword, java.io.OutputStream signedStream, boolean asciiArmor)` OpenPGP signs stream with a private key stored in a KeyStore.
`void`	`signStream(java.io.InputStream dataInputStream, java.lang.String fileNameLabel, KeyStore keyStore, java.lang.String signingKeyUserId, java.lang.String privateKeyPassword, java.io.OutputStream signedStream, boolean asciiArmor)` OpenPGP signs stream with a private key stored in a KeyStore.
`void`	`signStreamVersion3(java.io.InputStream dataFileStream, java.lang.String internalFileName, java.io.InputStream privateKeyStream, java.lang.String privateKeyPassword, java.io.OutputStream out, boolean asciiArmor)` Signs a stream using OpenPGP version 3 signatures format (compatible with PGP 2.x systems) Optional settings: Compression algorithm used is the one specified with `setCompression(String)` Hashing algorithm used is the one specified with `setHash(String)` Example:
`boolean`	`verifyFile(java.io.InputStream dataFileStream, java.io.InputStream publicKeyStream)` Deprecated. Use `verifyStream(InputStream, InputStream)`
`boolean`	`verifyFile(java.lang.String dataFileName, KeyStore keyStore, java.lang.String outputFileName)` Verifies the incoming file as being correctly signed.
`boolean`	`verifyFile(java.lang.String dataFileName, java.lang.String publicKeyFileName)` Verifies the incoming file as being correctly signed.
`boolean`	`verifyFile(java.lang.String dataFileName, java.lang.String publicKeyFileName, java.lang.String outputFileName)` Verifies the incoming file as being correctly signed.
`boolean`	`verifyStream(java.io.InputStream dataFileStream, java.io.InputStream publicKeyStream)` Verifies the incoming stream as being correctly signed.
`boolean`	`verifyStream(java.io.InputStream dataFileStream, java.io.InputStream publicKeyStream, java.io.OutputStream outputFileStream)` Verifies the incoming stream as being correctly signed.
`boolean`	`verifyStream(java.io.InputStream dataFileStream, KeyStore keyStore, java.io.OutputStream outputFileStream)` Verifies the incoming stream as being correctly signed.
`boolean`	`verifyString(java.lang.String message, java.lang.String publicKeyFileName, java.lang.StringBuffer decryptedString)` Verifies an OpenPGP signed only message.
`boolean`	`verifyString(java.lang.String message, java.lang.String publicKeyFileName, java.lang.StringBuffer decryptedString, java.lang.String charsetName)` Verifies an OpenPGP signed only message.

Methods inherited from class java.lang.Object
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

PGPLib

public PGPLib()

Method Detail

isUseExpiredKeys

public boolean isUseExpiredKeys()

Returns should expired keys still be used
Default is false

Since:: 2.5.7

setUseExpiredKeys

public void setUseExpiredKeys(boolean value)

Sets should expired keys still be used

Since:: 2.5.7

isUseRevokedKeys

public boolean isUseRevokedKeys()

Returns should revoked keys still be used
Default is false

Since:: 2.5.7

setUseRevokedKeys

public void setUseRevokedKeys(boolean value)

Sets should revoked keys still be used

Since:: 2.5.7

setHash

public void setHash(java.lang.String hash)

Sets the preferred hashing algorithm used by all methods that produce OpenPGP signature (all Sign and SigneAndEncrypt methods)

See Also:: HashAlgorithm

getCypher

public java.lang.String getCypher()

Returns the preferred symmetric key algorithm used by all methods that produce OpenPGP messages (e.g Encrypt, Sign, etc.)
Default is CAST5

See Also:: CypherAlgorithm

setCypher

public void setCypher(java.lang.String cypher)

Sets the preferred symmetric key algorithm used by all methods that produce OpenPGP messages (e.g Encrypt, Sign, etc.)

See Also:: CypherAlgorithm

getCompression

public java.lang.String getCompression()

Returns the preferred compression algorithm used by all methods that produce OpenPGP messages (e.g Encrypt, Sign, etc.)
Default is ZIP

See Also:: CompressionAlgorithm

setCompression

public void setCompression(java.lang.String compression)

Sets the preferred compression algorithm used by all methods that produce OpenPGP messages (e.g Encrypt, Sign, etc.)

See Also:: CompressionAlgorithm

clearSignFile

public void clearSignFile(java.lang.String inputFileName,
                          java.lang.String privateKeyFileName,
                          java.lang.String privateKeyPassword,
                          java.lang.String hashingAlgorithm,
                          java.lang.String outputFileName)
                   throws PGPException,
                          java.io.IOException,
                          WrongPasswordException

OpenPGP clear signs a file.

GPG equivalent command: gpg --clearsign inputFileName --output outputFileName

Example:

 import com.didisoft.pgp.*;
 
 public class ClearSignDemo {
     public static void main(String[] args) throws Exception{
         // initialize the library 
         PGPLib pgp = new PGPLib();
         
         // clear sign
         pgp.clearSignFile("INPUT.txt", 
                           "private.key", 
                           "private key password", 
                           HashAlgorithm.SHA256, 
                           "OUTPUT.sig.txt");
     }
 }

Parameters:: inputFileName - File name to be clear signed (absolute or relative path); privateKeyFileName - Private Key file (absolute or relative path); privateKeyPassword - Private key password; hashingAlgorithm - Hashing algorithm, one of: SHA256, SHA384, SHA512, SHA224, SHA1, MD5, RIPEMD160, MD2; outputFileName - Output file name (absolute or relative path)
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; WrongPasswordException - If the private key password is incorrect; java.security.InvalidParameterException - If the hashingAlgorithm parameter is not among the supported values; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: HashAlgorithm

clearSignFileVersion3

public void clearSignFileVersion3(java.lang.String inputFileName,
                                  java.lang.String privateKeyFileName,
                                  java.lang.String privateKeyPassword,
                                  java.lang.String hashingAlgorithm,
                                  java.lang.String outputFileName)
                           throws PGPException,
                                  java.io.IOException,
                                  WrongPasswordException

OpenPGP clear signs a file, using OpenPGP version 3 signature format (old format used by PGP 2.x)

Use when needed compatibility with PGP 2.x

GPG equivalent command: gpg --force-v3-sigs --clearsign inputFileName

Example:

 import com.didisoft.pgp.*;
 
 public class ClearSignVersion3Demo {
     public static void main(String[] args) throws Exception{
         // initialize the library 
         PGPLib pgp = new PGPLib();
         
         // clear sign with version 3 signature
         pgp.clearSignFileVersion3("INPUT.txt", 
                           "private.key", 
                           "private key password", 
                           HashAlgorithm.SHA256, 
                           "OUTPUT.sig.txt");
     }
 }

Parameters:: inputFileName - File name to be clear signed (absolute or relative path); privateKeyFileName - Private Key file (absolute or relative path); privateKeyPassword - Private key password; hashingAlgorithm - Hashing algorithm, one of: SHA256, SHA384, SHA512, SHA224, SHA1, MD5, RIPEMD160, MD2; outputFileName - Output file name (absolute or relative path)
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; WrongPasswordException - If the private key password is incorrect; java.security.InvalidParameterException - If the hashingAlgorithm parameter is other than the supported values; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: HashAlgorithm, clearSignString(String, String, String, String)

clearSignString

public java.lang.String clearSignString(java.lang.String stringToSign,
                                        java.lang.String privateKeyFileName,
                                        java.lang.String privateKeyPassword,
                                        java.lang.String hashingAlgorithm)
                                 throws PGPException,
                                        java.io.IOException,
                                        WrongPasswordException

OpenPGP clear signs a String

Example usage:

 import com.didisoft.pgp.*;
 
 public class ClearSignDemo {
     public static void main(String[] args) throws Exception{
         // initialize the library 
         PGPLib pgp = new PGPLib();
         
         String message = "The quick brown fox jumps.";
          
         // clear sign
         String clearSignedMessage = 
           pgp.clearSignString(message, 
                               "private.key", 
                               "private key password", 
                               HashAlgorithm.SHA256);
     }
 }

Parameters:: stringToSign - String message to be signed; privateKeyFileName - Private Key file (absolute or relative path); privateKeyPassword - Private key password; hashingAlgorithm - Hashing algorithm, one of: SHA256, SHA384, SHA512, SHA224, SHA1, MD5, RIPEMD160, MD2
Returns:: The clear signed message.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; WrongPasswordException - If the private key password is incorrect; java.security.InvalidParameterException - If the hashingAlgorithm parameter is other than the supported values. Runtime exception; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: clearSignStringVersion3(String, String, String, String), HashAlgorithm

clearSignStringVersion3

public java.lang.String clearSignStringVersion3(java.lang.String stringToSign,
                                                java.lang.String privateKeyFileName,
                                                java.lang.String privateKeyPassword,
                                                java.lang.String hashingAlgorithm)
                                         throws PGPException,
                                                java.io.IOException,
                                                WrongPasswordException

OpenPGP clear signs a String, using OpenPGP version 3 signature format (the old format)

Use when needed compatibility with PGP 2.x and PGP 5.x systems.

Parameters:: stringToSign - String message to be signed; privateKeyFileName - Private Key file (absolute or relative path); privateKeyPassword - Private key password; hashingAlgorithm - Hashing algorithm, one of: SHA256, SHA384, SHA512, SHA224, SHA1, MD5, RIPEMD160, MD2.
@see HashAlgorithm
Returns:: The clear signed message.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; WrongPasswordException - If the private key password is incorrect; java.security.InvalidParameterException - If the hashingAlgorithm parameter is other than the supported values. Runtime exception; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: clearSignFileVersion3(String, String, String, String, String), verifyFile(String, String, String)

signFile

public void signFile(KeyStore keyStore,
                     java.lang.String dataFileName,
                     java.lang.String keyIdHex,
                     java.lang.String privateKeyPassword,
                     java.lang.String outputFileName)
              throws PGPException,
                     WrongPasswordException,
                     java.io.IOException

OpenPGP signs given file using specified Private Key, using OpenPGP Key Store.

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Hashing algorithm used is the one specified with setHash(String)

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store instance containing the private key to be used for signing; keyIdHex - key ID of the Public Key in Hex format; privateKeyPassword - Private key password; outputFileName - File name of the Output encrypted file (absolute or relative path)
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; WrongPasswordException - If the private key password is incorrect; java.io.IOException - I/O error; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyFile(String, String, String)

signFile

public void signFile(KeyStore keyStore,
                     java.lang.String dataFileName,
                     long privateKeyId,
                     java.lang.String privateKeyPassword,
                     java.lang.String outputFileName)
              throws PGPException,
                     WrongPasswordException,
                     java.io.IOException

 import com.didisoft.pgp.KeyStore;
 import com.didisoft.pgp.PGPLib;
 
 public class KeyStoreSignFileDemo {
     public static void main(String[] args) throws Exception{        
         // create an instance of the KeyStore
         KeyStore keyStore = new KeyStore("pgp.keystore", "changeit");
         
         // initialize the library 
         PGPLib pgp = new PGPLib();
 
         // The signing key is usually our private key
         long signKeyId = keyStore.getKeyIdForUserId("demo@didisoft.com");
         String signKeyPassword = "changeit";        
         
         pgp.signFile("INPUT.txt",
                     keyStore, 
                     signKeyId, 
                     signKeyPassword, 
                     "signed.pgp");
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store containing the private key to be used for signing; privateKeyId - Key Id of the private key to be used for signing; privateKeyPassword - Private key password; outputFileName - File name of the output signed file (absolute or relative path)
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; WrongPasswordException - If the private key password is incorrect; java.io.IOException - I/O error; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyFile(String, KeyStore, String)

signFile

public void signFile(java.lang.String dataFileName,
                     KeyStore keyStore,
                     java.lang.String privateKeyUserId,
                     java.lang.String privateKeyPassword,
                     java.lang.String outputFileName,
                     boolean asciiArmor)
              throws PGPException,
                     WrongPasswordException,
                     java.io.IOException

OpenPGP signs a file, with private key stored in a KeyStore object.

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import com.didisoft.pgp.KeyStore;
 import com.didisoft.pgp.PGPLib;
 
 public class KeyStoreSignFileDemo {
     public static void main(String[] args) throws Exception{        
         // create an instance of the KeyStore
         KeyStore keyStore = new KeyStore("pgp.keystore", "changeit");
         
         // initialize the library 
         PGPLib pgp = new PGPLib();
 
         // The signing key is usually our private key
         long signKeyUserId = "demo@didisoft.com";
         String signKeyPassword = "changeit";        
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         pgp.signFile("INPUT.txt",
                     keyStore, 
                     signKeyUserId, 
                     signKeyPassword, 
                     "signed.pgp",
                     asciiArmor);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store containing the private key to be used for signing; privateKeyUserId - signing key User Id; privateKeyPassword - signing key password; outputFileName - File name of the output signed file (absolute or relative path); asciiArmor - boolean if true the output is ASCII armored, if false the output is in binary format
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; WrongPasswordException - If the private key password is incorrect; java.io.IOException - I/O error; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
Since:: 2.5.2
See Also:: verifyFile(String, KeyStore, String)

signFile

public void signFile(java.lang.String inputFileName,
                     java.lang.String privateKeyFileName,
                     java.lang.String privateKeyPassword,
                     java.lang.String outputFileName,
                     boolean asciiArmor)
              throws java.io.IOException,
                     PGPException,
                     WrongPasswordException

OpenPGP signs a file.

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Hashing algorithm used is the one specified with setHash(String)

Example usage:

 import com.didisoft.pgp.*;
 
 public class SignFile {
     public static void main(String[] args) throws Exception{
         // initialize the library 
         PGPLib pgp = new PGPLib();
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         pgp.signFile("INPUT.txt", 
                     "private_key.asc", 
                     "private key password", 
                     "signed.pgp", 
                     asciiArmor);
     }
 }

Parameters:: inputFileName - File Name to be OpenPGP Signed (absolute or relative path); privateKeyFileName - Private Key file (absolute or relative path); privateKeyPassword - Private key password; outputFileName - File name of the output OpenPGP signed file (absolute or relative path); asciiArmor - boolean if true the output is ASCII armored, if false the output is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; WrongPasswordException - If the private key password is incorrect; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyFile(InputStream, InputStream)

signFile

public void signFile(java.lang.String fileName,
                     java.io.InputStream privateKeyStream,
                     java.lang.String privateKeyPassword,
                     java.io.OutputStream out,
                     boolean asciiArmor)
              throws java.io.IOException,
                     PGPException,
                     WrongPasswordException

OpenPGP signs a file.

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import java.io.*;
 import com.didisoft.pgp.PGPLib;
 
 public class SignFileDemo {
     public static void main(String[] args) throws Exception{        
         // initialize the library 
         PGPLib pgp = new PGPLib();
 
         // The signing key is usually our private key
         FileInputStream privateKeyStream = new FileInputStream("private_key.asc");
         String signKeyPassword = "changeit";        
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         
         FileOutputStream outputSignedStream = new FileOutputStream("signed.pgp");
          
         pgp.signFile("c:\\Data\\INPUT.txt",
                     privateKeyStream, 
                     signKeyPassword, 
                     outputSignedFile,
                     asciiArmor);
     }
 }

Parameters:: fileName - File Name to be signed (absolute or relative path); privateKeyStream - Private Key input stream; out - Output Stream signed; privateKeyPassword - Private key password; asciiArmor - if true output stream is in ASCII armored format, when false output stream is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyStream does not contain an OpenPGP private key. Extends PGPException; WrongPasswordException - If the specified password for the private key is incorrect; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyStream(InputStream, InputStream, OutputStream)

signStream

public void signStream(java.io.InputStream dataInputStream,
                       java.lang.String fileNameLabel,
                       java.io.InputStream privateKeyStream,
                       java.lang.String privateKeyPassword,
                       java.io.OutputStream signedStream,
                       boolean asciiArmor)
                throws java.io.IOException,
                       PGPException,
                       WrongPasswordException

OpenPGP signs a stream.

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import java.io.*;
 import com.didisoft.pgp.PGPLib;
 
 public class SignStreamDemo {
     public static void main(String[] args) throws Exception{        
         // initialize the library 
         PGPLib pgp = new PGPLib();
 
         // The signing key is usually our private key
         FileInputStream privateKeyStream = new FileInputStream("private_key.asc");
         String signKeyPassword = "changeit";        
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         
         FileInputStream dataStream = new FileInputStream("c:\\Data\\INPUT.txt");
         FileOutputStream outputSignedStream = new FileOutputStream("signed.pgp");
          
         pgp.signStream(dataStream,
                     "INPUT.txt" 
                     privateKeyStream, 
                     signKeyPassword, 
                     outputSignedFile,
                     asciiArmor);
     }
 }

Parameters:: dataInputStream - InputStream containing data to be signed; fileNameLabel - File name string to be associated with the data stream in the produced OpenPGP archive.; privateKeyStream - Private key input stream; signedStream - Output stream signed; privateKeyPassword - Private key password; asciiArmor - if true output stream is in ASCII armored format, when false output stream is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyStream does not contain an OpenPGP private key. Extends PGPException; WrongPasswordException - If the specified password for the private key is incorrect; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyStream(InputStream, InputStream, OutputStream)

signStream

public void signStream(java.io.InputStream dataInputStream,
                       java.lang.String fileNameLabel,
                       KeyStore keyStore,
                       java.lang.String signingKeyUserId,
                       java.lang.String privateKeyPassword,
                       java.io.OutputStream signedStream,
                       boolean asciiArmor)
                throws java.io.IOException,
                       PGPException,
                       WrongPasswordException

OpenPGP signs stream with a private key stored in a KeyStore.

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class SignStreamDemo {
     public static void main(String[] args) throws Exception{        
         // create an instance of the KeyStore
         KeyStore keyStore = new KeyStore("pgp.keystore", "changeit");
         
         // initialize the library 
         PGPLib pgp = new PGPLib();
 
         // The signing key is usually our private key
         long signUserId = "demo@didisoft.com";
         String signKeyPassword = "changeit";        
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         
         FileInputStream dataStream = new FileInputStream("c:\\Data\\INPUT.txt");
         FileOutputStream outputSignedStream = new FileOutputStream("signed.pgp");
          
         pgp.signStream(dataStream,
                     "INPUT.txt" 
                     keyStore, 
                     signUserId, 
                     signKeyPassword, 
                     outputSignedFile,
                     asciiArmor);
     }
 }

Parameters:: dataInputStream - InputStream containing data to be signed; fileNameLabel - File name string to be associated with the data stream in the produced OpenPGP archive.; keyStore - KeyStore containing the private key for signing; signingKeyUserId - Primary User Id of the private key; privateKeyPassword - Private key password; signedStream - Output stream signed; asciiArmor - if true output stream is in ASCII armored format, when false output stream is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; WrongPasswordException - If the specified password for the private key is incorrect; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyStream(InputStream, KeyStore, OutputStream)

signStream

public void signStream(java.io.InputStream dataInputStream,
                       java.lang.String fileNameLabel,
                       KeyStore keyStore,
                       long signingKeyId,
                       java.lang.String privateKeyPassword,
                       java.io.OutputStream signedStream,
                       boolean asciiArmor)
                throws java.io.IOException,
                       PGPException,
                       WrongPasswordException

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class SignStreamDemo {
     public static void main(String[] args) throws Exception{        
         // create an instance of the KeyStore
         KeyStore keyStore = new KeyStore("pgp.keystore", "changeit");
         
         // initialize the library 
         PGPLib pgp = new PGPLib();
 
         // The signing key is usually our private key
         long signKeyId = keyStore.getKeyIdForUserId("demo@didisoft.com");
         String signKeyPassword = "changeit";        
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         
         FileInputStream dataStream = new FileInputStream("c:\\Data\\INPUT.txt");
         FileOutputStream outputSignedStream = new FileOutputStream("signed.pgp");
          
         pgp.signStream(dataStream,
                     "INPUT.txt" 
                     keyStore, 
                     signKeyId, 
                     signKeyPassword, 
                     outputSignedFile,
                     asciiArmor);
     }
 }

Parameters:: dataInputStream - InputStream containing data to be signed; fileNameLabel - File name string to be associated with the data stream in the produced OpenPGP archive.; keyStore - KeyStore containing the private key for signing; signingKeyId - Key Id of the private key; privateKeyPassword - Private key password; signedStream - Output stream signed; asciiArmor - if true output stream is in ASCII armored format, when false output stream is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; WrongPasswordException - If the specified password for the private key is incorrect; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyStream(InputStream, KeyStore, OutputStream)

signFileVersion3

public void signFileVersion3(java.lang.String fileName,
                             java.lang.String privateKeyFileName,
                             java.lang.String privateKeyPassword,
                             java.lang.String outputFileName,
                             boolean asciiArmor)
                      throws java.io.IOException,
                             PGPException,
                             WrongPasswordException

Signs a file in OpenPGP version 3 format (compatible with PGP 2.x systems)

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Hashing algorithm used is the one specified with setHash(String)

Example usage:

 import com.didisoft.pgp.*;
 
 public class SignFileV3Demo {
     public static void main(String[] args) throws Exception{
         // initialize the library 
         PGPLib pgp = new PGPLib();
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         
         signFileVersion3("INPUT.txt", 
                     "private_key.asc", 
                     "private key password", 
                     "signed.pgp", 
                     asciiArmor);
     }
 }

Parameters:: fileName - File Name to be signed (absolute or relative path); privateKeyFileName - Private Key file (absolute or relative path); privateKeyPassword - Private Key password; outputFileName - File name of the output OpenPGP signed file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, when false output is in binary format
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; WrongPasswordException - If the specified password for the private key is incorrect. Extends PGPException; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyFile(String, String, String)

signStreamVersion3

public void signStreamVersion3(java.io.InputStream dataFileStream,
                               java.lang.String internalFileName,
                               java.io.InputStream privateKeyStream,
                               java.lang.String privateKeyPassword,
                               java.io.OutputStream out,
                               boolean asciiArmor)
                        throws java.io.IOException,
                               PGPException,
                               WrongPasswordException

Signs a stream using OpenPGP version 3 signatures format (compatible with PGP 2.x systems)

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import java.io.*;
 import com.didisoft.pgp.PGPLib;
 
 public class SignStreamDemo {
     public static void main(String[] args) throws Exception{        
         // initialize the library 
         PGPLib pgp = new PGPLib();
 
         // The signing key is usually our private key
         FileInputStream privateKeyStream = new FileInputStream("private_key.asc");
         String signKeyPassword = "changeit";        
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         
         FileInputStream dataStream = new FileInputStream("c:\\Data\\INPUT.txt");
         FileOutputStream outputSignedStream = new FileOutputStream("signed.pgp");
          
         pgp.signStreamVersion3(dataStream,
                     "INPUT.txt" 
                     privateKeyStream, 
                     signKeyPassword, 
                     outputSignedFile,
                     asciiArmor);
     }
 }

Parameters:: dataFileStream - File data input stream, to be signed; internalFileName - File name to be associated with the data stream in the produced OpenPGP archive; privateKeyStream - Private Key input stream; out - Output Stream signed; privateKeyPassword - Private key password; asciiArmor - if true output is in ASCII armored format, when false output is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyStream does not contain an OpenPGP private key. Extends PGPException; WrongPasswordException - If the specified password for the private key is incorrect; KeyIsExpiredException - If the key is expired. Extends PGPException; KeyIsRevokedException - If the key is revoked. Extends PGPException; PGPException
See Also:: verifyStream(InputStream, InputStream, OutputStream)

signAndEncryptFile

public void signAndEncryptFile(java.lang.String dataFileName,
                               java.lang.String privateKeyFileName,
                               java.lang.String privateKeyPassword,
                               java.lang.String publicKeyFile,
                               java.lang.String outputFileName,
                               boolean asciiArmor)
                        throws PGPException,
                               WrongPasswordException,
                               java.io.IOException

OpenPGP signs and encrypts a file in one pass.
(Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.)

Optional settings:
Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // sign and encrypt
         pgp.signAndEncryptFile("INPUT.txt", 
                                 "private_key.asc", 
                                 "key password",
                                 "recipient_key.asc",
                                 "encrypted_output.pgp", 
                                 asciiArmor,
                                 withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File Name to be OpenPGP signed and encrypted (absolute or relative path); privateKeyFileName - Private Key file (absolute or relative path), used for signing; privateKeyPassword - Private key password; publicKeyFile - Public key file (absolute or relative path), used for encryption; outputFileName - File name of the OpenPGP Signed file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, when false output is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the specified password for the private key is incorrect. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: decryptAndVerifyFile(String, String, String, String, String)

signAndEncryptFile

public void signAndEncryptFile(java.lang.String dataFileName,
                               java.lang.String privateKeyFileName,
                               java.lang.String privateKeyPassword,
                               java.lang.String publicKeyFile,
                               java.lang.String outputFileName,
                               boolean asciiArmor,
                               boolean withIntegrityCheck)
                        throws PGPException,
                               WrongPasswordException,
                               java.io.IOException

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // sign and encrypt
         pgp.signAndEncryptFile("INPUT.txt", 
                                 "private_key.asc", 
                                 "key password",
                                 "recipient_key.asc",
                                 "encrypted_output.pgp", 
                                 asciiArmor,
                                 withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File Name to be OpenPGP signed and encrypted (absolute or relative path); privateKeyFileName - Private Key file (absolute or relative path), used for signing; privateKeyPassword - Private key password; publicKeyFile - Public key file (absolute or relative path), used for encryption; outputFileName - File name of the OpenPGP Signed file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - Should integrity check be added to the output file.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the specified password for the private key is incorrect. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: decryptAndVerifyFile(String, String, String, String, String)

signAndEncryptFile

public void signAndEncryptFile(java.lang.String fileName,
                               java.io.InputStream privateKeyStream,
                               java.lang.String privateKeyPassword,
                               java.io.InputStream publicKeyStream,
                               java.io.OutputStream outputStream,
                               boolean asciiArmor,
                               boolean withIntegrityCheck)
                        throws java.io.IOException,
                               PGPException,
                               WrongPasswordException

 import java.io.*;
 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // The signing key is usually our private key
         FileInputStream privateKeyStream = new FileInputStream("private_key.asc");
         String signKeyPassword = "changeit";
         
         FileInputStream publicEncryptionKeyStream = new FileInputStream("recipient_key.asc");        
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         
         FileOutputStream outputStream = new FileOutputStream("encrypted_output.pgp");
         
         // sign and encrypt
         pgp.signAndEncryptFile("INPUT.txt", 
                                 privateKeyStream, 
                                 signKeyPassword,
                                 publicEncryptionKeyStream,
                                 outputStream, 
                                 asciiArmor,
                                 withIntegrityCheck);
     }
 }

Parameters:: fileName - File Name to be OpenPGP Signed (absolute or relative path); privateKeyStream - Private Key input stream (used for signing); privateKeyPassword - Private key password; publicKeyStream - Public Key input stream (used for encryption); outputStream - Output Stream signed and encrypted; asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - Should integrity check be added to the file.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyStream does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyStream does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the private key password is incorrect. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: decryptAndVerifyStream(InputStream, InputStream, String, InputStream, OutputStream)

signAndEncryptStream

public void signAndEncryptStream(java.io.InputStream dataFileStream,
                                 java.lang.String internalFileName,
                                 java.io.InputStream privateKeyStream,
                                 java.lang.String privateKeyPassword,
                                 java.io.InputStream publicKeyStream,
                                 java.io.OutputStream outputStream,
                                 boolean asciiArmor,
                                 boolean withIntegrityCheck)
                          throws java.io.IOException,
                                 PGPException,
                                 WrongPasswordException,
                                 NoPublicKeyFoundException,
                                 NoPrivateKeyFoundException

 import java.io.*;
 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // The signing key is usually our private key
         FileInputStream privateKeyStream = new FileInputStream("private_key.asc");
         String signKeyPassword = "changeit";
         
         FileInputStream publicEncryptionKeyStream = new FileInputStream("recipient_key.asc");        
         
         // specify should the output be ASCII or binary
         boolean asciiArmor = false;
         
         FileInputStream dataStream = new FileInputStream("c:\\Data\\INPUT.txt");
         FileOutputStream outputStream = new FileOutputStream("encrypted_output.pgp");
         
         // sign and encrypt
         pgp.signAndEncryptStream(dataStream,
                                 "INPUT.txt", 
                                 privateKeyStream, 
                                 signKeyPassword,
                                 publicEncryptionKeyStream,
                                 outputStream, 
                                 asciiArmor,
                                 withIntegrityCheck);
     }
 }

Parameters:: dataFileStream - Data input stream to be signed; internalFileName - File name string to be associated with the data stream in the produced OpenPGP archive.; privateKeyStream - Private Key input stream (used for signing); privateKeyPassword - Private key password; publicKeyStream - Public Key input stream (used for encryption); outputStream - Output Stream signed and encrypted; asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - Should integrity check be added to the file.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyStream does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyStream does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the private key password is incorrect. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: decryptAndVerifyStream(InputStream, InputStream, String, InputStream, OutputStream)

signAndEncryptFile

public void signAndEncryptFile(java.lang.String fileName,
                               KeyStore keyStore,
                               java.lang.String signUserId,
                               java.lang.String privateKeyPassword,
                               java.lang.String encUserId,
                               java.lang.String outputFileName,
                               boolean asciiArmor,
                               boolean withIntegrityCheck)
                        throws java.io.IOException,
                               PGPException

OpenPGP signs and encrypts a file in one pass.

(Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.)
Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // create an instance of the KeyStore
         KeyStore keyStore = new KeyStore("pgp.keystore", "changeit");
         
         // The signing key is usually our private key
         String signKeyUserId = "demo@didisoft.com";
         String signKeyPassword = "changeit";
         
         String encryptionKeyUserId = "Recipient Company ACM";
                 
         // sign and encrypt
         pgp.signAndEncryptFile("INPUT.txt",
                                 keyStore,  
                                 signKeyUserId, 
                                 signKeyPassword,
                                 encryptionKeyUserId,
                                 "encrypted_output.pgp", 
                                 asciiArmor,
                                 withIntegrityCheck);
     }
 }

Parameters:: fileName - File Name to be OpenPGP signed and encrypted (absolute or relative path); keyStore - KeyStore containing the private key for signing and the public key for encryption; signUserId - User Id of the private key for signing of the form "name (comment) <email address>"; privateKeyPassword - Private key password; encUserId - User Id of the public encryption key of the form "name (comment) <email address>"; outputFileName - File name of the OpenPGP Signed file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - if true integrity check information is added to the output file.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: verifyFile(String, String, String)

signAndEncryptFile

public void signAndEncryptFile(java.lang.String fileName,
                               KeyStore keyStore,
                               long signKeyId,
                               java.lang.String privateKeyPassword,
                               long encKeyId,
                               java.lang.String outputFileName,
                               boolean asciiArmor,
                               boolean withIntegrityCheck)
                        throws java.io.IOException,
                               PGPException

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // create an instance of the KeyStore
         KeyStore keyStore = new KeyStore("pgp.keystore", "changeit");
         
         // The signing key is usually our private key
         String signKeyId = keyStore.getKeyIdForUserId("demo@didisoft.com");
         String signKeyPassword = "changeit";
         
         String encryptionKeyId = keyStore.getKeyIdForKeyIdHex("74BB3286");
                 
         // sign and encrypt
         pgp.signAndEncryptFile("INPUT.txt",
                                 keyStore,  
                                 signKeyId, 
                                 signKeyPassword,
                                 encryptionKeyId,
                                 "encrypted_output.pgp", 
                                 asciiArmor,
                                 withIntegrityCheck);
     }
 }

Parameters:: fileName - File Name to be OpenPGP signed and encrypted (absolute or relative path); keyStore - KeyStore containing the private key for signing and the public key for encryption; signKeyId - Key Id of the private key for signing; privateKeyPassword - Private key password; encKeyId - Key Id of the public encryption key; outputFileName - File name of the OpenPGP Signed file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - if true integrity check information is added to the output file.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: verifyFile(String, String, String)

signAndEncryptStream

public void signAndEncryptStream(java.io.InputStream dataFileStream,
                                 java.lang.String internalFileName,
                                 KeyStore keyStore,
                                 java.lang.String signUserId,
                                 java.lang.String privateKeyPassword,
                                 java.lang.String encUserId,
                                 java.io.OutputStream outputStream,
                                 boolean asciiArmor,
                                 boolean withIntegrityCheck)
                          throws java.io.IOException,
                                 PGPException

 import java.io.*;
 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // create an instance of the KeyStore
         KeyStore keyStore = new KeyStore("pgp.keystore", "changeit");
         
         // The signing key is usually our private key
         String signKeyUserId = "demo@didisoft.com";
         String signKeyPassword = "changeit";
         
         String encryptionKeyUserId = "Recipient Company ACM";
                 
         FileInputStream dataStream = new FileInputStream("c:\\Data\\INPUT.txt");
         FileOutputStream outputSignedStream = new FileOutputStream("signed.pgp");
         
         // sign and encrypt
         pgp.signAndEncryptStream(dataStream,
                                 "INPUT.txt",
                                 keyStore,  
                                 signKeyUserId, 
                                 signKeyPassword,
                                 encryptionKeyUserId,
                                 outputSignedStream, 
                                 asciiArmor,
                                 withIntegrityCheck);
     }
 }

Parameters:: dataFileStream - File data input stream, to be signed; internalFileName - File name string to be associated with the data stream in the produced OpenPGP archive.; keyStore - KeyStore containing the private key for signing and the public key for encryption; signUserId - userId of the private key for signing of the form "name (comment) <email address>"; privateKeyPassword - Private key password; encUserId - userId of the public key for encryption of the form "name (comment) <email address>"; outputStream - Output Stream signed and encrypted; asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - should integrity check be added to the file.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: verifyStream(InputStream, KeyStore, OutputStream)

signAndEncryptFileVersion3

public void signAndEncryptFileVersion3(java.lang.String dataFileName,
                                       java.lang.String privateKeyFileName,
                                       java.lang.String privateKeyPassword,
                                       java.lang.String publicKeyFile,
                                       java.lang.String outputFileName,
                                       boolean asciiArmor)
                                throws PGPException,
                                       java.io.IOException

OpenPGP signs and encrypts a file in one pass, using OpenPGP version 3 signature format (compatible with PGP 6.5 and below)

(Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.)
Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         
         // sign and encrypt
         pgp.signAndEncryptFileVersion3("INPUT.txt", 
                                 "private_key.asc", 
                                 "key password",
                                 "recipient_key.asc",
                                 "encrypted_output.pgp", 
                                 asciiArmor);
     }
 }

Parameters:: dataFileName - File Name to be OpenPGP signed and encrypted (absolute or relative path); privateKeyFileName - Private Key file (absolute or relative path), used for signing; privateKeyPassword - Private key password; publicKeyFile - Public key file (absolute or relative path), used for encryption; outputFileName - File name of the OpenPGP Signed file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, when false output is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: decryptAndVerifyFile(String, String, String, String, String)

signAndEncryptFileVersion3

public void signAndEncryptFileVersion3(java.lang.String dataFileName,
                                       java.lang.String privateKeyFileName,
                                       java.lang.String privateKeyPassword,
                                       java.lang.String publicKeyFile,
                                       java.lang.String outputFileName,
                                       boolean asciiArmor,
                                       boolean withIntegrityCheck)
                                throws PGPException,
                                       java.io.IOException

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // sign and encrypt
         pgp.signAndEncryptFileVersion3("INPUT.txt", 
                                 "private_key.asc", 
                                 "key password",
                                 "recipient_key.asc",
                                 "encrypted_output.pgp", 
                                 asciiArmor,
                                 withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File Name to be OpenPGP signed and encrypted (absolute or relative path); privateKeyFileName - Private Key file (absolute or relative path), used for signing; privateKeyPassword - Private key password; publicKeyFile - Public key file (absolute or relative path), used for encryption; outputFileName - File name of the OpenPGP Signed file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - Should integrity check be added to the file. When producing data to be used by old systems (e.g. PGP 6.5) it is better to be false.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: decryptAndVerifyFile(String, String, String, String, String)

signAndEncryptStreamVersion3

public void signAndEncryptStreamVersion3(java.io.InputStream dataFileStream,
                                         java.lang.String internalFileName,
                                         java.io.InputStream privateKeyStream,
                                         java.lang.String privateKeyPassword,
                                         java.io.InputStream publicKeyStream,
                                         java.io.OutputStream outputStream,
                                         boolean asciiArmor)
                                  throws java.io.IOException,
                                         PGPException,
                                         WrongPasswordException

OpenPGP signs and encrypts a file in one pass, using OpenPGP version 3 signature format (compatible with PGP 6.5 and below)
(Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.)
Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import java.io.*;
 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // The signing key is usually our private key
         FileInputStream privateKeyStream = new FileInputStream("private_key.asc");
         String signKeyPassword = "changeit";
         
         FileInputStream publicEncryptionKeyStream = new FileInputStream("recipient_key.asc");        
         
         FileInputStream dataStream = new FileInputStream("c:\\Data\\INPUT.txt");
         FileOutputStream outputStream = new FileOutputStream("encrypted_output.pgp");
         
         // sign and encrypt
         pgp.signAndEncryptStreamVersion3(dataStream,
                                          "INPUT.txt", 
                                          privateKeyStream, 
                                          signKeyPassword,
                                          publicEncryptionKeyStream,
                                          outputStream, 
                                          asciiArmor,
                                          withIntegrityCheck);
     }
 }

Parameters:: dataFileStream - File data input stream, to be signed; internalFileName - File name string to be associated with the data stream in the produced OpenPGP archive.; privateKeyStream - Private Key input stream (used for signing); privateKeyPassword - Private key password; publicKeyStream - Public Key input stream (used for encryption); outputStream - Output Stream signed and encrypted; asciiArmor - if true output is in ASCII armored format, when false output is in binary format
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the private key password is incorrect; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: decryptAndVerifyStream(InputStream, InputStream, String, InputStream, OutputStream)

signAndEncryptStreamVersion3

public void signAndEncryptStreamVersion3(java.io.InputStream dataFileStream,
                                         java.lang.String internalFileName,
                                         java.io.InputStream privateKeyStream,
                                         java.lang.String privateKeyPassword,
                                         java.io.InputStream publicKeyStream,
                                         java.io.OutputStream outputStream,
                                         boolean asciiArmor,
                                         boolean withIntegrityCheck)
                                  throws java.io.IOException,
                                         PGPException,
                                         WrongPasswordException

OpenPGP signs and encrypts a file in one pass, using OpenPGP version 3 signature format (compatible with older PGP 2.x systems)
(Note that this is not the same as first encrypt and then sign a file, because in that case a double compression is performed.)
Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import java.io.*;
 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // should output be ASCII or binary
         boolean asciiArmor = false;
         // should integrity check information be added
         boolean withIntegrityCheck = false;
         
         // The signing key is usually our private key
         FileInputStream privateKeyStream = new FileInputStream("private_key.asc");
         String signKeyPassword = "changeit";
         
         FileInputStream publicEncryptionKeyStream = new FileInputStream("recipient_key.asc");        
         
         FileInputStream dataStream = new FileInputStream("c:\\Data\\INPUT.txt");
         FileOutputStream outputStream = new FileOutputStream("encrypted_output.pgp");
         
         // sign and encrypt
         pgp.signAndEncryptStreamVersion3(dataStream,
                                          "INPUT.txt", 
                                          privateKeyStream, 
                                          signKeyPassword,
                                          publicEncryptionKeyStream,
                                          outputStream, 
                                          asciiArmor,
                                          withIntegrityCheck);
     }
 }

Parameters:: dataFileStream - File data input stream, to be signed; internalFileName - File name string to be associated with the data stream in the produced OpenPGP archive.; privateKeyStream - Private Key input stream (used for signing); privateKeyPassword - Private key password; publicKeyStream - Public Key input stream (used for encryption); outputStream - Output Stream signed and encrypted; asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - Should integrity check be added to the file. When producing data to be used by old systems (e.g. PGP 2.x) it is better to be false.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the private key password is incorrect. Extends PGPException; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException; PGPException
See Also:: decryptAndVerifyStream(InputStream, InputStream, String, InputStream, OutputStream)

signAndEncryptString

public java.lang.String signAndEncryptString(java.lang.String stringToEncrypt,
                                             java.lang.String privateKeyFileName,
                                             java.lang.String privateKeyPassword,
                                             java.lang.String publicKeyFileName)
                                      throws PGPException,
                                             java.io.IOException

OpenPGP signs and encrypts a String message in one pass
The input String is assumed to be UTF-8 encoded.

Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptString {
     public static void main(String[] args) throws Exception {
     
         String stringToEncrypt = "the quick brown fox jumps"; 
     
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // The signing key is usually our private key
         String privateKeyFile "c:\\my_private_key.asc";
         String privateKeyPassword = "password";
         
         String publicEncryptionKeyFile = "c:\\recipient_public_key.asc";        
         
         // sign and encrypt
         String signedAndEncryptedString = 
              pgp.signAndEncryptString(stringToEncrypt,
                                       privateKeyFile, 
                                       privateKeyPassword, 
                                       publicEncryptionKeyFile);
     }
 }

Parameters:: stringToEncrypt - String message to be signed and encrypted in one pass; privateKeyFileName - Private Key (used for signing); privateKeyPassword - Private key password; (used - for signing) Public Key (used for encryption)
Returns:: signed and encrypted message
Throws:: java.io.IOException - If a file/stream operation throws an exception; PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the private key password is incorrect. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException
See Also:: decryptAndVerifyStream(InputStream, InputStream, String, InputStream, OutputStream)

signAndEncryptStringVersion3

public java.lang.String signAndEncryptStringVersion3(java.lang.String stringToEncrypt,
                                                     java.lang.String privateKeyFileName,
                                                     java.lang.String privateKeyPassword,
                                                     java.lang.String publicKeyFileName)
                                              throws PGPException,
                                                     java.io.IOException

OpenPGP signs and encrypts a String message in one pass with OpenPGP version 3 signatures
The input String is assumed to be UTF-8 encoded.

Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptStringV3 {
     public static void main(String[] args) throws Exception {
     
         String stringToEncrypt = "the quick brown fox jumps"; 
     
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // The signing key is usually our private key
         String privateKeyFile "c:\\my_private_key.asc";
         String privateKeyPassword = "password";
         
         String publicEncryptionKeyFile = "c:\\recipient_public_key.asc";        
         
         // sign and encrypt
         String signedAndEncryptedString = 
              pgp.signAndEncryptStringVersion3(stringToEncrypt,
                                       privateKeyFile, 
                                       privateKeyPassword, 
                                       publicEncryptionKeyFile);
     }
 }

Parameters:: stringToEncrypt - String message to be signed and encrypted in one pass; privateKeyFileName - Private Key (used for signing); privateKeyPassword - Private key password; (used - for signing) Public Key (used for encryption)
Returns:: signed and encrypted message
Throws:: java.io.IOException - If a file/stream operation throws an exception; PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the private key password is incorrect. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException
See Also:: decryptAndVerifyStream(InputStream, InputStream, String, InputStream, OutputStream)

signAndEncryptString

public java.lang.String signAndEncryptString(java.lang.String stringToEncrypt,
                                             java.lang.String privateKeyFileName,
                                             java.lang.String privateKeyPassword,
                                             java.lang.String publicKeyFileName,
                                             java.lang.String charsetName)
                                      throws PGPException,
                                             java.io.IOException

OpenPGP signs and encrypts a String message in one pass
Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptString {
     public static void main(String[] args) throws Exception {
     
         String stringToEncrypt = "the quick brown fox jumps"; 
     
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // The signing key is usually our private key
         String privateKeyFile "c:\\my_private_key.asc";
         String privateKeyPassword = "password";
         
         String publicEncryptionKeyFile = "c:\\recipient_public_key.asc";        
         
         String charsetCode = "UTF-8";
         
         // sign and encrypt
         String signedAndEncryptedString = 
              pgp.signAndEncryptString(stringToEncrypt,
                                       privateKeyFile, 
                                       privateKeyPassword, 
                                       publicEncryptionKeyFile,
                                       charsetCode);
     }
 }

Parameters:: stringToEncrypt - String message to be signed and encrypted in one pass; privateKeyFileName - Private Key (used for signing); privateKeyPassword - Private key password; publicKeyFileName - Public Key (used for encryption); charsetName - the name of a supported charset
Returns:: signed and encrypted message
Throws:: java.io.IOException - If a file/stream operation throws an exception; PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the private key password is incorrect. Extends PGPException; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException

signAndEncryptStringVersion3

public java.lang.String signAndEncryptStringVersion3(java.lang.String stringToEncrypt,
                                                     java.lang.String privateKeyFileName,
                                                     java.lang.String privateKeyPassword,
                                                     java.lang.String publicKeyFileName,
                                                     java.lang.String charsetName)
                                              throws PGPException,
                                                     java.io.IOException

OpenPGP signs and encrypts a String message in one pass creating OpenPGP version 3 signatures
Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
Hashing algorithm used is the one specified with setHash(String)

Example:

 import com.didisoft.pgp.PGPLib;
 
 public class SignAndEncryptStringV3 {
     public static void main(String[] args) throws Exception {
     
         String stringToEncrypt = "the quick brown fox jumps"; 
     
         // create an instance of the library
         PGPLib pgp = new PGPLib();
              
         // The signing key is usually our private key
         String privateKeyFile "c:\\my_private_key.asc";
         String privateKeyPassword = "password";
         
         String publicEncryptionKeyFile = "c:\\recipient_public_key.asc";        
         
         String charsetCode = "UTF-8";
         
         // sign and encrypt
         String signedAndEncryptedString = 
              pgp.signAndEncryptStringVersion3(stringToEncrypt,
                                       privateKeyFile, 
                                       privateKeyPassword, 
                                       publicEncryptionKeyFile,
                                       charsetCode);
     }
 }

Parameters:: stringToEncrypt - String message to be signed and encrypted in one pass; privateKeyFileName - Private Key (used for signing); privateKeyPassword - Private key password; publicKeyFileName - Public Key (used for encryption); charsetName - the name of a supported charset
Returns:: signed and encrypted message
Throws:: java.io.IOException - If a file/stream operation throws an exception; PGPException - OpenPGP encryption error; NoPrivateKeyFoundException - If privateKeyFileName does not contain an OpenPGP private key. Extends PGPException; NoPublicKeyFoundException - If publicKeyFileName does not contain an OpenPGP public key. Extends PGPException; WrongPasswordException - If the private key password is incorrect. Extends PGPException; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; KeyIsExpiredException - If the public (encryption) or private (signing) key is expired. Extends PGPException; KeyIsRevokedException - If the public (encryption) or private (signing) key is revoked. Extends PGPException

decryptStream

public java.lang.String decryptStream(java.io.InputStream encryptedStream,
                                      java.io.InputStream privateKeyStream,
                                      java.lang.String privateKeyPassword,
                                      java.io.OutputStream outputStream)
                               throws PGPException,
                                      java.io.IOException

Decrypts an OpenPGP encrypted stream using Private key input stream.

Parameters:: encryptedStream - Input stream to be decrypted; privateKeyStream - Private key input stream; privateKeyPassword - Private key password; outputStream - Output stream for the decrypted contents
Returns:: Original File Name stored in the OpenPGP Archive
Throws:: java.io.IOException - if a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the input stream was not encrypted with this private key. Extends PGPException; WrongPasswordException - if the password for this private key is misspelled. Extends PGPException; NonPGPDataException - if the input data is not a valid OpenPGP encrypted message; PGPException
See Also:: encryptStream(InputStream, String, InputStream, OutputStream, boolean, boolean)

decryptStreamTo

public java.lang.String[] decryptStreamTo(java.io.InputStream encryptedStream,
                                          java.io.InputStream privateKeyStream,
                                          java.lang.String privateKeyPassword,
                                          java.lang.String outputFolder)
                                   throws PGPException,
                                          java.io.IOException

Decrypts an OpenPGP encrypted stream to a specified folder. This method supports multiple file PGP archives (created with PGP Desktop 9+ and compatible software)

Parameters:: encryptedStream - Input stream to be decrypted; privateKeyStream - Private key input stream; privateKeyPassword - Private key password; outputFolder - Output folder where the decrypted file(s) will be stored
Returns:: Array of absolute paths of the decrypted file(s).
Throws:: java.io.IOException - if a file/stream operation throws an exception java.io.FileNotFoundException if the input file or the output folder does not exist; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file, or verifying signed content.; WrongPrivateKeyException - if the input stream was not encrypted with this private key. Extends PGPException; WrongPasswordException - if the password for this private key is misspelled. Extends PGPException; NonPGPDataException - if the input data is not a valid OpenPGP encrypted message; PGPException
See Also:: encryptFiles(String[], String[], String, boolean, boolean)

decryptStreamTo

public java.lang.String[] decryptStreamTo(java.io.InputStream encryptedStream,
                                          KeyStore keyStore,
                                          java.lang.String privateKeyPassword,
                                          java.lang.String outputFolder)
                                   throws PGPException,
                                          java.io.IOException

Decrypts an OpenPGP encrypted stream to a specified folder. This method supports multiple file PGP archives (created with PGP Desktop 9+ and compatible software)

Parameters:: encryptedStream - Input stream to be decrypted; keyStore - KeyStore containing the decryption private key; privateKeyPassword - Private key password; outputFolder - Output folder where the decrypted file(s) will be stored
Returns:: Array of absolute paths of the decrypted file(s).
Throws:: java.io.IOException - if a file/stream operation throws an exception java.io.FileNotFoundException if the input file or the output folder does not exist; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file, or verifying signed content.; WrongPrivateKeyException - if the input stream was not encrypted with this private key. Extends PGPException; WrongPasswordException - if the password for this private key is misspelled. Extends PGPException; NonPGPDataException - if the input data is not a valid OpenPGP encrypted message; PGPException
See Also:: encryptFiles(String[], KeyStore, String[], String, boolean, boolean), encryptFiles(String[], KeyStore, long[], String, boolean, boolean)

decryptStream

public java.lang.String decryptStream(java.io.InputStream encryptedStream,
                                      KeyStore pgpKeyStore,
                                      java.lang.String privateKeyPassword,
                                      java.io.OutputStream outputStream)
                               throws PGPException,
                                      java.io.IOException

Decrypts an OpenPGP encrypted stream using Private key input stream.

Parameters:: encryptedStream - Input Stream to be decrypted; pgpKeyStore - Instance of KeyStore, that should contain the Private key to decrypt encryptedStream; privateKeyPassword - Private key password; outputStream - Output Stream for the decrypted contents
Returns:: File name of the decrypted file. null if an error has occurred.
Throws:: PGPException - if a problem has occurred while decrypting file, or verifying signed content.; java.io.IOException - If a file/stream operation throws an exception; java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; WrongPrivateKeyException - if the input stream was not encrypted with this private key. Extends PGPException; WrongPasswordException - if the password for this private key is misspelled. Extends PGPException
See Also:: encryptStream(InputStream, String, KeyStore, String, OutputStream, boolean, boolean), encryptStream(InputStream, String, KeyStore, long, OutputStream, boolean, boolean)

decryptFile

public java.lang.String decryptFile(java.lang.String encryptedFileName,
                                    KeyStore pgpKeyStore,
                                    java.lang.String privateKeyPassword,
                                    java.lang.String outputFileName)
                             throws PGPException,
                                    java.io.IOException

Decrypts an OpenPGP encrypted file using key from a OpenPGP key store.

Parameters:: encryptedFileName - File name to be decrypted (absolute or relative path); pgpKeyStore - Key store object. See KeyStore; privateKeyPassword - Private key password; outputFileName - File name of the Output decrypted file (absolute or relative path)
Returns:: The original file name of the encrypted data in this OpenPGP archive
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; WrongPrivateKeyException - if the file was not encrypted with this private key. Extends PGPException; WrongPasswordException - if the password for this private key is misspelled. Extends PGPException; NonPGPDataException - if the input file is not a valid OpenPGP encrypted file; PGPException
See Also:: encryptFile(String, KeyStore, String, String), encryptFile(String, KeyStore, long, String)

decryptFile

public java.lang.String decryptFile(java.lang.String encryptedFileName,
                                    java.lang.String privateKeyFileName,
                                    java.lang.String privateKeyPassword,
                                    java.lang.String outputFileName)
                             throws PGPException,
                                    java.io.IOException

Decrypts an OpenPGP encrypted file using Private key file.

Example:

 import com.didisoft.pgp.*;
 
 public class DecryptFile {
     public static void main(String[] args) throws Exception{
         // initialize the library instance
         PGPLib pgp = new PGPLib();
         
         String privateKeyFile = "private.key";
         String privateKeyPass = "changeit";
 
         // The decrypt method returns the original name of the file
         // that was encrypted. We can use it afterwards,
         // to rename OUTPUT.txt      
         String originalFileName = pgp.decryptFile("encrypted.pgp", 
                                                 privateKeyFile, 
                                                 privateKeyPass, 
                                                 "OUTPUT.txt");
     }

Parameters:: encryptedFileName - File name to be decrypted (absolute or relative path); privateKeyFileName - Private Key file name (absolute or relative path); privateKeyPassword - Private key password; outputFileName - File name of the Output decrypted file (absolute or relative path).
Returns:: File name of the decrypted file. null if an error has occurred.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the file was not encrypted with this private key. Extends PGPException; WrongPasswordException - if the password for this private key is misspelled. Extends PGPException; NonPGPDataException - if the input file is not a valid OpenPGP encrypted file; PGPException
See Also:: encryptFile(String, String, String, boolean, boolean)

decryptFilePBE

public java.lang.String decryptFilePBE(java.lang.String encryptedFileName,
                                       java.lang.String decryptionPassword,
                                       java.lang.String outputFileName)
                                throws PGPException,
                                       java.io.IOException

Decrypts an OpenPGP file that was encrypted with password (PBE, symmetric key encrypted).

Example:

 import com.didisoft.pgp.*;
 
 public class DecryptFilePBE {
     public static void main(String[] args) throws Exception{
         // initialize the library instance
         PGPLib pgp = new PGPLib();
         
         // The decrypt method returns the original name of the file
         // that was encrypted. We can use it afterwards,
         // to rename OUTPUT.txt      
         String originalFileName = pgp.decryptFile("encrypted.pgp", 
                                                 "decryption password", 
                                                 "OUTPUT.txt");
     }
 }

Parameters:: encryptedFileName - File name to be decrypted (absolute or relative path); decryptionPassword - Password used for symmetric encryption of the input file; outputFileName - File name of the Output decrypted file (absolute or relative path).
Returns:: File name of the decrypted file. null if an error has occurred.
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPasswordException - if the password for this private key is misspelled. Extends PGPException; NonPGPDataException - if the input file is not a valid OpenPGP encrypted file; PGPException
See Also:: encryptFilePBE(String, String, String, String, boolean, boolean)

decryptFileTo

public java.lang.String[] decryptFileTo(java.lang.String encryptedFileName,
                                        java.lang.String privateKeyFileName,
                                        java.lang.String privateKeyPassword,
                                        java.lang.String outputFolder)
                                 throws PGPException,
                                        java.io.IOException

Decrypts the content of an OpenPGP encrypted file into a folder.

Example usage:

 import com.didisoft.pgp.*;
 
 public class DecryptFileTo {
     public static void main(String[] args) throws Exception{
         // initialize the library instance
         PGPLib pgp = new PGPLib();
         
         String privateKeyFile = "private.key";
         String privateKeyPass = "changeit";
 
         // The decrypt method returns array with decrypted file paths
         String[] files = pgp.decryptFileTo("encrypted.pgp", 
                                           privateKeyFile, 
                                           privateKeyPass, 
                                           "c:\\Temp\\");
                                                 
         for (int i=0; i


Parameters:
encryptedFileName - File name to be decrypted (absolute or relative path)
privateKeyFileName - Private Key file name (absolute or relative path)
privateKeyPassword - Private key password
outputFolder - Folder path (absolute or relative path) where the decrypted file(s) will be stored
Returns:
Array of file paths of the decrypted file(s)
Throws:
java.io.IOException - if a file/stream operation throws an exception
 java.io.FileNotFoundException      if the input file or the output folder does not exist
org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file
WrongPrivateKeyException - if the file was not encrypted with this private key
WrongPasswordException - if the password for this private key is misspelled
NonPGPDataException - if the input file is not a valid OpenPGP encrypted file
PGPException
See Also:
encryptFiles(String[], String[], String, boolean, boolean)

decryptFileTo

public java.lang.String[] decryptFileTo(java.lang.String encryptedFileName,
                                        KeyStore keyStore,
                                        java.lang.String privateKeyPassword,
                                        java.lang.String outputFolder)
                                 throws PGPException,
                                        java.io.IOException

Decrypts the content of an OpenPGP encrypted file into a folder.

Example usage:

 import com.didisoft.pgp.*;
 
 public class DecryptFileTo {
     public static void main(String[] args) throws Exception{
         // initialize the library instance
         PGPLib pgp = new PGPLib();
         
         KeyStore keyStore = new KeyStore("my.keystore", "keystore pasword");
         String privateKeyPass = "changeit";
 
         // The decrypt method returns array with decrypted file paths
         String[] files = pgp.decryptFileTo("encrypted.pgp", 
                                           keyStore, 
                                           privateKeyPass, 
                                           "c:\\Temp\\");
                                                 
         for (int i=0; i


Parameters:
encryptedFileName - File name to be decrypted (absolute or relative path)
keyStore - KeyStore object containing the private decryption key
privateKeyPassword - Private key password
outputFolder - Folder path (absolute or relative path) where the decrypted file(s) will be stored
Returns:
Array of file paths of the decrypted file(s)
Throws:
java.io.IOException - if a file/stream operation throws an exception
java.io.FileNotFoundException - if the input file or the output folder does not exist
org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file
WrongPrivateKeyException - if the file was not encrypted with this private key
WrongPasswordException - if the password for this private key is misspelled
NonPGPDataException - if the input file is not a valid OpenPGP encrypted file
PGPException
See Also:
encryptFiles(String[], KeyStore, String[], String, boolean, boolean)

decryptFile

public java.lang.String decryptFile(java.lang.String encryptedFileName,
                                    java.io.InputStream privateKeyStream,
                                    java.lang.String privateKeyPassword,
                                    java.lang.String outputFileName)
                             throws PGPException,
                                    java.io.IOException

Decrypts an OpenPGP encrypted file using Private key input stream.

Parameters:: encryptedFileName - File name to be decrypted (absolute or relative path); privateKeyStream - Private Key input stream; privateKeyPassword - Private key password; outputFileName - File name of the Output decrypted file (absolute or relative path).
Returns:: File name of the decrypted file.
Throws:: java.io.IOException - if a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting; WrongPrivateKeyException - if the file was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled; NonPGPDataException - if the input file is not a valid OpenPGP encrypted file; PGPException
See Also:: encryptFile(String, String, String, boolean, boolean)

encryptStream

public void encryptStream(java.io.InputStream dataStream,
                          java.lang.String fileName,
                          long streamLength,
                          java.lang.String publicKeyFileName,
                          java.io.OutputStream out,
                          boolean asciiArmor)
                   throws PGPException

OpenPGP encrypts stream using the first available public key from a key ring file.

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

Parameters:: dataStream - Input Stream to be encrypted; fileName - File Name string to be stored in the OpenPGP file (OpenPGP archive stores information for the file name being encrypted); streamLength - Length of stream to be encrypted; publicKeyFileName - Key ring file name (absolute or relative path); out - Output Stream OpenPGP encrypted; asciiArmor - if true output is in ASCII armored format, when false output is in binary format
Throws:: PGPException - if an error has occurred
Since:: 2.5.6
See Also:: decryptStream(InputStream, InputStream, String, OutputStream)

encryptStream

public void encryptStream(java.io.InputStream dataStream,
                          java.lang.String fileName,
                          long streamLength,
                          java.lang.String publicKeyFileName,
                          java.io.OutputStream out,
                          boolean asciiArmor,
                          boolean withIntegrityCheck)
                   throws PGPException

Parameters:: dataStream - Input Stream to be encrypted; fileName - File Name string to be stored in the OpenPGP file (OpenPGP archive stores information for the file name being encrypted); streamLength - Length of stream to be encrypted; publicKeyFileName - Key ring file name (absolute or relative path); out - Output Stream OpenPGP encrypted; asciiArmor - if true output is in ASCII armored format, when false output is in binary format; withIntegrityCheck - Should integrity check be added to the file.
Throws:: PGPException - if an error has occurred
See Also:: decryptStream(InputStream, InputStream, String, OutputStream)

encryptStream

public void encryptStream(java.io.InputStream dataStream,
                          java.lang.String fileName,
                          KeyStore keyStore,
                          java.lang.String userId,
                          java.io.OutputStream out,
                          boolean asciiArmor,
                          boolean withIntegrityCheck)
                   throws PGPException,
                          java.io.IOException

OpenPGP Encrypts Input Stream using a Public key located in a KeyStore

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

Parameters:: dataStream - Input Stream to be encrypted; fileName - File Name string to be stored in the OpenPGP file (OpenPGP archive stores information for the file name being encrypted); keyStore - Key store object. See KeyStore; userId - User ID of the form "name (comment) <email address>" (can be seen using KeyStore.listKeys()); out - Output Stream OpenPGP encrypted; asciiArmor - if true output is in ASCII armored format, when false output is in binary format. For large files it is recomended to be false (binary format); withIntegrityCheck - Should integrity check be added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - if an error has occurred; java.io.IOException - if an error occures reading dataStream; NoPublicKeyFoundException - if there is no public key with the specified User Id in the specidfied KeyStore; PGPException
See Also:: decryptStream(InputStream, KeyStore, String, OutputStream)

encryptStream

public void encryptStream(java.io.InputStream dataStream,
                          java.lang.String fileName,
                          KeyStore keyStore,
                          long keyId,
                          java.io.OutputStream out,
                          boolean asciiArmor,
                          boolean withIntegrityCheck)
                   throws PGPException,
                          java.io.IOException

OpenPGP encrypts input stream using a recipient public key located in a KeyStore

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

Parameters:: dataStream - Input Stream to be encrypted; fileName - File Name string to be stored in the OpenPGP file (OpenPGP archive stores information for the file name being encrypted); keyStore - Key store object. See KeyStore; keyId - Key Id of the Public Key; out - Output Stream OpenPGP encrypted; asciiArmor - Should file be in Armored mode; withIntegrityCheck - Should integrity check be added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - if an error has occurred; java.io.IOException - if an error occurs reading dataStream; PGPException

encryptStream

public void encryptStream(java.io.InputStream dataStream,
                          java.lang.String fileName,
                          long streamLength,
                          java.io.InputStream publicKeyStream,
                          java.io.OutputStream out,
                          boolean asciiArmor,
                          boolean withIntegrityCheck)
                   throws PGPException

OpenPGP encrypts an input stream using the first available public key supplied as an input stream

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

Parameters:: dataStream - Input Stream to be encrypted; fileName - File Name string to be stored in the OpenPGP file (OpenPGP archive stores information for the file name being encrypted); streamLength - Length of stream to be encrypted; publicKeyStream - Input stream from the Public key; out - Output Stream OpenPGP encrypted; asciiArmor - Should file be in Armored mode; withIntegrityCheck - Should integrity check be added to the file.
Throws:: PGPException - if an error has occurred; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException

encryptStream

public void encryptStream(java.io.InputStream dataStream,
                          java.lang.String fileName,
                          java.io.InputStream publicKeyStream,
                          java.io.OutputStream out,
                          boolean asciiArmor,
                          boolean withIntegrityCheck)
                   throws PGPException,
                          java.io.IOException

OpenPGP Encrypts Input Stream using the first available Public key from a Key ring input stream

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

Parameters:: dataStream - Input Stream to be encrypted; fileName - File Name string to be stored in the OpenPGP file (OpenPGP archive stores information for the file name being encrypted); publicKeyStream - Input stream from the Public key; out - Output Stream OpenPGP encrypted; asciiArmor - If true, output is in ASCII armored mode, when false in binary. For large files it is recomended to be false (binary format); withIntegrityCheck - Should integrity check be added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - if an error has occurred; java.io.IOException - if an error occurs reading dataStream; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptStreamPBE

public void encryptStreamPBE(java.io.InputStream dataStream,
                             java.lang.String fileNameLabel,
                             java.lang.String password,
                             java.io.OutputStream out,
                             boolean asciiArmor,
                             boolean withIntegrityCheck)
                      throws PGPException,
                             java.io.IOException

Encrypts an input stream with a password based OpenPGP encryption (PBE)

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

The example below illustrates the usage of this method:

 import java.io.FileInputStream;
 import java.io.FileOutputStream;
 import java.io.InputStream;
 import java.io.OutputStream;
 import com.didisoft.pgp.PGPLib;
 
 public class EncryptStreamPBE {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
 
         // is output ASCII or binary
         boolean asciiArmor = true;
         // should integrity check information be added
         // set to false for compatibility with older versions of PGP such as 6.5.8.
         boolean withIntegrityCheck = true;
 
         // obtain the streams
         InputStream inStream = new FileInputStream("DataFiles/INPUT.txt");
         OutputStream outStream = new FileOutputStream("DataFiles/PBEencrypted.pgp");
 
         // Here "INPUT.txt" is just a label to be associated with the data OpenPGP packet
         // The data packet is a mandatory component of the pgp file internals and holds:
         // file name label, timestamp, and the encrypted data
         pgp.encryptStreamPBE(inStream, "INPUT.txt", "encryption password", outStream, asciiArmor, withIntegrityCheck);
     }
 }

Parameters:: dataStream - Input Stream to be encrypted; fileNameLabel - File Name label to be stored in the OpenPGP file (OpenPGP archive stores information for the file name being encrypted); out - Output stream where the encrypted content will be stored; asciiArmor - If true, output is in ASCII armored mode, when false in binary. For large files it is recomended to be false (binary format); withIntegrityCheck - Should integrity check be added to the file.
Throws:: PGPException - PGP encryption error; java.io.IOException - if an error occurs reading dataStream

encryptFilePBE

public void encryptFilePBE(java.lang.String dataFileName,
                           java.lang.String publicKeyFileName,
                           java.lang.String alternativePassword,
                           java.lang.String outputFileName,
                           boolean asciiArmor,
                           boolean withIntegrityCheck)
                    throws PGPException,
                           java.io.FileNotFoundException

Encrypts a file with a public key and a passphrase.
The passphrase can be used to decrypt the file if the corressponding private key is lost.

Equivalent GnuPG command:
gpg -r [public key user id] -c -e [dataFileName]

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); publicKeyFileName - Key ring file name (absolute or relative path); alternativePassword - Additional passphrase that can be used to decrypt the file instead of using the private key; outputFileName - File name of the Output encrypted file (absolute or relative path); asciiArmor - If true, output is in ASCII armored mode, when false in binary. For large files it is recomended to be false (binary format); withIntegrityCheck - Should integrity check be added to the file.
Throws:: PGPException - OpenPGP encryption error; java.io.FileNotFoundException - if dataFileName does not exist; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException

encryptFilePBE

public void encryptFilePBE(java.lang.String dataFileName,
                           java.lang.String password,
                           java.lang.String outputFileName,
                           boolean asciiArmor,
                           boolean withIntegrityCheck)
                    throws PGPException,
                           java.io.FileNotFoundException

Encrypts a file with a passphrase.
The same passphrase is used to decrypt the file

Equivalent GnuPG command:
gpg -c -e [dataFileName]

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

The example below illustrates how the usage of this method:

 import com.didisoft.pgp.*;
 
 public class EncryptFilePBE {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
        
         // if true the output file will be in ASCII armored format,
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         // set to false for compatibility with older versions of PGP such as 6.5.8.
         boolean withIntegrityCheck = false;
                
         pgp.encryptFilePBE("INPUT.txt",
                         "password",
                         "PBEencrypted.pgp",
                         asciiArmor,
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); password - Passphrase used to encrypt and decrypt the file; outputFileName - File name of the Output encrypted file (absolute or relative path); asciiArmor - If true, output is in ASCII armored mode, when false in binary. For large files it is recomended to be false (binary format); withIntegrityCheck - Should integrity check be added to the file.
Throws:: PGPException - OpenPGP encryption error; java.io.FileNotFoundException - if dataFileName does not exist

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        java.lang.String publicKeyFileName,
                        java.lang.String outputFileName,
                        boolean asciiArmor)
                 throws PGPException,
                        java.io.IOException

OpenPGP encrypts given file using the public key of the recipient.

Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)

Example usage:

 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise in binary format
         boolean asciiArmor = true;
                 
         pgp.encryptFile("INPUT.txt", 
                         "recipient_key.asc", 
                         "encrypted.pgp", 
                         asciiArmor);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); publicKeyFileName - Recipient public key file name (absolute or relative path); outputFileName - File name of the output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format. For large files it is recomended to be false (binary format)
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; java.io.IOException - I/O error; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException
Since:: 2.5.6

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        java.lang.String publicKeyFileName,
                        java.lang.String outputFileName,
                        boolean asciiArmor,
                        boolean withIntegrityCheck)
                 throws PGPException

 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         // set to false for compatibility with older versions of PGP such as 6.5.8.
         boolean withIntegrityCheck = true;
                 
         pgp.encryptFile("INPUT.txt", 
                         "recipient_key.asc", 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); publicKeyFileName - Recipient public key file name (absolute or relative path); outputFileName - File name of the output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format. For large files it is recomended to be false (binary format); withIntegrityCheck - if true additional integrity check is added to the file. Set to false for compatibility with older versions of PGP such as 6.5.8.
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        java.lang.String[] publicKeysFileNames,
                        java.lang.String outputFileName,
                        boolean asciiArmor,
                        boolean withIntegrityCheck)
                 throws PGPException

OpenPGP encrypts a file for multiple recipients.

Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)

Example usage:

 import com.didisoft.pgp.*;
 
 public class EncryptFileForMultipleRecipients {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         // set to false for compatibility with older versions of PGP such as 6.5.8.
         boolean withIntegrityCheck = true;

         String[] recipientsPublicKeys = {"public_key1.asc", 
                                       "public_key2.asc",
                                       "public_key3.asc"};        
                 
         pgp.encryptFile("INPUT.txt", 
                         recipientsPublicKeys, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); publicKeysFileNames - Array of recipients' public keys file names (absolute or relative paths); outputFileName - File name of the output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format.; withIntegrityCheck - if true additional integrity check is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        KeyStore keyStore,
                        java.lang.String[] recipientsUserIds,
                        java.lang.String outputFileName,
                        boolean asciiArmor,
                        boolean withIntegrityCheck)
                 throws PGPException

 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         // set to false for compatibility with older versions of PGP such as 6.5.8.
         boolean withIntegrityCheck = true;

         // initialize the KeyStore  
         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  

         String[] recipientsUserIds = {"recipient1@company.com", 
                                       "John Doe",
                                       "Clearing House"};        
                 
         pgp.encryptFile("INPUT.txt", 
                         keyStore,
                         recipientsUserIds, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - KeyStore holding recipients' public keys; recipientsUserIds - Array of recipients' public keys User Id's; outputFileName - File name of the output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format.; withIntegrityCheck - if true additional integrity check is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        KeyStore keyStore,
                        long[] recipientsKeyIds,
                        java.lang.String outputFileName,
                        boolean asciiArmor,
                        boolean withIntegrityCheck)
                 throws PGPException

 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         // set to false for compatibility with older versions of PGP such as 6.5.8.
         boolean withIntegrityCheck = true;

         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  

         long[] recipientsKeyIds = {15432123891819, 
                                    keyStore.getKeyIdForUserId("Company ACM"),
                                    keyStore.getKeyIdForKeyIdHex("79AEAE03")};        
                 
         pgp.encryptFile("INPUT.txt", 
                         keyStore,
                         recipientsKeyIds, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - KeyStore holding recipients' public keys; recipientsKeyIds - Array of recipients' public keys Key Id's; outputFileName - File name of the output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format.; withIntegrityCheck - if true additional integrity check is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptFiles

public void encryptFiles(java.lang.String[] dataFileNames,
                         java.lang.String[] publicKeysFileNames,
                         java.lang.String outputFileName,
                         boolean asciiArmor,
                         boolean withIntegrityCheck)
                  throws PGPException

OpenPGP encrypts multiple files into one OpenPGP archive.

Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)

Example usage:

 import com.didisoft.pgp.*;
 
 public class EncryptFilesDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         // set to false for compatibility with older versions of PGP such as 6.5.8.
         boolean withIntegrityCheck = true;

         String[] inputFiles = {"INPUT1.txt", 
                                "INPUT2.txt",
                                "INPUT3.txt"};        

         String[] recipientsPublicKeys = {"public_key1.asc", 
                                       "public_key2.asc",
                                       "public_key3.asc"};        
                 
                 
         pgp.encryptFiles(inputFiles, 
                         recipientsPublicKeys, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileNames - File names to be encrypted (absolute or relative path); publicKeysFileNames - Array of recipients' public keys file names (absolute or relative path); outputFileName - File name of the output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format.; withIntegrityCheck - if true additional integrity check is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - if an error has occurred; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptFiles

public void encryptFiles(java.lang.String[] dataFileNames,
                         KeyStore keyStore,
                         java.lang.String[] recipientsUserIds,
                         java.lang.String outputFileName,
                         boolean asciiArmor,
                         boolean withIntegrityCheck)
                  throws PGPException

OpenPGP encrypts multiple files into one OpenPGP archive

Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)

Example:

 import com.didisoft.pgp.*;
 
 public class EncryptFilesDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         boolean withIntegrityCheck = true;

         String[] inputFiles = {"INPUT1.txt", 
                                "INPUT2.txt",
                                "INPUT3.txt"};        

         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  

         String[] recipientsUserIds = {"recipient1@company.com", 
                                       "John Doe",
                                       "Clearing House"};        
                 
         pgp.encryptFiles(inputFiles, 
                         keyStore,  
                         recipientsUserIds, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileNames - File names to be encrypted (absolute or relative path); keyStore - KeyStore containing the recipients public keys; recipientsUserIds - Array of recipients' public keys User Id's; outputFileName - File name of the output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format.; withIntegrityCheck - if true additional integrity check is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - if an error has occurred; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptFiles

public void encryptFiles(java.lang.String[] dataFileNames,
                         KeyStore keyStore,
                         long[] recipientsKeyIds,
                         java.lang.String outputFileName,
                         boolean asciiArmor,
                         boolean withIntegrityCheck)
                  throws PGPException

 import com.didisoft.pgp.*;
 
 public class EncryptFilesDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         boolean withIntegrityCheck = true;

         String[] inputFiles = {"INPUT1.txt", 
                                "INPUT2.txt",
                                "INPUT3.txt"};        

         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  

         long[] recipientsKeyIds = {15432123891819, 
                                    keyStore.getKeyIdForUserId("Company ACM"),
                                    keyStore.getKeyIdForKeyIdHex("79AEAE03")};        
                 
         pgp.encryptFiles(inputFiles, 
                         keyStore,  
                         recipientsUserIds, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileNames - File names to be encrypted (absolute or relative path); keyStore - KeyStore containing the recipients public keys; recipientsKeyIds - Array of recipients' public keys Key Id's; outputFileName - File name of the output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format.; withIntegrityCheck - if true additional integrity check is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - if an error has occurred; java.lang.IllegalArgumentException - if the input files array is empty; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        java.io.InputStream publicKeyStream,
                        java.lang.String outputFileName,
                        boolean asciiArmor,
                        boolean withIntegrityCheck)
                 throws PGPException

OpenPGP encrypts given file using the first available public key from a key ring input stream

Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         boolean withIntegrityCheck = true;
         
         FileInputStream keyStream = null;
         try {        
           keyStream = new FileInputStream("recipient_key.asc");        
           pgp.encryptFile("INPUT.txt", 
                         keyStream, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
        } finally {
           if (keyStream != null)
               keyStream.close();
        }                 
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); publicKeyStream - Input stream from the Public key, caller method is responsible for closing it; outputFileName - File name of the Output encrypted file (absolute or relative path); asciiArmor - if true output is in ASCII armored format, otherwise is in binary format. For large files it is recomended to be false (binary format); withIntegrityCheck - if true integrity check information is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - if an error has occurred; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException

encryptFileByUserId

public int encryptFileByUserId(KeyStore keyStore,
                               java.lang.String dataFileName,
                               java.lang.String userID,
                               java.lang.String outputFileName)

Deprecated. Use instead

OpenPGP encrypts given file using specified public key, stored in specified OpenPGP key store.

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store object. See KeyStore; userID - User ID of the form "name (comment) <email address>" (can be seen using KeyStore.listKeys()); outputFileName - File name of the Output encrypted file (absolute or relative path)
Returns:: 0 if successfully encrypted, 1 if an error has occurred

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        KeyStore keyStore,
                        java.lang.String userId,
                        java.lang.String outputFileName,
                        boolean asciiArmor,
                        boolean withIntegrityCheck)
                 throws PGPException

OpenPGP encrypts given file using specified public key, stored in specified OpenPGP key store.

Compression algorithm used is the one specified with setCompression(String) if supported by the public key, otherwise the first supported by the key algorithm is used.
Symmetric cipher algorithm used is the one specified with setCypher(String) if supported by the public key, otherwise the first supported by the key algorithm is used.

Example:

 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         boolean withIntegrityCheck = true;

         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  

         String recipientUserId = "recipient@company.com"; 
                 
         pgp.encryptFile("INPUT.txt", 
                         keyStore,
                         recipientUserId, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store object. See KeyStore; userId - Recipient public key User Id of the form "name (comment) <email address>"; outputFileName - File name of the Output encrypted file (absolute or relative path); asciiArmor - if true the output file will be in ASCII format, if false the output file will be in binary format; withIntegrityCheck - if true integrity check information is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; PGPException
See Also:: decryptFile(String, KeyStore, String, String)

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        KeyStore keyStore,
                        java.lang.String userId,
                        java.lang.String outputFileName)
                 throws PGPException

 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         // initialize the KeyStore
         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  

         String recipientUserId = "recipient@company.com"; 
                 
         pgp.encryptFile("INPUT.txt", 
                         keyStore,
                         recipientUserId, 
                         "encrypted.pgp");
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store object. See KeyStore; userId - User ID of the form "name (comment) <email address>"; outputFileName - File name of the Output encrypted file (absolute or relative path)
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; PGPException
See Also:: decryptFile(String, KeyStore, String, String)

encryptFileByKeyId

public int encryptFileByKeyId(KeyStore keyStore,
                              java.lang.String dataFileName,
                              java.lang.String keyIdHex,
                              java.lang.String outputFileName)

Deprecated. Use instead

OpenPGP Encrypts given file using specified Public Key, stored in specified OpenPGP key store.

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store object. See KeyStore; keyIdHex - Key Id of the Public Key in Hex format; outputFileName - File name of the Output encrypted file (absolute or relative path)

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        KeyStore keyStore,
                        long keyId,
                        java.lang.String outputFileName,
                        boolean asciiArmor,
                        boolean withIntegrityCheck)
                 throws PGPException

 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // if true the output file will be in ASCII armored format, 
         // otherwise will be in binary format
         boolean asciiArmor = true;
         // if true additional integrity check information is added
         boolean withIntegrityCheck = true;

         // initialize the KeyStore  
         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  

         long recipientKeyId = keyStore.getKeyIdForKeyIdHex("79AEAE03");        
                 
         pgp.encryptFile("INPUT.txt", 
                         keyStore,
                         recipientKeyId, 
                         "encrypted.pgp", 
                         asciiArmor, 
                         withIntegrityCheck);
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store object. See KeyStore; keyId - Key Id of the recipient public key; outputFileName - File name of the encrypted output file (absolute or relative path); asciiArmor - if true the output file will be in ASCII format, if false the output file will be in binary format; withIntegrityCheck - if true integrity check information is added to the file.
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; KeyIsExpiredException - If the public key is expired. Extends PGPException; KeyIsRevokedException - If the public key is revoked. Extends PGPException; PGPException
See Also:: decryptFile(String, KeyStore, String, String)

encryptFile

public void encryptFile(java.lang.String dataFileName,
                        KeyStore keyStore,
                        long keyId,
                        java.lang.String outputFileName)
                 throws PGPException

OpenPGP encrypts given file using specified public key, stored in specified OpenPGP key store.

Compression algorithm used is the one specified with setCompression(String)
Symmetric cipher algorithm used is the one specified with setCypher(String)
The output file is in binary format and with no integrity check information. This format is compatible with PGP 2.6.x.

Example:

 import com.didisoft.pgp.*;
 
 public class EncryptFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // initialize the KeyStore
         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  

         long recipientKeyId = keyStore.getKeyIdForKeyIdHex("79AEAE03");        
                 
         pgp.encryptFile("INPUT.txt", 
                         keyStore,
                         recipientKeyId, 
                         "encrypted.pgp");
     }
 }

Parameters:: dataFileName - File name to be encrypted (absolute or relative path); keyStore - Key store object. See KeyStore; keyId - Key Id of the Public Key; outputFileName - File name of the Output encrypted file (absolute or relative path)
Throws:: org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; PGPException
See Also:: decryptFile(String, String, String, String)

verifyFile

public boolean verifyFile(java.lang.String dataFileName,
                          java.lang.String publicKeyFileName,
                          java.lang.String outputFileName)
                   throws PGPException,
                          FileIsEncryptedException,
                          java.io.IOException

Verifies the incoming file as being correctly signed.

Example:

 import com.didisoft.pgp.*;
 
 public class VerifyFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // verify and extract the signed content
         boolean validSignature = pgp.verifyFile("signed.pgp", "sender_public_key.asc", "OUTPUT.txt");      
         if (validSignature) {
             System.out.println("Signature is valid.");
         } else {
             System.out.println("!Signature is invalid!");
         }
     }
 }

Parameters:: dataFileName - File name to be verified for a valid OpenPGP signature (absolute or relative path); publicKeyFileName - Sender public key file name (absolute or relative path); outputFileName - Output file name, extracted from the signed file (absolute or relative path)
Returns:: true if the file is signed from the sender who owns the specified public key, false if not signed with this public key
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; FileIsEncryptedException - if the input file is not only signed but aslo encrypted; NonPGPDataException - if the input data is not a valid OpenPGP message; PGPException
See Also:: signFile(String, String, String, String, boolean), signFileVersion3(String, String, String, String, boolean)

verifyFile

public boolean verifyFile(java.lang.String dataFileName,
                          KeyStore keyStore,
                          java.lang.String outputFileName)
                   throws PGPException,
                          FileIsEncryptedException,
                          java.io.IOException

Verifies the incoming file as being correctly signed.

Example:

 import com.didisoft.pgp.*;
 
 public class VerifyFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         // initialize the KeyStore
         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");
           
         // verify and extract the signed content
         boolean validSignature = pgp.verifyFile("signed.pgp", keyStore, "OUTPUT.txt");      
         if (validSignature) {
             System.out.println("Signature is valid.");
         } else {
             System.out.println("!Signature is invalid!");
         }
     }
 }

Parameters:: dataFileName - File name to be verified for a valid OpenPGP signature (absolute or relative path); keyStore - KeyStore object containing the sender public key that will be used for verification; outputFileName - Output file name, extracted from the signed file (absolute or relative path)
Returns:: true if the file is signed from a sender with public key in this KeyStore, false if no key in the KeyStore matches the signature
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; FileIsEncryptedException - if the input file is not only signed but aslo encrypted; PGPException
See Also:: signFile(String, KeyStore, String, String, String, boolean)

verifyFile

public boolean verifyFile(java.lang.String dataFileName,
                          java.lang.String publicKeyFileName)
                   throws PGPException,
                          FileIsEncryptedException,
                          java.io.IOException

Verifies the incoming file as being correctly signed.

Example:

 import com.didisoft.pgp.*;
 
 public class VerifyFile {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         // initialize the KeyStore
         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");
           
         // verify and extract the signed content
         boolean validSignature = pgp.verifyFile("signed.pgp", "sender_public_key.asc");      
         if (validSignature) {
             System.out.println("Signature is valid.");
         } else {
             System.out.println("!Signature is invalid!");
         }
     }
 }

Parameters:: dataFileName - File name to be verified for a valid OpenPGP signature (absolute or relative path); publicKeyFileName - Sender public key file name (absolute or relative path)
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; FileIsEncryptedException - If the input file is not only signed but also encrypted; PGPException
See Also:: signFile(String, String, String, String, boolean)

verifyFile

public boolean verifyFile(java.io.InputStream dataFileStream,
                          java.io.InputStream publicKeyStream)
                   throws PGPException,
                          java.io.IOException

Deprecated. Use verifyStream(InputStream, InputStream)

Verifies the incoming in stream as being correctly signed.

Parameters:: dataFileStream - Input stream from the File to be verified; publicKeyStream - Input stream from the Public key
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; PGPException
See Also:: signStream(InputStream, String, InputStream, String, OutputStream, boolean)

verifyStream

public boolean verifyStream(java.io.InputStream dataFileStream,
                            java.io.InputStream publicKeyStream)
                     throws PGPException,
                            FileIsEncryptedException,
                            java.io.IOException

Verifies the incoming stream as being correctly signed.

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class VerifyStreamDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         InputStream dataStream = new FileInputStream("signed.pgp");
         InputStream keyStream = new FileInputStream("sender_public_key.asc");
         
         try {
           // verify and extract the signed content
           boolean validSignature = pgp.verifyStream(dataStream, keyStream);      
           if (validSignature) {
             System.out.println("Signature is valid.");
           } else {
             System.out.println("!Signature is invalid!");
           }
         } finally {
           dataStream.close();
           keyStream.close();
         }
     }
 }

Parameters:: dataFileStream - Input stream from the file to be verified; publicKeyStream - Input stream from the sender public key
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; FileIsEncryptedException - If supplied file is not only signed but encrypted too.; PGPException
See Also:: signStream(InputStream, String, InputStream, String, OutputStream, boolean)

verifyStream

public boolean verifyStream(java.io.InputStream dataFileStream,
                            java.io.InputStream publicKeyStream,
                            java.io.OutputStream outputFileStream)
                     throws PGPException,
                            FileIsEncryptedException,
                            java.io.IOException

Verifies the incoming stream as being correctly signed.

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class VerifyStreamDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         InputStream dataStream = new FileInputStream("signed.pgp");
         InputStream keyStream = new FileInputStream("sender_public_key.asc");
         OutputStream outputStream = new FileOutputStream("OUTPUT.txt");
         
         try {
           // verify and extract the signed content
           boolean validSignature = pgp.verifyStream(dataStream, keyStream, outputStream);      
           if (validSignature) {
             System.out.println("Signature is valid.");
           } else {
             System.out.println("!Signature is invalid!");
           }
         } finally {
           dataStream.close();
           keyStream.close();
           outputStream.close();
         }
     }
 }

Parameters:: dataFileStream - Input stream from the File to be verified; publicKeyStream - Input stream from the Public key; outputFileStream - Output Stream for the uncompressed signed content
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; FileIsEncryptedException - if the input file is not only signed but also encrypted; NonPGPDataException - if the input data is not a valid OpenPGP encrypted message; PGPException
See Also:: signStream(InputStream, String, InputStream, String, OutputStream, boolean)

verifyStream

public boolean verifyStream(java.io.InputStream dataFileStream,
                            KeyStore keyStore,
                            java.io.OutputStream outputFileStream)
                     throws PGPException,
                            FileIsEncryptedException,
                            java.io.IOException

Verifies the incoming stream as being correctly signed.

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class VerifyStreamDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         InputStream dataStream = new FileInputStream("signed.pgp");
         OutputStream outputStream = new FileOutputStream("OUTPUT.txt");

         // initialize the KeyStore  
         KeyStore keyStore = new KeyStore("mykeys.keystore", "password");  
         
         try {
           // verify and extract the signed content
           boolean validSignature = pgp.verifyStream(dataStream, keyStore, outputStream);      
           if (validSignature) {
             System.out.println("Signature is valid.");
           } else {
             System.out.println("!Signature is invalid!");
           }
         } finally {
           dataStream.close();
           keyStream.close();
           outputStream.close();
         }
     }
 }

Parameters:: dataFileStream - Input stream from the File to be verified; keyStore - Key store instance containing the sender public key for verification; outputFileStream - Output Stream for the uncompressed signed content
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; org.bouncycastle.openpgp.PGPException - OpenPGP encryption error; FileIsEncryptedException - if the input stream is not only signed but also encrypted; PGPException
See Also:: signStream(InputStream, String, InputStream, String, OutputStream, boolean)

verifyString

public boolean verifyString(java.lang.String message,
                            java.lang.String publicKeyFileName,
                            java.lang.StringBuffer decryptedString)
                     throws java.io.IOException,
                            PGPException,
                            FileIsEncryptedException

Verifies an OpenPGP signed only message.

Note: The embedded plain text message is converted into String assuming it is UTF-8 encoded. Use the overloaded message with charset parameter if it uses different encoding.

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class VerifyStringDemo {
     public static void main(String[] args) throws Exception {
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         String openpgpMessage = ""; // Fill here the OpenPGP signed message
         StringBuffer decryptedMessage = new StringBuffer();

         // The public key of the sender, used to verify the message  
         String publicKeyFile = "c:\\public_key.asc";  
         
         // verify and extract the signed content
         boolean validSignature = pgp.verifyString(openpgpMessage, publicKeyFile, decryptedMessage);      
         if (validSignature) {
             System.out.println("The signature is valid.");
         } else {
             System.out.println("The signature is invalid!");
         }
         
         System.out.println("plain message: " + decryptedMessage.toString());
     }
 }

Parameters:: message - OpenPGP signed message; publicKeyFileName - The public key of the sender, used to verify the message; decryptedString - Output string for the uncompressed signed content
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; PGPException - OpenPGP encryption error; FileIsEncryptedException - if the input message is not only signed but also encrypted

verifyString

public boolean verifyString(java.lang.String message,
                            java.lang.String publicKeyFileName,
                            java.lang.StringBuffer decryptedString,
                            java.lang.String charsetName)
                     throws java.io.IOException,
                            PGPException,
                            FileIsEncryptedException

Verifies an OpenPGP signed only message.

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class VerifyStringDemo {
     public static void main(String[] args) throws Exception {
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         String openpgpMessage = ""; // Fill here the OpenPGP signed message
         StringBuffer decryptedMessage = new StringBuffer();

         // The public key of the sender, used to verify the message  
         String publicKeyFile = "c:\\public_key.asc";  
         
         // verify and extract the signed content
         String messageCharSet = "UTF-8";
         boolean validSignature = pgp.verifyString(openpgpMessage, publicKeyFile, decryptedMessage, messageCharSet);      
         if (validSignature) {
             System.out.println("The signature is valid.");
         } else {
             System.out.println("The signature is invalid!");
         }
         
         System.out.println("plain message: " + decryptedMessage.toString());
     }
 }

Parameters:: message - OpenPGP signed message; publicKeyFileName - The public key of the sender, used to verify the message; decryptedString - Output string for the uncompressed signed content; charsetName - the name of a supported charset
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; PGPException - OpenPGP encryption error; FileIsEncryptedException - if the input message is not only signed but also encrypted

decryptAndVerifyString

public boolean decryptAndVerifyString(java.lang.String message,
                                      java.lang.String privateKeyFileName,
                                      java.lang.String privateKeyPassword,
                                      java.lang.String publicKeyFileName,
                                      java.lang.StringBuffer decryptedString)
                               throws java.io.IOException,
                                      PGPException,
                                      FileIsEncryptedException

Decrypts and verifies an OpenPGP one pass signed end encrypted message.

Note: The embedded plain text message is converted into String assuming it is UTF-8 encoded. Use the overloaded message with charset parameter if it uses different encoding.

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class DecryptAndVerifyStringDemo {
     public static void main(String[] args) throws Exception {
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         String openpgpMessage = ""; // Fill here the OpenPGP encrypted and signed message
         StringBuffer decryptedMessage = new StringBuffer();

         // The public key of the sender, used to verify the message  
         String publicKeyFile = "c:\\public_key.asc";  
         
         String privateKeyFile = "c:\\my_private_key.asc";
         String privateKeyPassword = "my passsword";
         
         // verify and extract the signed content
         boolean validSignature = pgp.decryptAndVerifyString(openpgpMessage,
                                                               privateKeyFile,
                                                               privateKeyPassword, 
                                                               publicKeyFile, 
                                                               decryptedMessage);
                                                                     
         if (validSignature) {
             System.out.println("The signature is valid.");
         } else {
             System.out.println("The signature is invalid!");
         }
         
         System.out.println("plain message: " + decryptedMessage.toString());
     }
 }

Parameters:: message - OpenPGP signed message; privateKeyFile - Private key used for decryption; privateKeyPassword - The password of the private key; publicKeyFileName - The public key of the sender, used to verify the message; decryptedString - Output string for the uncompressed signed content
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; PGPException - OpenPGP encryption error; FileIsEncryptedException - if the input message is not only signed but also encrypted

decryptAndVerifyString

public boolean decryptAndVerifyString(java.lang.String message,
                                      java.lang.String privateKeyFileName,
                                      java.lang.String privateKeyPassword,
                                      java.lang.String publicKeyFileName,
                                      java.lang.StringBuffer decryptedString,
                                      java.lang.String charsetName)
                               throws java.io.IOException,
                                      PGPException,
                                      FileIsEncryptedException

Decrypts and verifies an OpenPGP one pass signed end encrypted message.

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class DecryptAndVerifyStringDemo {
     public static void main(String[] args) throws Exception {
         // create an instance of the library
         PGPLib pgp = new PGPLib();

         String openpgpMessage = ""; // Fill here the OpenPGP encrypted and signed message
         StringBuffer decryptedMessage = new StringBuffer();

         // The public key of the sender, used to verify the message  
         String publicKeyFile = "c:\\public_key.asc";  
         
         String privateKeyFile = "c:\\my_private_key.asc";
         String privateKeyPassword = "my passsword";
         
         // verify and extract the signed content
         String messageCharSet = "UTF-8";
         boolean validSignature = pgp.decryptAndVerifyString(openpgpMessage,
                                                               privateKeyFile,
                                                               privateKeyPassword, 
                                                               publicKeyFile, 
                                                               decryptedMessage, 
                                                               messageCharSet);      
         if (validSignature) {
             System.out.println("The signature is valid.");
         } else {
             System.out.println("The signature is invalid!");
         }
         
         System.out.println("plain message: " + decryptedMessage.toString());
     }
 }

Parameters:: message - OpenPGP signed message; privateKeyFile - Private key used for decryption; privateKeyPassword - The password of the private key; publicKeyFileName - The public key of the sender, used to verify the message; decryptedString - Output string for the uncompressed signed content; charsetName - the name of a supported charset
Returns:: true if signed correctly, false if not signed with this public key
Throws:: java.io.IOException - I/O error; PGPException - OpenPGP encryption error; FileIsEncryptedException - if the input message is not only signed but also encrypted

decryptAndVerifyFile

public boolean decryptAndVerifyFile(java.lang.String encryptedFileName,
                                    KeyStore keyStore,
                                    java.lang.String privateKeyPassword,
                                    java.lang.String outputFileName)
                             throws PGPException,
                                    java.io.IOException

Decrypts and verifies one pass encrypted and signed OpenPGP file
Supports OpenPGP version 3 format too (used by PGP 6.5 and below).

Parameters:: encryptedFileName - File name to be decrypted (absolute or relative path); keyStore - Key store containing the Private Key for decryption and the other party Public key for verification; privateKeyPassword - Private key password; outputFileName - File name of the Output decrypted file (absolute or relative path).
Returns:: true if signature is valid, false if signature is invalid
Throws:: java.io.IOException - if a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the file was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled; NonPGPDataException - if the input file is not a valid OpenPGP encrypted file; PGPException
See Also:: signAndEncryptFile(String, KeyStore, String, String, String, String, boolean, boolean)

decryptAndVerifyFileTo

public boolean decryptAndVerifyFileTo(java.lang.String encryptedFileName,
                                      KeyStore keyStore,
                                      java.lang.String privateKeyPassword,
                                      java.lang.String outputFolder)
                               throws PGPException,
                                      java.io.IOException

Decrypts and verifies one pass encrypted and signed OpenPGP file
Supports OpenPGP version 3 format too (used by PGP 6.5 and below).

Parameters:: encryptedFileName - File name to be decrypted (absolute or relative path); keyStore - Key store containing the Private Key for decryption and the other party Public key for verification; privateKeyPassword - Private key password; outputFileName - File name of the Output decrypted file (absolute or relative path).
Returns:: true if signature is valid, false if signature is invalid
Throws:: java.io.IOException - if a file/stream operation throws an exception; java.io.FileNotFoundException - if the input file or the output folder does not exist; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the file was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled; PGPException
See Also:: signAndEncryptFile(String, KeyStore, String, String, String, String, boolean, boolean)

decryptAndVerifyStream

public boolean decryptAndVerifyStream(java.io.InputStream encryptedStream,
                                      KeyStore keyStore,
                                      java.lang.String privateKeyPassword,
                                      java.io.OutputStream outputFileStream)
                               throws PGPException,
                                      java.io.IOException

Decrypts and verifies OpenPGP encrypted and signed stream.
Supports OpenPGP version 3 format too (used by PGP 2.x systems).

Parameters:: encryptedStream - Input stream with the encrypted content; keyStore - Key store instance containing the Private Key for decryption and the other party Public key for verification; privateKeyPassword - Private Key password; outputFileStream - Output stream for the decrypted content
Returns:: true if signature is valid, false if signature is invalid
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the stream was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled; NonPGPDataException - if the input data is not a valid OpenPGP encrypted message; PGPException
See Also:: signAndEncryptStream(InputStream, String, KeyStore, String, String, String, OutputStream, boolean, boolean)

decryptAndVerifyFile

public boolean decryptAndVerifyFile(java.lang.String encryptedFileName,
                                    java.lang.String privateKeyFileName,
                                    java.lang.String privateKeyPassword,
                                    java.lang.String publicKeyFile,
                                    java.lang.String outputFileName)
                             throws PGPException,
                                    java.io.IOException

Decrypts and verifies an OpenPGP encrypted and signed file
Supports OpenPGP version 3 format too (used by PGP(r) 5 and below).

Example:

 import com.didisoft.pgp.*;
 
 public class DecryptAndVerifyFileDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         // verify and extract the signed content
         boolean validSignature = pgp.decryptAndVerifyFile("encrypted.pgp",
                                                           "decryption_private_key.asc",
                                                           "decryption key password",   
                                                           "sender_public_key.asc", 
                                                           "OUTPUT.txt");      
         if (validSignature) {
             System.out.println("Signature is valid.");
         } else {
             System.out.println("!Signature is invalid!");
         }
     }
 }

Parameters:: encryptedFileName - File name to be decrypted (absolute or relative path); privateKeyFileName - Private key file name used for decryption (absolute or relative path); privateKeyPassword - Private key password; publicKeyFile - Public key file name used for verification of the signature (absolute or relative path); outputFileName - File name of the output decrypted file (absolute or relative path).
Returns:: true if signature is valid, false if signature is invalid
Throws:: java.io.IOException - if a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the file was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled; NonPGPDataException - if the input file is not a valid OpenPGP encrypted file; PGPException
See Also:: signAndEncryptFile(String, String, String, String, String, boolean, boolean)

decryptAndVerifyFileTo

public boolean decryptAndVerifyFileTo(java.lang.String encryptedFileName,
                                      java.lang.String privateKeyFileName,
                                      java.lang.String privateKeyPassword,
                                      java.lang.String publicKeyFile,
                                      java.lang.String outputFolder)
                               throws PGPException,
                                      java.io.IOException

Decrypts and verifies an OpenPGP encrypted and signed file to a folder
This methods is very suitable for multi file PGP archives. Supports OpenPGP version 3 format too (used by PGP 5.6 and below).

Example:

 import com.didisoft.pgp.*;
 
 public class DecryptAndVerifyFileToDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         String outputFolder = "c:\\Temp";
         
         // verify and extract the signed content
         boolean validSignature = pgp.decryptAndVerifyFileTo("encrypted.pgp",
                                                           "decryption_private_key.asc",
                                                           "decryption key password",   
                                                           "sender_public_key.asc", 
                                                           outputFolder);      
         if (validSignature) {
             System.out.println("Signature is valid.");
         } else {
             System.out.println("!Signature is invalid!");
         }
     }
 }

Parameters:: encryptedFileName - File name to be decrypted (absolute or relative path); privateKeyFileName - Private key file name used for decryption (absolute or relative path); privateKeyPassword - Private key password; publicKeyFile - Public key file name used for verification of the signature (absolute or relative path); outputFolder - Output folder where the decrypted file(s) will be stored
Returns:: true if signature is valid, false if signature is invalid
Throws:: java.io.IOException - if a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the file was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled; NonPGPDataException - if the input data is not a valid OpenPGP encrypted message; PGPException
See Also:: signAndEncryptFile(String, String, String, String, String, boolean, boolean)

decryptAndVerifyStream

public boolean decryptAndVerifyStream(java.io.InputStream encryptedStream,
                                      java.io.InputStream privateKeyStream,
                                      java.lang.String privateKeyPassword,
                                      java.io.InputStream publicKeyStream,
                                      java.io.OutputStream outputFileStream)
                               throws PGPException,
                                      java.io.IOException

Decrypts and verifies OpenPGP encrypted and signed stream.
Supports OpenPGP version 3 format too (used by PGP 6.5 and below).

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class DecryptAndVerifyStreamDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         InputStream dataStream = new FileInputStream("signed.pgp");
         InputStream decryptionKeyStream = new FileInputStream("decryption_private_key.asc");
         InputStream verificationKeyStream = new FileInputStream("sender_public_key.asc");
         OutputStream outputStream = new FileOutputStream("OUTPUT.txt");
         
         try {
           // verify and extract the signed content
           boolean validSignature = pgp.decryptAndVerifyStream(dataStream,
                                                             decryptionKeyStream,
                                                             "decryption key password",   
                                                             verificationKeyStream, 
                                                             outputStream);      
           if (validSignature) {
             System.out.println("Signature is valid.");
           } else {
             System.out.println("!Signature is invalid!");
           }
         } finally {
           dataStream.close();
           decryptionKeyStream.close();
           verificationKeyStream.close();
           outputStream.close();
         }         
     }
 }

Parameters:: encryptedStream - Input stream with the encrypted and signed content; privateKeyStream - Private Key stream used for decryption. This is usually our own private key; privateKeyPassword - Private Key password; publicKeyStream - Public Key stream used for signature verification. This is usually the public key of the sender; outputFileStream - Output stream for the decrypted content
Returns:: true if signature is valid, false if signature is invalid
Throws:: java.io.IOException - If a file/stream operation throws an exception; PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the stream was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled
See Also:: signAndEncryptStream(InputStream, String, InputStream, String, InputStream, OutputStream, boolean, boolean)

decryptAndVerifyStreamTo

public boolean decryptAndVerifyStreamTo(java.io.InputStream encryptedStream,
                                        java.io.InputStream privateKeyStream,
                                        java.lang.String privateKeyPassword,
                                        java.io.InputStream publicKeyStream,
                                        java.lang.String outputFolder)
                                 throws PGPException,
                                        java.io.IOException

Decrypts and verifies OpenPGP encrypted and signed stream.
Supports OpenPGP version 3 format too (used by PGP 6.5 and below).

Example:

 import java.io.*;
 import com.didisoft.pgp.*;
 
 public class DecryptAndVerifyStreamToDemo {
     public static void main(String[] args) throws Exception{
         // create an instance of the library
         PGPLib pgp = new PGPLib();
         
         InputStream dataStream = new FileInputStream("signed.pgp");
         InputStream decryptionKeyStream = new FileInputStream("decryption_private_key.asc");
         InputStream verificationKeyStream = new FileInputStream("sender_public_key.asc");
         
         String outputFolder = "c:\\Temp";
         
         try {
           // verify and extract the signed content
           boolean validSignature = pgp.decryptAndVerifyStreamTo(dataStream,
                                                             decryptionKeyStream,
                                                             "decryption key password",   
                                                             verificationKeyStream, 
                                                             outputFolder);      
           if (validSignature) {
             System.out.println("Digital signature is valid.");
           } else {
             System.out.println("!Digital signature is invalid!");
           }
         } finally {
           dataStream.close();
           decryptionKeyStream.close();
           verificationKeyStream.close();
           outputStream.close();
         }         
     }
 }

Parameters:: encryptedStream - Input stream with the encrypted and signed content; privateKeyStream - Private Key stream used for decryption. This is usually our own private key; privateKeyPassword - Private Key password; publicKeyStream - Public Key stream used for signature verification. This is usually the public key of the sender; outputFolder - Output folder where the decrypted file(s) will be stored
Returns:: true if signature is valid, false if signature is invalid
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the stream was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled; NonPGPDataException - if the input data is not a valid OpenPGP encrypted message; PGPException
See Also:: signAndEncryptStream(InputStream, String, InputStream, String, InputStream, OutputStream, boolean, boolean)

decryptAndVerifyStreamTo

public boolean decryptAndVerifyStreamTo(java.io.InputStream encryptedStream,
                                        KeyStore keyStore,
                                        java.lang.String privateKeyPassword,
                                        java.lang.String outputFolder)
                                 throws PGPException,
                                        java.io.IOException

Decrypts and verifies OpenPGP encrypted and signed stream.
Supports OpenPGP version 3 format too (used by PGP 2.x systems).

Parameters:: encryptedStream - Input stream with the encrypted content; keyStore - Key store instance containing the Private Key for decryption and the other party Public key for verification; privateKeyPassword - Private Key password; outputFolder - Output folder where the decrypted file(s) will be stored
Returns:: true if signature is valid, false if signature is invalid
Throws:: java.io.IOException - If a file/stream operation throws an exception; org.bouncycastle.openpgp.PGPException - if a problem has occurred while decrypting file; WrongPrivateKeyException - if the stream was not encrypted with this private key; WrongPasswordException - if the password for this private key is misspelled; PGPException
See Also:: signAndEncryptStream(InputStream, String, KeyStore, String, String, String, OutputStream, boolean, boolean)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.didisoft.pgp Class PGPLib

PGPLib

isUseExpiredKeys

setUseExpiredKeys

isUseRevokedKeys

setUseRevokedKeys

setHash

getCypher

setCypher

getCompression

setCompression

clearSignFile

clearSignFileVersion3

clearSignString

clearSignStringVersion3

signFile

signFile

signFile

signFile

signFile

signStream

signStream

signStream

signFileVersion3

signStreamVersion3

signAndEncryptFile

signAndEncryptFile

signAndEncryptFile

signAndEncryptStream

signAndEncryptFile

signAndEncryptFile

signAndEncryptStream

signAndEncryptFileVersion3

signAndEncryptFileVersion3

signAndEncryptStreamVersion3

signAndEncryptStreamVersion3

signAndEncryptString

signAndEncryptStringVersion3

signAndEncryptString

signAndEncryptStringVersion3

decryptStream

decryptStreamTo

decryptStreamTo

decryptStream

decryptFile

decryptFile

decryptFilePBE

decryptFileTo

decryptFileTo

decryptFile

encryptStream

encryptStream

encryptStream

encryptStream

encryptStream

encryptStream

encryptStreamPBE

encryptFilePBE

encryptFilePBE

encryptFile

encryptFile

encryptFile

encryptFile

encryptFile

encryptFiles

encryptFiles

encryptFiles

encryptFile

encryptFileByUserId

encryptFile

encryptFile

encryptFileByKeyId

encryptFile

encryptFile

verifyFile

verifyFile

verifyFile

verifyFile

verifyStream

verifyStream

com.didisoft.pgp
Class PGPLib