org.wildfly.security.x500

Class X500

java.lang.Object

org.wildfly.security.x500.X500

public final class X500
extends Object

Useful X500 constants and utilities.

Author:

David M. Lloyd

Field Summary

Fields

Modifier and Type	Field and Description
static X509Certificate[]	NO_CERTIFICATES A constant array containing zero certificates.
static String	OID_AD
static String	OID_AD_CA_ISSUERS
static String	OID_AD_CA_REPOSITORY
static String	OID_AD_OCSP
static String	OID_AD_TIME_STAMPING
static String	OID_AT
static String	OID_AT_BUSINESS_CATEGORY
static String	OID_AT_COMMON_NAME
static String	OID_AT_COUNTRY_NAME
static String	OID_AT_DESCRIPTION
static String	OID_AT_DN_QUALIFIER
static String	OID_AT_FAX_NUMBER
static String	OID_AT_GENERATION_QUALIFIER
static String	OID_AT_GIVEN_NAME
static String	OID_AT_HOUSE_IDENTIFIER
static String	OID_AT_INITIALS
static String	OID_AT_LOCALITY_NAME
static String	OID_AT_NAME
static String	OID_AT_ORGANIZATION_NAME
static String	OID_AT_ORGANIZATIONAL_UNIT_NAME
static String	OID_AT_PSEUDONYM
static String	OID_AT_SERIAL_NUMBER
static String	OID_AT_STATE_OR_PROVINCE_NAME
static String	OID_AT_STREET_ADDRESS
static String	OID_AT_SURNAME
static String	OID_AT_TELEPHONE_NUMBER
static String	OID_AT_TITLE
static String	OID_CE
static String	OID_CE_AUTHORITY_KEY_IDENTIFIER
static String	OID_CE_BASIC_CONSTRAINTS
static String	OID_CE_CERTIFICATE_ISSUER
static String	OID_CE_CERTIFICATE_POLICIES
static String	OID_CE_CRL_DISTRIBUTION_POINTS
static String	OID_CE_CRL_NUMBER
static String	OID_CE_CRL_REASONS
static String	OID_CE_DELTA_CLR_INDICATOR
static String	OID_CE_EXT_KEY_USAGE
static String	OID_CE_FRESHEST_CRL
static String	OID_CE_HOLD_INSTRUCTION_CODE
static String	OID_CE_INHIBIT_ANY_POLICY
static String	OID_CE_INVALIDITY_DATE
static String	OID_CE_ISSUER_ALT_NAME
static String	OID_CE_ISSUING_DISTRIBUTION_POINT
static String	OID_CE_KEY_USAGE
static String	OID_CE_NAME_CONSTRAINTS
static String	OID_CE_POLICY_CONSTRAINTS
static String	OID_CE_POLICY_MAPPINGS
static String	OID_CE_PRIVATE_KEY_USAGE_PERIOD
static String	OID_CE_SUBJECT_ALT_NAME
static String	OID_CE_SUBJECT_DIRECTORY_ATTRIBUTES
static String	OID_CE_SUBJECT_KEY_IDENTIFIER
static String	OID_DC
static String	OID_HOLD_INSTRUCTION
static String	OID_HOLD_INSTRUCTION_CALL_ISSUER
static String	OID_HOLD_INSTRUCTION_NONE Deprecated.
static String	OID_HOLD_INSTRUCTION_REJECT
static String	OID_KP
static String	OID_KP_CLIENT_AUTH
static String	OID_KP_CODE_SIGNING
static String	OID_KP_EMAIL_PROTECTION
static String	OID_KP_OCSP_SIGNING
static String	OID_KP_SERVER_AUTH
static String	OID_KP_TIME_STAMPING
static String	OID_PE
static String	OID_PE_AUTHORITY_INFO_ACCESS
static String	OID_PE_SUBJECT_INFO_ACCESS
static String	OID_PKIX
static String	OID_QT
static String	OID_QT_CPS
static String	OID_QT_UNOTICE
static String	OID_UID

