Bouncy Castle OpenPGP APIs (FIPS Distribution) 1.0.7.1 · org.bouncycastle.openpgp.PGPKeyRingGenerator

Modifier and Type	Field and Description
private PGPDigestCalculator	checksumCalculator
private PGPSignatureSubpacketVector	hashedPcks
private PBESecretKeyEncryptor	keyEncryptor
pack-priv List<E>	keys
private PGPContentSignerBuilder	keySignerBuilder
private PGPKeyPair	masterKey
private PGPSignatureSubpacketVector	unhashedPcks

Constructor Summary

Access	Constructor and Description
public	PGPKeyRingGenerator(int certificationLevel, PGPKeyPair masterKey, String id to associate with the key. id, PGPDigestCalculator key checksum calculator checksumCalculator, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks, PGPContentSignerBuilder builder for key certifications - will be initialised with master secret key. keySignerBuilder, PBESecretKeyEncryptor encryptor for secret subkeys. keyEncryptor) Create a new key ring generator.
public	PGPKeyRingGenerator(PGPKeyPair primary key masterKey, PGPDigestCalculator checksum calculator checksumCalculator, PGPSignatureSubpacketVector hashed signature subpackets hashedPcks, PGPSignatureSubpacketVector unhashed signature subpackets unhashedPcks, PGPContentSignerBuilder signer builder keySignerBuilder, PBESecretKeyEncryptor key encryptor keyEncryptor) Create a new key ring generator without a user-id, but instead with a primary key carrying a direct-key signature.
public	PGPKeyRingGenerator(PGPSecretKeyRing the secret key ring we want to add a subkeyto, originalSecretRing, PBESecretKeyDecryptor a decryptor for the signing master key. secretKeyDecryptor, PGPDigestCalculator key checksum calculator checksumCalculator, PGPContentSignerBuilder builder for key certifications - will be initialised with master secret key. keySignerBuilder, PBESecretKeyEncryptor encryptor for secret subkeys. keyEncryptor) Create a new key ring generator based on an original secret key ring.

Method Summary

Modifier and Type	Method and Description
public void	addSubKey(PGPKeyPair the key pair to add. keyPair) Add a sub key to the key ring to be generated with default certification and inheriting the hashed/unhashed packets of the master key.
public void	addSubKey(PGPKeyPair the key pair to add. keyPair, PGPContentSignerBuilder provide a signing builder to create the Primary Key signature. bindingSignerBldr) Add a sub key to the key ring to be generated with default certification and inheriting the hashed/unhashed packets of the master key.
public void	addSubKey(PGPKeyPair public/private key pair. keyPair, PGPSignatureSubpacketVector hashed packet values to be included in certification. hashedPcks, PGPSignatureSubpacketVector unhashed packets values to be included in certification. unhashedPcks) Add a subkey with specific hashed and unhashed packets associated with it and default certification.
public void	addSubKey(PGPKeyPair public/private key pair. keyPair, PGPSignatureSubpacketVector hashed packet values to be included in certification. hashedPcks, PGPSignatureSubpacketVector unhashed packets values to be included in certification. unhashedPcks, PGPContentSignerBuilder provide a signing builder to create the Primary Key signature. bindingSignerBldr) Add a subkey with specific hashed and unhashed packets associated with it and default certification.
public PGPPublicKeyRing	Returns: a public key ring. generatePublicKeyRing() Return the public key ring that corresponds to the secret key ring.
public PGPSecretKeyRing	Returns: a secret key ring. generateSecretKeyRing() Return the secret key ring.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

checksumCalculator	back to summary
private PGPDigestCalculator checksumCalculator

hashedPcks	back to summary
private PGPSignatureSubpacketVector hashedPcks

keyEncryptor	back to summary
private PBESecretKeyEncryptor keyEncryptor

keys	back to summary
pack-priv List<E> keys

keySignerBuilder	back to summary
private PGPContentSignerBuilder keySignerBuilder

masterKey	back to summary
private PGPKeyPair masterKey

unhashedPcks	back to summary
private PGPSignatureSubpacketVector unhashedPcks

Constructor Detail

PGPKeyRingGenerator	back to summary
public PGPKeyRingGenerator(int certificationLevel, PGPKeyPair masterKey, String id, PGPDigestCalculator checksumCalculator, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks, PGPContentSignerBuilder keySignerBuilder, PBESecretKeyEncryptor keyEncryptor) throws PGPException Create a new key ring generator. Parameters id:String id to associate with the key. checksumCalculator:PGPDigestCalculator key checksum calculator keySignerBuilder:PGPContentSignerBuilder builder for key certifications - will be initialised with master secret key. keyEncryptor:PBESecretKeyEncryptor encryptor for secret subkeys.

