com.oracle.crypto.cert

Class X509CertificateBuilder

java.lang.Object

com.oracle.crypto.cert.X509CertificateBuilder

public class X509CertificateBuilder
extends java.lang.Object

A class for building a X.509v3 self-signed certificate.

Constructor Summary

Constructors

Constructor and Description
X509CertificateBuilder(KeyPair keyPair) Constructs a certificate builder with the KeyPair object.

Method Summary

Methods

Modifier and Type	Method and Description
X509Certificate	create() Creates a X509Certificate with the arguments supplied to this builder.
X509CertificateBuilder	setExtendedKeyUsage(boolean isCritical, X509Certificate.ExtendedKeyUsage... usages) Sets extended key usage extension.
X509CertificateBuilder	setKeyUsage(boolean isCritical, X509Certificate.KeyUsage... usages) Sets key usage extension.
X509CertificateBuilder	setSerialNumber(java.lang.String serial) Sets the serial number in printable form.
X509CertificateBuilder	setSubject(java.lang.String subject) Sets the name of subject.
X509CertificateBuilder	setValidityInDays(int days) Sets the validity period in days.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

X509CertificateBuilder

public X509CertificateBuilder(KeyPair keyPair)
                       throws X509CertificateBuilderException

Constructs a certificate builder with the KeyPair object.

Parameters:

keyPair - the KeyPair object which is generated from KeyPairGenerator.

Throws:

X509CertificateBuilderException - if initialization fails.

Method Detail

create

public X509Certificate create()
                       throws X509CertificateBuilderException

Creates a X509Certificate with the arguments supplied to this builder.

Returns:

a X.509 X509Certificatecode> object.

Throws:

X509CertificateBuilderException - if the certificate generation fails.

See Also:

X509Certificate

setSubject

public X509CertificateBuilder setSubject(java.lang.String subject)
                                  throws java.lang.IllegalArgumentException

Sets the name of subject. The subject name should be formatted as a string using the printable distinguished name described in Certificate class.

Parameters:

subject - the name of subject. For example, C=US;O=AnyCompany;CN=www.anycompany.com

Returns:

a reference to this object

Throws:

java.lang.IllegalArgumentException - in case of subject is null.

See Also:

Certificate

setValidityInDays

public X509CertificateBuilder setValidityInDays(int days)
                                         throws java.lang.IllegalArgumentException

Sets the validity period in days. The default value of validity period is 90 days.

Parameters:

days - the validity period in days

Returns:

a reference to this object

Throws:

java.lang.IllegalArgumentException - in case of days is less than or equal to 0.

setSerialNumber

public X509CertificateBuilder setSerialNumber(java.lang.String serial)
                                       throws java.lang.IllegalArgumentException

Sets the serial number in printable form.

Parameters:

serial - the serial number in printable form, i.e. represented as string with each byte as two hex digits separated by ":", For example, 0C:56:FA:80.

Returns:

a reference to this object

Throws:

java.lang.IllegalArgumentException - in case if serial has format different from xx:xx:xx:xx

See Also:

Certificate.getSerialNumber()

setKeyUsage

public X509CertificateBuilder setKeyUsage(boolean isCritical,
                                 X509Certificate.KeyUsage... usages)

Sets key usage extension.

Parameters:

isCritical - marks 'key usage' extension as critical or non-critical

usages - key usage extension

Returns:

a reference to this object

setExtendedKeyUsage

public X509CertificateBuilder setExtendedKeyUsage(boolean isCritical,
                                         X509Certificate.ExtendedKeyUsage... usages)

Sets extended key usage extension.

Parameters:

isCritical - marks 'extended key usage' extension as critical or non-critical

usages - extended key usage extension

Returns:

a reference to this object