Java KeyPairGenerator

Jakob Jenkov
Last update: 2018-01-24

The Java KeyPairGenerator class (java.security.KeyPairGenerator) is used to generate asymmetric encryption / decryption key pairs. An asymmetric key pair consists of two keys. The first key is typically used to encrypt data. The second key which is used to decrypt data encrypted with the first key.

Public Key, Private Key Type Key Pairs

The most commonly known type of asymmetric key pair is the public key, private key type of key pair. The private key is used to encrypt data, and the public key can be used to decrypt the data again. Actually, you could also encrypt data using the public key and decrypt it using the private key.

The private key is normally kept secret, and the public key can be made publicly available. Thus, if Jack encrypts some data with his private key, everyone in possession of Jack's public key can decrypt it.

Creating a KeyPairGenerator Instance

To use the Java KeyPairGenerator you must first create a KeyPairGenerator instance. Creating a KeyPairGenerator instance is done by calling the method getInstance() method. Here is an example of creating a Java KeyPairGenerator instance:

KeyPairGenerator keyPairGenerator = KeyPairGenerator.getInstance("RSA");

The getInstance() method takes the name of the encryption algorithm to generate the key pair for. In this example we use the name RSA.

Initializing the KeyPairGenerator

Depending on the algorithm the key pair is generated for, you may have to initialize the KeyPairGenerator instance. Initializing the KeyPairGenerator is done by calling its initialize() method. Here is an example of initializing a Java KeyPairGenerator instance:

keyPairGenerator.initialize(2048);

This example initializes the KeyPairGenerator to generate keys of 2048 bits in size.

Generating a Key Pair

To generate a KeyPair with a KeyPairGenerator you call the generateKeyPair() method. Here is an example of generating a KeyPair with the KeyPairGenerator:

KeyPair keyPair = keyPairGenerator.generateKeyPair();

Jakob Jenkov

Featured Videos

Java ConcurrentMap + ConcurrentHashMap

Java Generics

Java ForkJoinPool

P2P Networks Introduction

















Close TOC
All Tutorial Trails
All Trails
Table of contents (TOC) for this tutorial trail
Trail TOC
Table of contents (TOC) for this tutorial
Page TOC
Previous tutorial in this tutorial trail
Previous
Next tutorial in this tutorial trail
Next