BouncyCastle : Java Glossary

by Roedy Green ©1996-2009 Canadian Mind Products
index page for letter ⇒ punctuation 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z (all)

BouncyCastle

Legion of the Bouncy Castle is a JCE (Java Cryptographic Extension)-compatible library that also handles PGP. It is well regarded. The source is not well formatted or commented. The Javadoc in version 1.22 was sparce and inaccurate. Version 1.41 is reputedly better. I don’t know how they do it, but everything is free. The specificiations give a bird’s eye view of all the encryption algorithms supported.

BouncyCastle has the big advantage of being Australian, and hence immune to the silly American laws about exporting strong encryption. If Canadians use BouncyCastle they need not worry about that law, since the code is not American. If Americans use it, they can still get in trouble just for incorporating Australian encryption code even though it did not originate in America. If you are an American and have a product then implements or uses encryption, best talk to a lawyer. The laws are idiotic since encryption algorithms are public domain and widely disseminated. All the laws do is cripple American software company exports.

You will want to download the BouncyCastle jars for:

Put the jars in your ext directories:

ext directories :

in C:\Program Files\java\jre6\lib\ext in the JRE 1.6.0 on your local hard disk.
in J:\Program Files\java\jdk1.6.0_11\jre\lib\ext in the in the JDK 1.6.0 on your local hard disk.
in C:\Program Files\java\jre1.5.0_17\lib\ext in the older JRE 1.5.0 on your local hard disk.
in J:\Program Files\java\jdk1.5.0_17\jre\lib\ext in the in the older JDK 1.5.0 on your local hard disk.

Generating Keys

Generate a binary private/public key with:

java org.bouncycastle.openpgp.examples.RSAKeyPairGenerator charlie "open sesame"

The public and private keys will appear as pub.bpg, and secret.bpg. You can generate ascii *.asc ascii armoured file instead by using the -a option like this:

java org.bouncycastle.openpgp.examples.RSAKeyPairGenerator -a charlie "open sesame"

To generate variants look at the source code in bcpg-jdk14-122/src/org/bouncycastleopenpgp/examples/RSAKeyPairGenerator.java

Signing A Binary File

Resulting signed file will appear in anyfile.dat.bpg signed, but not encrypted.

Verifying a Signed Binary File

java org.bouncycastle.openpgp.examples.SignedFileProcessor -v anyfile.dat.bpg pub.bpg

I’m told BouncyCastle does not support Sun’s proprietary JKS store format, but even that can be got around with Metastatic’s reverse engineered version.

With BouncyCastle you have the sources to look at. With keytool, all you have is -J-verbose:class to find out what classes it is using.

encryption
JCE
security

	Please email your feedback for publication, errors, omissions, broken/redirected link reports and suggestions to improve this page to Roedy Green :
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
	Your face IP:[38.103.63.62]	The information on this page is for non-military use only.
	You are visitor number 18,720.	Military use includes use by defence contractors.
	You can get a fresh copy of this page from:	or possibly from your local J: drive (Java virtual drive/mindprod.com website mirror)
	http://mindprod.com/jgloss/bouncycastle.html	J:\mindprod\jgloss\bouncycastle.html