PGPKeyRingGenerator

back to summary

public PGPKeyRingGenerator(int certificationLevel, PGPKeyPair masterKey, String id, PGPDigestCalculator checksumCalculator, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks, PGPContentSignerBuilder keySignerBuilder, PBESecretKeyEncryptor keyEncryptor) throws PGPException

Create a new key ring generator.

Parameters

id:String: id to associate with the key.
checksumCalculator:PGPDigestCalculator: key checksum calculator
keySignerBuilder:PGPContentSignerBuilder: builder for key certifications - will be initialised with master secret key.
keyEncryptor:PBESecretKeyEncryptor: encryptor for secret subkeys.

PGPKeyRingGenerator	back to summary
public PGPKeyRingGenerator(PGPKeyPair masterKey, PGPDigestCalculator checksumCalculator, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks, PGPContentSignerBuilder keySignerBuilder, PBESecretKeyEncryptor keyEncryptor) throws PGPException Create a new key ring generator without a user-id, but instead with a primary key carrying a direct-key signature. Parameters masterKey:PGPKeyPair primary key checksumCalculator:PGPDigestCalculator checksum calculator hashedPcks:PGPSignatureSubpacketVector hashed signature subpackets unhashedPcks:PGPSignatureSubpacketVector unhashed signature subpackets keySignerBuilder:PGPContentSignerBuilder signer builder keyEncryptor:PBESecretKeyEncryptor key encryptor

PGPKeyRingGenerator

back to summary

public PGPKeyRingGenerator(PGPKeyPair masterKey, PGPDigestCalculator checksumCalculator, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks, PGPContentSignerBuilder keySignerBuilder, PBESecretKeyEncryptor keyEncryptor) throws PGPException

Create a new key ring generator without a user-id, but instead with a primary key carrying a direct-key signature.

Parameters

masterKey:PGPKeyPair: primary key
checksumCalculator:PGPDigestCalculator: checksum calculator
hashedPcks:PGPSignatureSubpacketVector: hashed signature subpackets
unhashedPcks:PGPSignatureSubpacketVector: unhashed signature subpackets
keySignerBuilder:PGPContentSignerBuilder: signer builder
keyEncryptor:PBESecretKeyEncryptor: key encryptor

PGPKeyRingGenerator	back to summary
public PGPKeyRingGenerator(PGPSecretKeyRing originalSecretRing, PBESecretKeyDecryptor secretKeyDecryptor, PGPDigestCalculator checksumCalculator, PGPContentSignerBuilder keySignerBuilder, PBESecretKeyEncryptor keyEncryptor) throws PGPException Create a new key ring generator based on an original secret key ring. The default hashed/unhashed sub-packets for subkey signatures will be inherited from the first signature on the master key (other than CREATION-TIME which will be ignored). Parameters originalSecretRing:PGPSecretKeyRing the secret key ring we want to add a subkeyto, secretKeyDecryptor:PBESecretKeyDecryptor a decryptor for the signing master key. checksumCalculator:PGPDigestCalculator key checksum calculator keySignerBuilder:PGPContentSignerBuilder builder for key certifications - will be initialised with master secret key. keyEncryptor:PBESecretKeyEncryptor encryptor for secret subkeys.

PGPKeyRingGenerator

back to summary

public PGPKeyRingGenerator(PGPSecretKeyRing originalSecretRing, PBESecretKeyDecryptor secretKeyDecryptor, PGPDigestCalculator checksumCalculator, PGPContentSignerBuilder keySignerBuilder, PBESecretKeyEncryptor keyEncryptor) throws PGPException

Create a new key ring generator based on an original secret key ring. The default hashed/unhashed sub-packets for subkey signatures will be inherited from the first signature on the master key (other than CREATION-TIME which will be ignored).

Parameters

originalSecretRing:PGPSecretKeyRing: the secret key ring we want to add a subkeyto,
secretKeyDecryptor:PBESecretKeyDecryptor: a decryptor for the signing master key.
checksumCalculator:PGPDigestCalculator: key checksum calculator
keySignerBuilder:PGPContentSignerBuilder: builder for key certifications - will be initialised with master secret key.
keyEncryptor:PBESecretKeyEncryptor: encryptor for secret subkeys.

Method Detail

addSubKey	back to summary
public void addSubKey(PGPKeyPair keyPair) throws PGPException Add a sub key to the key ring to be generated with default certification and inheriting the hashed/unhashed packets of the master key. Parameters keyPair:PGPKeyPair the key pair to add.

addSubKey

