All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.ibm.as400.access.AS400CertificateVldlUtil

java.lang.Object
   |
   +----com.ibm.as400.access.AS400CertificateUtil
           |
           +----com.ibm.as400.access.AS400CertificateVldlUtil

public class AS400CertificateVldlUtil
extends AS400CertificateUtil
implements Serializable

The AS400CertificateVldlUtil class provides the implementation of the methods for accessing certificates in an AS400 validation list object.


Constructor Index

 o AS400CertificateVldlUtil()
Constructs an AS400CertificateVldlUtil object.
 o AS400CertificateVldlUtil(AS400, String)
Constructs an AS400CertificateVldlUtil object.

Method Index

 o addCertificate(byte[])
Add the certificate to the repository.
 o checkCertificate(byte[])
Determines if the certificate is in the validation list.
 o checkCertificateByHandle(byte[])
Determines if a certificate matching the handle exists in the validation list.
 o deleteCertificate(byte[])
Deletes the certificate from the validation list.
 o deleteCertificateByHandle(byte[])
Deletes the certificate matching the certificate handle from the validation list.
 o listCertificates(AS400CertificateAttribute[], String)
Lists certificates which match the specified attributes are copied from the validation list into the specified user space.
 o setPath(String)
Sets the path for the validation list.

Constructors

 o AS400CertificateVldlUtil
 public AS400CertificateVldlUtil()
Constructs an AS400CertificateVldlUtil object.

 o AS400CertificateVldlUtil
 public AS400CertificateVldlUtil(AS400 system,
                                 String path)
Constructs an AS400CertificateVldlUtil object.

Parameters:
system - The AS/400 system on which the validation list exists.
path - The fully qualified integrated file system path name of the validation list. For example, /QSYS.LIB/MYLIB.LIB/MYVLDL.VLDL.

Methods

 o addCertificate
 public void addCertificate(byte certificate[]) throws AS400SecurityException, ErrorCompletingRequestException, ExtendedIOException, InterruptedException, IOException, ObjectDoesNotExistException
Add the certificate to the repository. Throws an ExtendedIOException if the certificate is already a member of the repository.

Parameters:
certificate - The complete ASN.1 X.509 certificate to be added to the validation list.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: ExtendedIllegalArgumentException
If invalid certificate.
Throws: ExtendedIOException
If certificate already added and other AS400 certificate access errors.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS400 object does not exist.
Overrides:
addCertificate in class AS400CertificateUtil
 o checkCertificate
 public boolean checkCertificate(byte certificate[]) throws AS400SecurityException, ErrorCompletingRequestException, ExtendedIOException, InterruptedException, IOException, ObjectDoesNotExistException
Determines if the certificate is in the validation list.

Parameters:
certificate - The ASN.1 encoded X.509 certificate to search for in the validation list.
Returns:
true if the certificate is found in the validation list; false otherwise.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: ExtendedIllegalArgumentException
If invalid certificate.
Throws: ExtendedIOException
If other AS400 certificate access errors.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS400 object does not exist.
 o checkCertificateByHandle
 public boolean checkCertificateByHandle(byte certificateHandle[]) throws AS400SecurityException, ErrorCompletingRequestException, ExtendedIOException, InterruptedException, IOException, ObjectDoesNotExistException
Determines if a certificate matching the handle exists in the validation list.

Parameters:
certificateHandle - The AS400 certificate handle matching the certificate.
Returns:
true if a certificate matching the handle is found in the validation list; false otherwise.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: ExtendedIllegalArgumentException
If invalid certificate handle.
Throws: ExtendedIOException
If other AS400 certificate access errors.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS400 object does not exist.
 o deleteCertificate
 public void deleteCertificate(byte certificate[]) throws AS400SecurityException, ErrorCompletingRequestException, ExtendedIOException, InterruptedException, IOException, ObjectDoesNotExistException
Deletes the certificate from the validation list. Throws an ExtendedIOException if the certificate is not present in the validation list.

Parameters:
certificate - The complete ASN.1 X.509 Certificate to be deleted from the repository.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: ExtendedIllegalArgumentException
If invalid certificate.
Throws: ExtendedIOException
If certificate not found and other AS400 certificate access errors.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS400 object does not exist.
Overrides:
deleteCertificate in class AS400CertificateUtil
 o deleteCertificateByHandle
 public void deleteCertificateByHandle(byte certificateHandle[]) throws AS400SecurityException, ErrorCompletingRequestException, ExtendedIOException, InterruptedException, IOException, ObjectDoesNotExistException
Deletes the certificate matching the certificate handle from the validation list. Throws ExtendedIOException if the certificate is not present in the repository.

Parameters:
certificateHandle - The AS400 certificate handle matching the certificate to be deleted from the repository.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: ExtendedIllegalArgumentException
If invalid certificate handle.
Throws: ExtendedIOException
If certificate not found and other AS400 certificate access errors.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS400 object does not exist.
Overrides:
deleteCertificateByHandle in class AS400CertificateUtil
 o listCertificates
 public int listCertificates(AS400CertificateAttribute certificateAttributes[],
                             String userSpaceName) throws AS400SecurityException, ErrorCompletingRequestException, ExtendedIOException, InterruptedException, IOException, ObjectDoesNotExistException
Lists certificates which match the specified attributes are copied from the validation list into the specified user space. The validation list is not locked during the listCertificates operation. Certificates are stored into the user space with CERT0100 format. See the AS400 QsyListVldlCertificates (QSYLSTVC) and QsyListUserCertificates (QSYLSTUC) API's for further information.

Parameters:
certificateAttributes - The list of attributes the certificate should match. A value of null places all certificates from the validation list into the user space. An empty String or empty byte array search attribute will search for certificates that do not have this attribute. For example, SUBJECT_ORGANIZATION = new String("") will search for certificates without the subject organization field. Null search attributes are ignored.
userSpaceName - The fully qualified integrated file system path name of the user space to put the list results, for example, /QSYS.LIB/MYLIB.LIB/MYUSRSPC.USRSPC. The 10 char AS400 library of the user space may also be specified as %CURLIB% or %LIBL%. @see QSYSObjectPathName
Returns:
The number of certificates found.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: ExtendedIllegalArgumentException
If invalid search attributes or input parameter.
Throws: ExtendedIOException
If AS400 certificate access error.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS400 object does not exist.
Overrides:
listCertificates in class AS400CertificateUtil
 o setPath
 public void setPath(String path) throws PropertyVetoException
Sets the path for the validation list.

Parameters:
path - The fully qualified integrated file system path name of the validation list.
Throws: PropertyVetoException
If the change is vetoed.
Overrides:
setPath in class AS400CertificateUtil

All Packages  Class Hierarchy  This Package  Previous  Next  Index