org.opensaml.security.x509

Class BasicX509Credential

java.lang.Object

org.opensaml.security.credential.AbstractCredential

org.opensaml.security.credential.BasicCredential

org.opensaml.security.x509.BasicX509Credential

All Implemented Interfaces:

Credential, MutableCredential, X509Credential

public class BasicX509Credential
extends BasicCredential
implements X509Credential

A basic implementation of X509Credential.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Collection<java.security.cert.X509CRL>	crls CRLs for this credential.
private java.security.cert.X509Certificate	entityCert Entity certificate.
private java.util.Collection<java.security.cert.X509Certificate>	entityCertChain Entity certificate chain, must include entity certificate.

Constructor Summary

Constructors

Constructor and Description
BasicX509Credential(java.security.cert.X509Certificate entityCertificate) Constructor.
BasicX509Credential(java.security.cert.X509Certificate entityCertificate, java.security.PrivateKey privateKey) Constructor.

Method Summary

Modifier and Type	Method and Description
java.lang.Class<? extends Credential>	getCredentialType() Get the primary type of the credential instance.
java.util.Collection<java.security.cert.X509CRL>	getCRLs() Gets a collection of CRLs associated with the credential.
java.security.cert.X509Certificate	getEntityCertificate() Gets the public key certificate for the entity.
java.util.Collection<java.security.cert.X509Certificate>	getEntityCertificateChain() Gets an immutable collection of certificates in the entity's trust chain.
java.security.PublicKey	getPublicKey() Gets the public key for the entity.
javax.crypto.SecretKey	getSecretKey() This operation is unsupported for X.509 credentials.
void	setCRLs(java.util.Collection<java.security.cert.X509CRL> newCRLs) Sets the CRLs for this credential.
void	setEntityCertificate(java.security.cert.X509Certificate newEntityCertificate) Sets the entity certificate for this credential.
void	setEntityCertificateChain(java.util.Collection<java.security.cert.X509Certificate> newCertificateChain) Sets the entity certificate chain for this credential.
void	setPublicKey(java.security.PublicKey newPublicKey) This operation is unsupported for X.509 credentials.
void	setSecretKey(javax.crypto.SecretKey newSecretKey) This operation is unsupported for X.509 credentials.

Methods inherited from class org.opensaml.security.credential.BasicCredential

setEntityId, setPrivateKey, setUsageType

Methods inherited from class org.opensaml.security.credential.AbstractCredential

getCredentialContextSet, getEntityId, getKeyNames, getPrivateKey, getUsageType

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opensaml.security.credential.Credential

getCredentialContextSet, getEntityId, getKeyNames, getPrivateKey, getUsageType

Field Detail

entityCert

private java.security.cert.X509Certificate entityCert

Entity certificate.

entityCertChain

private java.util.Collection<java.security.cert.X509Certificate> entityCertChain

Entity certificate chain, must include entity certificate.

crls

private java.util.Collection<java.security.cert.X509CRL> crls

CRLs for this credential.

Constructor Detail

BasicX509Credential

public BasicX509Credential(@Nonnull
                           java.security.cert.X509Certificate entityCertificate)

Constructor.

Parameters:

entityCertificate - the credential entity certificate

BasicX509Credential

public BasicX509Credential(@Nonnull
                           java.security.cert.X509Certificate entityCertificate,
                           @Nonnull
                           java.security.PrivateKey privateKey)

Constructor.

Parameters:

entityCertificate - the credential entity certificate

privateKey - the credential private key

Method Detail

getCredentialType

@Nonnull
public java.lang.Class<? extends Credential> getCredentialType()

Get the primary type of the credential instance. This will usually be the primary sub-interface of Credential implemented by an implementation.

Specified by:

getCredentialType in interface Credential

Overrides:

getCredentialType in class BasicCredential

Returns:

the credential type

getCRLs

@Nullable
public java.util.Collection<java.security.cert.X509CRL> getCRLs()

Gets a collection of CRLs associated with the credential.

Specified by:

getCRLs in interface X509Credential

Returns:

CRLs associated with the credential

setCRLs

public void setCRLs(@Nullable
                    java.util.Collection<java.security.cert.X509CRL> newCRLs)

Sets the CRLs for this credential.

Parameters:

newCRLs - CRLs for this credential

getEntityCertificate

@Nonnull
public java.security.cert.X509Certificate getEntityCertificate()

Gets the public key certificate for the entity. The public key of this certificate will be the same key obtained from Credential.getPublicKey().

Specified by:

getEntityCertificate in interface X509Credential

Returns:

the public key certificate for the entity

setEntityCertificate

public void setEntityCertificate(@Nonnull
                                 java.security.cert.X509Certificate newEntityCertificate)

Sets the entity certificate for this credential.

Parameters:

newEntityCertificate - entity certificate for this credential

getPublicKey

@Nonnull
public java.security.PublicKey getPublicKey()

Gets the public key for the entity.

Specified by:

getPublicKey in interface Credential

Overrides:

getPublicKey in class AbstractCredential

Returns:

public key for the entity

setPublicKey

public void setPublicKey(java.security.PublicKey newPublicKey)

This operation is unsupported for X.509 credentials. The public key will be retrieved automatically from the entity certificate.

Specified by:

setPublicKey in interface MutableCredential

Overrides:

setPublicKey in class BasicCredential

Parameters:

newPublicKey - not supported

getEntityCertificateChain

@Nonnull
public java.util.Collection<java.security.cert.X509Certificate> getEntityCertificateChain()

Gets an immutable collection of certificates in the entity's trust chain. The entity certificate is contained within this list. No specific ordering of the certificates is guaranteed.

Specified by:

getEntityCertificateChain in interface X509Credential

Returns:

entities certificate chain

setEntityCertificateChain

public void setEntityCertificateChain(@Nonnull
                                      java.util.Collection<java.security.cert.X509Certificate> newCertificateChain)

Sets the entity certificate chain for this credential. This MUST include the entity certificate.

Parameters:

newCertificateChain - entity certificate chain for this credential

getSecretKey

@Nullable
public javax.crypto.SecretKey getSecretKey()

This operation is unsupported for X.509 credentials.

Specified by:

getSecretKey in interface Credential

Overrides:

getSecretKey in class AbstractCredential

Returns:

null

setSecretKey

public void setSecretKey(javax.crypto.SecretKey newSecretKey)

This operation is unsupported for X.509 credentials.

Specified by:

setSecretKey in interface MutableCredential

Overrides:

setSecretKey in class BasicCredential

Parameters:

newSecretKey - unsupported