Method Summary

Modifier and Type	Method and Description
static X509Certificate[]	asOrderedX509CertificateChain(PublicKey firstPublicKey, Certificate[] certificates) Convert an unordered array of certificates into an ordered X.509 certificate chain.
static X509Certificate[]	asX509CertificateArray(Object[] certificates) Convert an array into a X509Certificate[].
static X509Certificate[]	createX509CertificateChain(X509Certificate firstCertificate, HashMap<Principal,HashSet<X509Certificate>> certificatesMap) Create an X.509 certificate chain given the first certificate that should be in the chain and a map of certificates.

Methods inherited from class java.lang.Object

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

Field Detail

NO_CERTIFICATES

public static final X509Certificate[] NO_CERTIFICATES

A constant array containing zero certificates.

OID_AT

public static final String OID_AT

See Also:

Constant Field Values

OID_AT_COMMON_NAME

public static final String OID_AT_COMMON_NAME

See Also:

Constant Field Values

OID_AT_SURNAME

public static final String OID_AT_SURNAME

See Also:

Constant Field Values

OID_AT_SERIAL_NUMBER

public static final String OID_AT_SERIAL_NUMBER

See Also:

Constant Field Values

OID_AT_COUNTRY_NAME

public static final String OID_AT_COUNTRY_NAME

See Also:

Constant Field Values

OID_AT_LOCALITY_NAME

public static final String OID_AT_LOCALITY_NAME

See Also:

Constant Field Values

OID_AT_STATE_OR_PROVINCE_NAME

public static final String OID_AT_STATE_OR_PROVINCE_NAME

See Also:

Constant Field Values

OID_AT_STREET_ADDRESS

public static final String OID_AT_STREET_ADDRESS

See Also:

Constant Field Values

OID_AT_ORGANIZATION_NAME

public static final String OID_AT_ORGANIZATION_NAME

See Also:

Constant Field Values

OID_AT_ORGANIZATIONAL_UNIT_NAME

public static final String OID_AT_ORGANIZATIONAL_UNIT_NAME

See Also:

Constant Field Values

OID_AT_TITLE

public static final String OID_AT_TITLE

See Also:

Constant Field Values

OID_AT_DESCRIPTION

public static final String OID_AT_DESCRIPTION

See Also:

Constant Field Values

OID_AT_BUSINESS_CATEGORY

public static final String OID_AT_BUSINESS_CATEGORY

See Also:

Constant Field Values

OID_AT_TELEPHONE_NUMBER

public static final String OID_AT_TELEPHONE_NUMBER

See Also:

Constant Field Values

OID_AT_FAX_NUMBER

public static final String OID_AT_FAX_NUMBER

See Also:

Constant Field Values

OID_AT_NAME

public static final String OID_AT_NAME

See Also:

Constant Field Values

OID_AT_GIVEN_NAME

public static final String OID_AT_GIVEN_NAME

See Also:

Constant Field Values

OID_AT_INITIALS

public static final String OID_AT_INITIALS

See Also:

Constant Field Values

OID_AT_GENERATION_QUALIFIER

public static final String OID_AT_GENERATION_QUALIFIER

See Also:

Constant Field Values

OID_AT_DN_QUALIFIER

public static final String OID_AT_DN_QUALIFIER

See Also:

Constant Field Values

OID_AT_HOUSE_IDENTIFIER

public static final String OID_AT_HOUSE_IDENTIFIER

See Also:

Constant Field Values

OID_AT_PSEUDONYM

public static final String OID_AT_PSEUDONYM

See Also:

Constant Field Values

OID_UID

public static final String OID_UID

See Also:

Constant Field Values

OID_DC

public static final String OID_DC

See Also:

Constant Field Values

OID_CE

public static final String OID_CE

See Also:

Constant Field Values

OID_CE_SUBJECT_DIRECTORY_ATTRIBUTES

public static final String OID_CE_SUBJECT_DIRECTORY_ATTRIBUTES

See Also:

Constant Field Values

OID_CE_SUBJECT_KEY_IDENTIFIER

public static final String OID_CE_SUBJECT_KEY_IDENTIFIER

See Also:

Constant Field Values

OID_CE_KEY_USAGE

public static final String OID_CE_KEY_USAGE

See Also:

Constant Field Values

OID_CE_PRIVATE_KEY_USAGE_PERIOD

public static final String OID_CE_PRIVATE_KEY_USAGE_PERIOD

See Also:

Constant Field Values

OID_CE_SUBJECT_ALT_NAME

public static final String OID_CE_SUBJECT_ALT_NAME

See Also:

Constant Field Values

OID_CE_ISSUER_ALT_NAME

public static final String OID_CE_ISSUER_ALT_NAME

See Also:

Constant Field Values

OID_CE_BASIC_CONSTRAINTS

public static final String OID_CE_BASIC_CONSTRAINTS

See Also:

Constant Field Values

OID_CE_CRL_NUMBER

public static final String OID_CE_CRL_NUMBER

See Also:

Constant Field Values

OID_CE_CRL_REASONS

public static final String OID_CE_CRL_REASONS

See Also:

Constant Field Values

OID_CE_HOLD_INSTRUCTION_CODE

public static final String OID_CE_HOLD_INSTRUCTION_CODE

See Also:

Constant Field Values

OID_CE_INVALIDITY_DATE

public static final String OID_CE_INVALIDITY_DATE

See Also:

Constant Field Values

OID_CE_DELTA_CLR_INDICATOR

public static final String OID_CE_DELTA_CLR_INDICATOR

See Also:

Constant Field Values

OID_CE_ISSUING_DISTRIBUTION_POINT

public static final String OID_CE_ISSUING_DISTRIBUTION_POINT

See Also:

Constant Field Values

OID_CE_CERTIFICATE_ISSUER

public static final String OID_CE_CERTIFICATE_ISSUER

See Also:

Constant Field Values

OID_CE_NAME_CONSTRAINTS

public static final String OID_CE_NAME_CONSTRAINTS

See Also:

Constant Field Values

OID_CE_CRL_DISTRIBUTION_POINTS

public static final String OID_CE_CRL_DISTRIBUTION_POINTS

See Also:

Constant Field Values

OID_CE_CERTIFICATE_POLICIES

public static final String OID_CE_CERTIFICATE_POLICIES

See Also:

Constant Field Values

OID_CE_POLICY_MAPPINGS

public static final String OID_CE_POLICY_MAPPINGS

See Also:

Constant Field Values

OID_CE_AUTHORITY_KEY_IDENTIFIER

public static final String OID_CE_AUTHORITY_KEY_IDENTIFIER

See Also:

Constant Field Values

OID_CE_POLICY_CONSTRAINTS

public static final String OID_CE_POLICY_CONSTRAINTS

See Also:

Constant Field Values

OID_CE_EXT_KEY_USAGE

public static final String OID_CE_EXT_KEY_USAGE

See Also:

Constant Field Values

OID_CE_FRESHEST_CRL

public static final String OID_CE_FRESHEST_CRL

See Also:

Constant Field Values

OID_CE_INHIBIT_ANY_POLICY

public static final String OID_CE_INHIBIT_ANY_POLICY

See Also:

Constant Field Values

OID_PKIX

public static final String OID_PKIX

See Also:

Constant Field Values

OID_PE

public static final String OID_PE

See Also:

Constant Field Values

OID_QT

public static final String OID_QT

See Also:

Constant Field Values

OID_KP

public static final String OID_KP

See Also:

Constant Field Values

OID_AD

public static final String OID_AD

See Also:

Constant Field Values

OID_PE_AUTHORITY_INFO_ACCESS

public static final String OID_PE_AUTHORITY_INFO_ACCESS