back to summary

public void addSubKey(PGPKeyPair keyPair) throws PGPException

Add a sub key to the key ring to be generated with default certification and inheriting the hashed/unhashed packets of the master key.

Parameters

keyPair:PGPKeyPair: the key pair to add.

addSubKey	back to summary
public void addSubKey(PGPKeyPair keyPair, PGPContentSignerBuilder bindingSignerBldr) throws PGPException Add a sub key to the key ring to be generated with default certification and inheriting the hashed/unhashed packets of the master key. If bindingSignerBldr is not null it will be used to add a Primary Key Binding signature (type 0x19) into the hashedPcks for the key (required for signing subkeys). Parameters keyPair:PGPKeyPair the key pair to add. bindingSignerBldr:PGPContentSignerBuilder provide a signing builder to create the Primary Key signature.

addSubKey

back to summary

public void addSubKey(PGPKeyPair keyPair, PGPContentSignerBuilder bindingSignerBldr) throws PGPException

Add a sub key to the key ring to be generated with default certification and inheriting the hashed/unhashed packets of the master key. If bindingSignerBldr is not null it will be used to add a Primary Key Binding signature (type 0x19) into the hashedPcks for the key (required for signing subkeys).

Parameters

keyPair:PGPKeyPair: the key pair to add.
bindingSignerBldr:PGPContentSignerBuilder: provide a signing builder to create the Primary Key signature.

addSubKey	back to summary
public void addSubKey(PGPKeyPair keyPair, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks) throws PGPException Add a subkey with specific hashed and unhashed packets associated with it and default certification. Parameters keyPair:PGPKeyPair public/private key pair. hashedPcks:PGPSignatureSubpacketVector hashed packet values to be included in certification. unhashedPcks:PGPSignatureSubpacketVector unhashed packets values to be included in certification.

addSubKey

back to summary

public void addSubKey(PGPKeyPair keyPair, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks) throws PGPException

Add a subkey with specific hashed and unhashed packets associated with it and default certification.

Parameters

keyPair:PGPKeyPair: public/private key pair.
hashedPcks:PGPSignatureSubpacketVector: hashed packet values to be included in certification.
unhashedPcks:PGPSignatureSubpacketVector: unhashed packets values to be included in certification.

addSubKey	back to summary
public void addSubKey(PGPKeyPair keyPair, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks, PGPContentSignerBuilder bindingSignerBldr) throws PGPException Add a subkey with specific hashed and unhashed packets associated with it and default certification. If bindingSignerBldr is not null it will be used to add a Primary Key Binding signature (type 0x19) into the hashedPcks for the key (required for signing subkeys). Parameters keyPair:PGPKeyPair public/private key pair. hashedPcks:PGPSignatureSubpacketVector hashed packet values to be included in certification. unhashedPcks:PGPSignatureSubpacketVector unhashed packets values to be included in certification. bindingSignerBldr:PGPContentSignerBuilder provide a signing builder to create the Primary Key signature.

addSubKey

back to summary

public void addSubKey(PGPKeyPair keyPair, PGPSignatureSubpacketVector hashedPcks, PGPSignatureSubpacketVector unhashedPcks, PGPContentSignerBuilder bindingSignerBldr) throws PGPException

Add a subkey with specific hashed and unhashed packets associated with it and default certification. If bindingSignerBldr is not null it will be used to add a Primary Key Binding signature (type 0x19) into the hashedPcks for the key (required for signing subkeys).

Parameters

keyPair:PGPKeyPair: public/private key pair.
hashedPcks:PGPSignatureSubpacketVector: hashed packet values to be included in certification.
unhashedPcks:PGPSignatureSubpacketVector: unhashed packets values to be included in certification.
bindingSignerBldr:PGPContentSignerBuilder: provide a signing builder to create the Primary Key signature.

generatePublicKeyRing	back to summary
public PGPPublicKeyRing generatePublicKeyRing() Return the public key ring that corresponds to the secret key ring. Returns:PGPPublicKeyRing a public key ring.

generatePublicKeyRing

back to summary

public PGPPublicKeyRing generatePublicKeyRing()

Return the public key ring that corresponds to the secret key ring.

Returns:PGPPublicKeyRing: a public key ring.

generateSecretKeyRing	back to summary
public PGPSecretKeyRing generateSecretKeyRing() Return the secret key ring. Returns:PGPSecretKeyRing a secret key ring.

generateSecretKeyRing

back to summary

public PGPSecretKeyRing generateSecretKeyRing()

Return the secret key ring.

Returns:PGPSecretKeyRing: a secret key ring.

public Class PGPKeyRingGenerator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail