Develop the WSPKIClient interface for communicating with a certificate authority
Implementing the WSPKIClient interface enables WAS security to communicate with a remote certificate authority (CA).
- Initialize the WSPKIClient method, with init(java.util.HashMap).
public void init(java.util.HashMap initAttrs) throws WSPKIException;
This method is called by WAS runtime to set up connection information to a CA.
- • Request a certificate with requestCertificate(byte[], X500Principal, byte[], java.util.HashMap).
public X509Certificate[] requestCertificate(byte[] certReq, X500Principal SubjectDN, byte[] revocationPassword, java.util.HashMap customAttrs) throws WSPKIException;
This method is called by WAS runtime to connect to a CA and requests a certificate signed by the authority. A X509Certificate[] is returned if the requested certificate is created. If a null is returned then queryCertificate() is called to check if the certificate is ready. This method is used when the CA requires manual intervention to process a certificate request.
We can invoke this operation from the console using the Create a CA certificate in SSL task and from a client using the requestCertificate script.
- • Revoke a certificate with revokeCertificate(X509Certiifcate[], byte[], String, java.util.HashMap).
public void revokeCertificate(X509Certificate[] cert, byte[] revocationPassword, String revocationReason, java.util.HashMap customAttrs) throws WSPKIException;
This method called by WAS runtime to submit a request to a CA to revoke a certificate.
We can invoke this operation from the console using the revoke CA certificate task, Revoking a CA certificate in SSL, or using the revokeCertificate script.
- • Query a certificate with queryCertificate(X509Certiifcate[], byte[], java.util.HashMap).
public X509Certificate[] queryCertificate(byte[] certReq, java.util.HashMap customAttrs) throws WSPKIException;
This method is called by WAS runtime to query if certificate creation is completed on the CA. A X509Certificate[] is returned if certificate request is complete. A null is returned if the certificate request is pending.
You perform this operation from the console using the Query (link to was6445.html) option, see Personal certificate requests collectionand from a client using the queryCertificate script.
Results
the WSPKIClient interface for communicating with a certificate authority (CA) is implemented.
Related tasks
Create a Secure Sockets Layer configuration Create a CA certificate in SSL Revoking a CA certificate in SSL
requestCertificate command revokeCertificate command queryCertificate command createCertRequest command