com.iplanet.trustbase.initiator.dsms
Interface ProtocolAdapter

public interface ProtocolAdapter

The protocol adapter is responsible for performing a request under a given protocol. The currently implemented protocols are Identrus and OCSP. As with the MessageFactory's implementations must provide a constructor which takes as its single parameter a ConfigAdapter. If they do not provide one an exception will be thrown at run-time.

See Also:

ProtocolAdapterFactory, ConfigAdapter, ConfigAdapterException, TransportAdapterException, TransportAdapter, CSCProtocolException, StatusCheckData

Method Summary

StatusCheckData[]	getStatus(java.security.cert.X509Certificate[] certificatePath, boolean acquireProof, boolean generateNonce, java.lang.StringBuffer nonceValue) Check the status of a given certificate and return the results.
boolean	validateStatus(StatusCheckData[] status, java.security.cert.X509Certificate[] certificatePath, boolean acquireProof, byte[] nonceValue) Validate the status's provided - which will have been produced as the result of a preceeding check.

Method Detail

getStatus

public StatusCheckData[] getStatus(java.security.cert.X509Certificate[] certificatePath,
                                   boolean acquireProof,
                                   boolean generateNonce,
                                   java.lang.StringBuffer nonceValue)
                            throws CSCProtocolException,
                                   ConfigAdapterException,
                                   CSCMessageException,
                                   TransportAdapterException

Check the status of a given certificate and return the results.

Parameters:

certificatePath - The certificate path to check.

acquireProof - Whether or not acquire proof responses for the signing certificate used in the main responses. All configuration information should be retrieved from the CSCConfigAdapter that is supplied during construction.

generateNonce - whether or not to allow the system to generate a nonce.

nonceValue - if generateNonce is set to false then this is used as the nonce value - if it is null no nonce is used. If generate nonce is true then this is filled out with the nonce that was generated.

Returns:

The array of status's that the check produced.

Throws:

ConfigAdapterException -

TransportAdapterException -

CSCProtocolException -

CSCMessageException -

validateStatus

public boolean validateStatus(StatusCheckData[] status,
                              java.security.cert.X509Certificate[] certificatePath,
                              boolean acquireProof,
                              byte[] nonceValue)
                       throws CSCProtocolException,
                              ConfigAdapterException,
                              CSCMessageException,
                              TransportAdapterException

Validate the status's provided - which will have been produced as the result of a preceeding check. A given protocol is free define what criteria it considers "valid".

Parameters:

status - the status's of the certificates.

certificatePath - the certificate path that was checked when these status's where produced.

acquireProof - whether or not a proof of the signer's was required.

nonceValue - the nonce value that was sent in the request.

Returns:

boolean valid or not?

Throws:

CSCProtocolException -

CConfigAdapterException -

TransportAdapterException -

CSCMessageException -