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

Method Summary

Modifier and Type	Method	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 Details

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 Details

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