net.rim.device.api.crypto.certificate
Interface CertificateRevocationList

All Known Implementing Classes:
X509CertificateRevocationList

public interface CertificateRevocationList

Provides support for Certificate Revocation Lists, such as X.509 CRLs.

A Certificate Revocation List (CRL) contains a list of certificates that have been revoked by a Certificate Authority and should not be trusted any longer.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

Method Summary
Category: Signed  CertificateExtension getCRLEntryExtension(Certificate certificate, OID oid)
          Returns the CRL entry extension, for this certificate, for the given oid if it exists, otherwise null.
Category: Signed  CertificateExtension[] getCRLEntryExtensions(Certificate certificate)
          Returns all the CRL entry extensions associated with this certificate, or null.
Category: Signed  CertificateExtension[] getCRLEntryExtensions(Certificate certificate, boolean criticalBit)
          Returns all the extensions associated with this CRL Entry that have their critical bit set to the value of criticalBit, or null if none are found.
Category: Signed  CertificateStatus getCertificateStatus(Certificate certificate)
          Returns the status of the given certificate, if it is found in this CRL and the CRL is valid.
Category: Signed  CertificateStatus getCertificateStatus(Certificate certificate, long time)
          Returns the status of the given certificate, if it is found in this CRL and the CRL is valid.
Category: Signed  CertificateExtension getExtension(OID oid)
          Returns the extension for the given oid if it exists in the CRL, otherwise null.
Category: Signed  CertificateExtension[] getExtensions()
          Returns all the extensions associated with this CRL, or null.
Category: Signed  CertificateExtension[] getExtensions(boolean criticalBit)
          Returns all the extensions associated with this CRL that have their critical bit set to the value of criticalBit, or null if none are found.
Category: Signed  DistinguishedName getIssuer()
          Get the issuer of this CRL.
Category: Signed  long getNextUpdate()
          Returns the date by when the next CRL will be issued.
Category: Signed  long getThisUpdate()
          Returns the date of issue for this CRL.
 



Method Detail

getCertificateStatus

CertificateStatus getCertificateStatus(Certificate certificate)
Returns the status of the given certificate, if it is found in this CRL and the CRL is valid. The CRL is valid if the current time is after the creation time of the CRL and before the next update time of the CRL.

Parameters:
certificate - The certificate in question.
Returns:
A CertificateStatus object or null if the certificate is not in the CRL.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getCertificateStatus

CertificateStatus getCertificateStatus(Certificate certificate,
                                       long time)
Returns the status of the given certificate, if it is found in this CRL and the CRL is valid. The CRL is valid if the time is after the creation time of the CRL and before the next update time of the CRL.

Parameters:
certificate - The certificate in question.
time - the time to use in checking the certificate status
Returns:
A CertificateStatus object or null if the certificate is not in the CRL.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getThisUpdate

long getThisUpdate()
Returns the date of issue for this CRL.

Returns:
A long representing the date.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getNextUpdate

long getNextUpdate()
Returns the date by when the next CRL will be issued.

Returns:
A long representing the date.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getIssuer

DistinguishedName getIssuer()
Get the issuer of this CRL.

Returns:
The issuer of this CRL
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getExtension

CertificateExtension getExtension(OID oid)
Returns the extension for the given oid if it exists in the CRL, otherwise null.

See Also:
OIDs
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getExtensions

CertificateExtension[] getExtensions()
Returns all the extensions associated with this CRL, or null.

See Also:
OIDs
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getExtensions

CertificateExtension[] getExtensions(boolean criticalBit)
Returns all the extensions associated with this CRL that have their critical bit set to the value of criticalBit, or null if none are found.

Parameters:
criticalBit - a boolean that is true, if all critical extensions are to be returned and set to false if all non-critical extensions are to be returned
Returns:
An array of CertificateExtensions or null.
See Also:
OIDs
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getCRLEntryExtension

CertificateExtension getCRLEntryExtension(Certificate certificate,
                                          OID oid)
Returns the CRL entry extension, for this certificate, for the given oid if it exists, otherwise null.

Parameters:
certificate - The certificate to look up the CRL entry extension for.
oid - The oid to use to look up the extension.
Returns:
A CertificateExtension object. May be null.
See Also:
OIDs
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getCRLEntryExtensions

CertificateExtension[] getCRLEntryExtensions(Certificate certificate)
Returns all the CRL entry extensions associated with this certificate, or null.

Parameters:
certificate - the certificate to look up the CRL Entry extensions with
Returns:
all the extensions associated with this certificate in the CRL. May be null.
See Also:
OIDs
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getCRLEntryExtensions

CertificateExtension[] getCRLEntryExtensions(Certificate certificate,
                                             boolean criticalBit)
Returns all the extensions associated with this CRL Entry that have their critical bit set to the value of criticalBit, or null if none are found.

Parameters:
certificate - the certificate to use to determine which CRL Entry to look up the extensions from
criticalBit - a boolean that is true, if all critical extensions are to be returned and set to false if all non-critical extensions are to be returned
Returns:
An array of CertificateExtensions or null.
See Also:
OIDs
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal