es.accv.arangi.base.certificate.validation

Class OCSPResponse

java.lang.Object

es.accv.arangi.base.ArangiObject

es.accv.arangi.base.certificate.validation.OCSPResponse

public class OCSPResponse
extends ArangiObject

Clase que representa una respuesta OCSP de acuerdo a la especificación indicada en el punto 4.2.1. de la RFC-2560. Concretamente esta clase envuelve a una respuesta que contiene una respuesta básica OCSP: BasicOCSPResponse.

Author:

José M Gutiérrez

Field Summary

Fields inherited from class es.accv.arangi.base.ArangiObject

arangiTemporalFolder, CRYPTOGRAPHIC_PROVIDER, CRYPTOGRAPHIC_PROVIDER_NAME, DEFAULT_HASHING_ALGORITHM, DEFAULT_SIGNING_ALGORITHM, NUM_RETRIES

Constructor Summary

Constructors

Constructor and Description
OCSPResponse(byte[] bytesOCSPResponse) Constructor que inicializa el objeto a partir de un array de bytes con el contenido de la respuesta OCSP.
OCSPResponse(java.io.File fileOCSPResponse) Constructor que inicializa el objeto a partir de un fichero que contiene la respuesta OCSP.
OCSPResponse(java.io.InputStream isOCSPResponse) Constructor que inicializa el objeto a partir de un stream de lectura que apunta al contenido de la respuesta OCSP.
OCSPResponse(org.bouncycastle.cert.ocsp.OCSPResp ocspResponse) Constructor que inicializa el objeto a partir de una respuesta OCSP.

Method Summary

Methods

Modifier and Type	Method and Description
org.bouncycastle.cert.ocsp.BasicOCSPResp	getBasicOCSPResponse() Obtiene la respuesta básica contenida en la respuesta.
java.lang.String	getResponderIdKeyHash() Obtiene el valor contenido en el ResponderID de la respuesta OCSP si es un KeyHash.
java.lang.String	getResponderIdName() Obtiene el valor contenido en el ResponderID de la respuesta OCSP si es un X500Name.
static CertificateOCSPResponse[]	getResponses(org.bouncycastle.cert.ocsp.BasicOCSPResp basicOcspResponse) Obtiene la lista de respuestas contenidas en la respuesta OCSP: una por cada certificado que se mandó validar cuando se hizo la llamada al servidor OCSP.
Certificate	getSignatureCertificate() Obtiene el certificado con el que se firmó la respuesta OCSP
static Certificate	getSignatureCertificate(org.bouncycastle.cert.ocsp.BasicOCSPResp basicOcspResponse) Obtiene el certificado con el que se firmó la respuesta OCSP que se pasa como parámetro
CertificateOCSPResponse[]	getSingleResponses() Obtiene las respuestas individuales para cada certificado del que se pidió su estado.
int	getStatus() Devuelve el estado de la respuesta, que será alguna de las siguientes constantes de la clase CertificateValidator: RESULT_CERTIFICATE_VALID: El certificado es válido.
int	getStatus(ValidateCertificate certificate) Devuelve el estado de la respuesta para el certificado que se pasa como parámetro, que será alguna de las siguientes constantes de la clase CertificateValidator: RESULT_CERTIFICATE_VALID: El certificado es válido.
boolean	isSignatureValid() Comprueba la firma de una respuesta OCSP.
byte[]	toDER() Obtiene el contenido de la respuesta OCSP de forma que puede ser guardada.

Methods inherited from class es.accv.arangi.base.ArangiObject

getArangiTemporalFolder, getCryptographicProvider, saveTemporalFile, saveToArangiTemporalFolder

Methods inherited from class java.lang.Object

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

Constructor Detail

OCSPResponse

public OCSPResponse(org.bouncycastle.cert.ocsp.OCSPResp ocspResponse)
             throws MalformedOCSPResponseException

Constructor que inicializa el objeto a partir de una respuesta OCSP.

Parameters:

ocspResponse - Respuesta OCSP

Throws:

MalformedOCSPResponseException - La respuesta OCSP no contiene una respuesta OCSP básica

OCSPResponse

public OCSPResponse(java.io.File fileOCSPResponse)
             throws MalformedOCSPResponseException,
                    java.io.FileNotFoundException

Constructor que inicializa el objeto a partir de un fichero que contiene la respuesta OCSP.

Parameters:

fileOCSPResponse - Fichero que contiene la respuesta OCSP

Throws:

MalformedOCSPResponseException - El contenido no se corresponde con una respuesta OCSP o no puede ser leído

java.io.FileNotFoundException - El fichero no existe

OCSPResponse

public OCSPResponse(byte[] bytesOCSPResponse)
             throws MalformedOCSPResponseException

Constructor que inicializa el objeto a partir de un array de bytes con el contenido de la respuesta OCSP.

Parameters:

bytesOCSPResponse - Array de bytes con el contenido de la respuesta OCSP

Throws:

MalformedOCSPResponseException - El contenido no se corresponde con una respuesta OCSP

OCSPResponse

public OCSPResponse(java.io.InputStream isOCSPResponse)
             throws MalformedOCSPResponseException

Constructor que inicializa el objeto a partir de un stream de lectura que apunta al contenido de la respuesta OCSP.

Parameters:

isOCSPResponse - Stream de lectura al contenido de la respuesta OCSP

Throws:

MalformedOCSPResponseException - El contenido no se corresponde con una respuesta OCSP o no puede ser leído

Method Detail

isSignatureValid

public boolean isSignatureValid()

Comprueba la firma de una respuesta OCSP. Este método sólo comprueba que los datos firmados no han sido modificados desde su firma.

Returns:

Cierto si no se han modificado los datos de la respuesta OCSP

getSignatureCertificate

public Certificate getSignatureCertificate()

Obtiene el certificado con el que se firmó la respuesta OCSP

Returns:

Certificado de firma de la respuesta OCSP

getSingleResponses

public CertificateOCSPResponse[] getSingleResponses()

Obtiene las respuestas individuales para cada certificado del que se pidió su estado.

Returns:

Respuestas individuales dentro de la respuesta OCSP

getStatus

public int getStatus(ValidateCertificate certificate)

Devuelve el estado de la respuesta para el certificado que se pasa como parámetro, que será alguna de las siguientes constantes de la clase CertificateValidator:

• RESULT_CERTIFICATE_VALID: El certificado es válido.
• RESULT_CERTIFICATE_REVOKED: El certificado está revocado
• RESULT_CERTIFICATE_UNKNOWN: El certificado es desconocido para el OCSP
• RESULT_CERTIFICATE_CANNOT_BE_VALIDATED: No hay ninguna respuesta para el certificado

Parameters:

certificate - Certificado que originó la respuesta OCSP

Returns:

Estado de la respuesta

getStatus

public int getStatus()

Devuelve el estado de la respuesta, que será alguna de las siguientes constantes de la clase CertificateValidator:

• RESULT_CERTIFICATE_VALID: El certificado es válido.
• RESULT_CERTIFICATE_REVOKED: El certificado está revocado
• RESULT_CERTIFICATE_UNKNOWN: El certificado es desconocido para el OCSP
• RESULT_CERTIFICATE_CANNOT_BE_VALIDATED: No hay ninguna respuesta

Si la petición OCSP incluía varios certificados, habrán varias respuestas en este objeto. En este caso es mejor utilizar el método getStatus pasándole el certificado del que se quiere conocer la respuesta.

Returns:

Estado de la primera respuesta contenida en este objeto

getResponderIdName

public java.lang.String getResponderIdName()

Obtiene el valor contenido en el ResponderID de la respuesta OCSP si es un X500Name.

Returns:

ResponderID de la respuesta OCSP si es un X500Name. Si es un keyhash devuelve null;

getResponderIdKeyHash

public java.lang.String getResponderIdKeyHash()

Obtiene el valor contenido en el ResponderID de la respuesta OCSP si es un KeyHash.

Returns:

ResponderID de la respuesta OCSP si es un KeyHash. Si es un X509Name devuelve null;

toDER

public byte[] toDER()

Obtiene el contenido de la respuesta OCSP de forma que puede ser guardada.

Returns:

Contenido de la respuesta OCSP

getBasicOCSPResponse

public org.bouncycastle.cert.ocsp.BasicOCSPResp getBasicOCSPResponse()

Obtiene la respuesta básica contenida en la respuesta. En algunos tipos de firma es esta respuesta la que se guarda como respuesta OCSP.

Returns:

Respuesta OCSP básica

getResponses

public static CertificateOCSPResponse[] getResponses(org.bouncycastle.cert.ocsp.BasicOCSPResp basicOcspResponse)

Obtiene la lista de respuestas contenidas en la respuesta OCSP: una por cada certificado que se mandó validar cuando se hizo la llamada al servidor OCSP.

Parameters:

basicOcspResponse - Respuesta básica OCSP

Returns:

Array de respuestas contenidas en la respuesta OCSP

getSignatureCertificate

public static Certificate getSignatureCertificate(org.bouncycastle.cert.ocsp.BasicOCSPResp basicOcspResponse)

Obtiene el certificado con el que se firmó la respuesta OCSP que se pasa como parámetro

Parameters:

basicOcspResponse - Respuesta básica OCSP

Returns:

Certificado de firma de la respuesta OCSP