Bouncy Castle for Java  Documentation

To view some examples, look at the test programs in the packages on GitHub: 

There are also some specific example programs for dealing with Attribute Certificates, PKCS12, SMIME, and OpenPGP. They can be found on GitHub:

Finally, you can download some code examples from Beginning Cryptography with Java which demonstrate both the use of the JCE/JCA and some of the Bouncy Castle APIs such as for certificate generation, CMS, and S/MIME. Note: the book was written to cover J2SE 5.0, while many of the examples will work with earlier JDKs, some will not compile if you are not using J2SE 5.0 or later.

Unfortunately, some examples in the book are now out of date (for 1.46 and above). You can also find more up-to-date documentation and examples in Java Cryptography: Tools and Techniques. A copy of the source code for the examples in the book can be downloaded here: java-crypto-tools-src.zip.

To verify the packages, run the following Java programs with the appropriate classpath:

Training: PKI at the edge with Bouncy Castle

Learn how to use Bouncy Castle for generating certificates and certification requests, including for EJBCA. To make these tasks easier for system administrators, we will also look at Kotlin DSL as a scripting language.

Watch the training: Training - PKI at the Edge with Bouncy Castle and EJBCA

See the documentation: How-to guides and exercises - PKI at the Edge

Tutorials and Workshops on Youtube

Go to the playlist: Bouncy Castle Tutorials and Workshops

EJBCA

EJBCA is a fully functional Certificate Authority using J2EE technology. EJBCA builds on the J2EE platform to create a robust, high performance, platform independent, flexible, and component based CA to be used standalone or integrated in any J2EE app.

Novosec Extensions

Novosec Extensions provides the following pure Java extensions to the Bouncy Castle framework and has been made freely available by www.novosec.com:

• OCSP (RFC 2560) server and client
• CMP (RFC 2510, RFC 2511) generator and parser.

JCE taglib

JCE taglib is a JSP tag library with cryptographic funtions and X.509 certificate generation based on BouncyCastle JCE. There is also a refactoring of JCE taglib CryptoLib on the main JCE taglib project page. CryptoLib can also be used with non-JSP projects.

LightCrypto

LightCrypto is a library of cryptographic functions based on the lightweight API, including some functions for use with HSQLDB embeddable database.

Portecle

Portecle is a user-friendly GUI application for creating, managing, and examining key stores, keys, certificates, certificate requests, certificate revocation lists, and more.

Jasypt

Jasypt - Java Simplified Encryption is a java library that allows the developer to add basic encryption capabilities to his/her projects with minimum effort. It offers transparent integration with Hibernate, an open API for use with any JCE provider, and is suitable for integration into Spring-based applications and ACEGI. Instructions on using it with Bouncy Castle can be found at: http://www.jasypt.org/bouncy-castle.html.

KeyTool IUI

KeyTool IUI is a free user friendly GUI application for creating, managing keys and keystores as an alternative to the JDK's KeyTool command.

Français

Cryptographie avec Bouncy Castle
Nyal
 
Ce tutoriel constitue une première approche pour l'utilisation de la bibliothèque Bouncy Castle.

Utiliser PGP avec Java et Bouncy Castle
Graham Jenkins (Traduction française par Simon Depiets, relecture de la traduction française par Joëlle Cornavin). 

English

Java Cryptography: Tools and Techniques
David Hook, Jon Eaves - Leanpub
 
Finished in 2022 and written by two founders of the Bouncy Castle project, as a successor to "Beginning Cryptography with Java", the book covers the recent features introduced in the JCA/JCE as well the latest changes to the BC APIs and the BCFIPS Java module including the recent introduction of Post-Quantum algorithms to the BC APIs. Coverage of certificate generation, CMS, S/MIME, OpenPGP, and the TLS APIs is also included. Also available as a Paperback Edition and a Kindle Tablet Edition

A copy of the source code for the examples in the book can be downloaded here: java-crypto-tools-src.zip.

Beginning Cryptography with Java
David Hook - Wrox
 
Written by a Bouncy Castle APIs committer, the book covers recent features introduced in the JCA/JCE cryptography APIs in JDK 1.5 and is up to date with the cryptography APIs in J2SE 5.0, including Elliptic Curve cryptography, as well as dealing with earlier versions of the JCE/JCA in earlier JDKs. The book also deals with provider installation, X.509 certificate generation, CRL generation, and the creation and processing of PKCS #10 certification requests using the JCA and the Bouncy Castle APIs. In addition, it covers certificate validation and certificate path processing with both CRLs and OCSP. Finally, it also covers using PKCS #12, processing CMS and S/MIME messages using the BC APIs, SSL using the JSSE, and gives an introduction in how to use the Bouncy Castle ASN.1 library.

The book also has some online resources including a forum and code examples to be downloaded: beg_crypto_examples.zip. While the code examples are probably still useful, this book is now somewhat dated and we would recommend Java Cryptography: Tools and Techniques instead.

Java Cryptography Extensions : Practical Guide for Programmers
Jason Weiss - Morgan Kaufmann
 
Covers the JCE and some parts of the JCA as seen in JDK 1.4.

Wireless Java: Developing with Java 2, Micro Edition
Jonathan Knudsen - Apress
 
Includes a section on developing with the Bouncy Castle Lightweight APIs.

J2EE Security for Servlets, EJBs, and Web Services
Pankaj Kumar - Prentice Hall PTR
 
Includes sections on the JCE, JCA and implementing PKI systems with Java and a discussion of what goes on under the covers when you install the Bouncy Castle provider.