See Also:

Constant Field Values

OID_PE_SUBJECT_INFO_ACCESS

public static final String OID_PE_SUBJECT_INFO_ACCESS

See Also:

Constant Field Values

OID_QT_CPS

public static final String OID_QT_CPS

See Also:

Constant Field Values

OID_QT_UNOTICE

public static final String OID_QT_UNOTICE

See Also:

Constant Field Values

OID_KP_SERVER_AUTH

public static final String OID_KP_SERVER_AUTH

See Also:

Constant Field Values

OID_KP_CLIENT_AUTH

public static final String OID_KP_CLIENT_AUTH

See Also:

Constant Field Values

OID_KP_CODE_SIGNING

public static final String OID_KP_CODE_SIGNING

See Also:

Constant Field Values

OID_KP_EMAIL_PROTECTION

public static final String OID_KP_EMAIL_PROTECTION

See Also:

Constant Field Values

OID_KP_TIME_STAMPING

public static final String OID_KP_TIME_STAMPING

See Also:

Constant Field Values

OID_KP_OCSP_SIGNING

public static final String OID_KP_OCSP_SIGNING

See Also:

Constant Field Values

OID_AD_OCSP

public static final String OID_AD_OCSP

See Also:

Constant Field Values

OID_AD_CA_ISSUERS

public static final String OID_AD_CA_ISSUERS

See Also:

Constant Field Values

OID_AD_TIME_STAMPING

public static final String OID_AD_TIME_STAMPING

See Also:

Constant Field Values

OID_AD_CA_REPOSITORY

public static final String OID_AD_CA_REPOSITORY

See Also:

Constant Field Values

OID_HOLD_INSTRUCTION

public static final String OID_HOLD_INSTRUCTION

See Also:

Constant Field Values

OID_HOLD_INSTRUCTION_NONE

@Deprecated
public static final String OID_HOLD_INSTRUCTION_NONE

Deprecated.

See Also:

Constant Field Values

OID_HOLD_INSTRUCTION_CALL_ISSUER

public static final String OID_HOLD_INSTRUCTION_CALL_ISSUER

See Also:

Constant Field Values

OID_HOLD_INSTRUCTION_REJECT

public static final String OID_HOLD_INSTRUCTION_REJECT

See Also:

Constant Field Values

Method Detail

asX509CertificateArray

public static X509Certificate[] asX509CertificateArray(Object[] certificates)
                                                throws ArrayStoreException

Convert an array into a X509Certificate[].

Parameters:

certificates - the certificates (may not be null)

Returns:

the X.509 certificate array (not null)

Throws:

ArrayStoreException - if one of the certificates in the array is not an X509Certificate

asOrderedX509CertificateChain

public static X509Certificate[] asOrderedX509CertificateChain(PublicKey firstPublicKey,
                                                              Certificate[] certificates)
                                                       throws IllegalArgumentException

Convert an unordered array of certificates into an ordered X.509 certificate chain.

Parameters:

firstPublicKey - the public key that should be in the first certificate in the ordered X.509 certificate chain (may not be null)

certificates - the unordered array of certificates (may not be null)

Returns:

the ordered X.509 certificate chain, as an array

Throws:

IllegalArgumentException - if the given unordered array of certificates cannot be converted into an ordered X.509 certificate chain

createX509CertificateChain

public static X509Certificate[] createX509CertificateChain(X509Certificate firstCertificate,
                                                           HashMap<Principal,HashSet<X509Certificate>> certificatesMap)
                                                    throws IllegalArgumentException

Create an X.509 certificate chain given the first certificate that should be in the chain and a map of certificates.

Parameters:

firstCertificate - the certificate that should be first in the newly created X.509 certificate chain

certificatesMap - a map of distinguished names to certificates to use to create the X.509 certificate chain

Returns:

the newly created X.509 certificate chain, as an array

Throws:

IllegalArgumentException - if the X.509 certificate chain could not be created