SHOW Signed
 

net.rim.device.api.crypto.certificate
Class CertificateProperties

java.lang.Object
  |
  +--net.rim.device.api.crypto.certificate.CertificateProperties
Direct Known Subclasses:
CertificateChainProperties

public class CertificateProperties
extends Object

This class contains constants representing many properties that may pertain to certificates or certificate chains. There are also methods designed to select the "best" set of properties from an array of property values.

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:
JDE 4.1.0

Field Summary
 Category: Signed static long IMPROPER_CERTIFICATE_CHAIN
          A certificate chain property that indicates that there is a problem with the chain (eg the chain violates some path constraints).
 Category: Signed static long INCOMPLETE_CERTIFICATE_CHAIN
          A certificate chain property that indicates that the chain does not terminate with a self signed root certificate.
 Category: Signed static long INVALID_CERTIFICATE_PRESENT
          A certificate chain property that indicates that at least one certificate in the chain is either not yet valid, or has expired.
 Category: Signed static long REVOCATION_REASON_AFFILIATION_CHANGED
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed protected static long REVOCATION_REASON_BASE
           
 Category: Signed static long REVOCATION_REASON_CA_COMPROMISE
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOCATION_REASON_CERTIFICATE_HOLD
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOCATION_REASON_CESSATION_OF_OPERATION
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOCATION_REASON_KEY_COMPROMISE
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOCATION_REASON_KEY_RETIRED
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOCATION_REASON_REMOVE_FROM_CRL
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOCATION_REASON_SUPERSEDED
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOCATION_REASON_UNSPECIFIED
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOCATION_REASON_USER_ID_INVALID
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long REVOKED_CERTIFICATE_STATUS_PRESENT
          A certificate chain property that indicates that at least one certificate in the chain is revoked.
 Category: Signed static long STALE_CERTIFICATE_STATUS
          A certificate chain property that indicates that at least one certificate in the chain has a stale status.
 Category: Signed static long UNKNOWN_CERTIFICATE_STATUS_PRESENT
          A certificate chain property that indicates that at least one certificate in the chain has an unknown certificate revocation status.
 Category: Signed static long UNSUPPORTED_CERTIFICATE_CHAIN
          A certificate chain property that indicates that at least one signature in the chain uses an unsupported algorithm.
 Category: Signed static long UNTRUSTED_CERTIFICATE_CHAIN
          A certificate chain property that indicates that no certificate in the chain is a member of a trusted key store.
 Category: Signed static long UNVERIFIED_CERTIFICATE_CHAIN
          A certificate chain property that indicates that at least one signature in the chain does not verify.
 Category: Signed static long WEAK_CERTIFICATE_CHAIN
          A certificate chain property that indicates that at least one signature in the chain was signed with a weak key.
 Category: Signed static long WEAK_CERTIFICATE_CHAIN_DIGEST
          A certificate chain property that indicates that at least one signature in the chain was signed with a weak digest.
 
Constructor Summary
 Category: Signed CertificateProperties()
          Creates a new CertificateProperties object.
 
Method Summary
 Category: Signed static int[] select(long[] properties, long[] propertyMasks)
          Selects a set of properties based on a provided set of masks.
 Category: Signed static int selectBest(long[] properties)
          Returns the index of the best set of properties from the provided array.
 Category: Signed static long selectBestProperties(long[] properties)
          Returns the best set of properties from the provided array.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

IMPROPER_CERTIFICATE_CHAIN

public static final long IMPROPER_CERTIFICATE_CHAIN
A certificate chain property that indicates that there is a problem with the chain (eg the chain violates some path constraints).
Since:
JDE 4.1.0
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.

INCOMPLETE_CERTIFICATE_CHAIN

public static final long INCOMPLETE_CERTIFICATE_CHAIN
A certificate chain property that indicates that the chain does not terminate with a self signed root certificate.
Since:
JDE 4.1.0
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.

INVALID_CERTIFICATE_PRESENT

public static final long INVALID_CERTIFICATE_PRESENT
A certificate chain property that indicates that at least one certificate in the chain is either not yet valid, or has expired.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_AFFILIATION_CHANGED

public static final long REVOCATION_REASON_AFFILIATION_CHANGED
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_BASE

protected static final long REVOCATION_REASON_BASE
Since:
JDE 4.1.0
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.

REVOCATION_REASON_CA_COMPROMISE

public static final long REVOCATION_REASON_CA_COMPROMISE
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_CERTIFICATE_HOLD

public static final long REVOCATION_REASON_CERTIFICATE_HOLD
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_CESSATION_OF_OPERATION

public static final long REVOCATION_REASON_CESSATION_OF_OPERATION
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_KEY_COMPROMISE

public static final long REVOCATION_REASON_KEY_COMPROMISE
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_KEY_RETIRED

public static final long REVOCATION_REASON_KEY_RETIRED
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.2.1
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.

REVOCATION_REASON_REMOVE_FROM_CRL

public static final long REVOCATION_REASON_REMOVE_FROM_CRL
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_SUPERSEDED

public static final long REVOCATION_REASON_SUPERSEDED
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_UNSPECIFIED

public static final long REVOCATION_REASON_UNSPECIFIED
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.1.0
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.

REVOCATION_REASON_USER_ID_INVALID

public static final long REVOCATION_REASON_USER_ID_INVALID
A certificate chain property that indicates that at least one certificate in the chain is revoked. See also RevocationReason.
Since:
JDE 4.2.1
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.

REVOKED_CERTIFICATE_STATUS_PRESENT

public static final long REVOKED_CERTIFICATE_STATUS_PRESENT
A certificate chain property that indicates that at least one certificate in the chain is revoked.
Since:
JDE 4.1.0
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.

STALE_CERTIFICATE_STATUS

public static final long STALE_CERTIFICATE_STATUS
A certificate chain property that indicates that at least one certificate in the chain has a stale status.
Since:
JDE 4.1.0
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.

UNKNOWN_CERTIFICATE_STATUS_PRESENT

public static final long UNKNOWN_CERTIFICATE_STATUS_PRESENT
A certificate chain property that indicates that at least one certificate in the chain has an unknown certificate revocation status.
Since:
JDE 4.1.0
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.

UNSUPPORTED_CERTIFICATE_CHAIN

public static final long UNSUPPORTED_CERTIFICATE_CHAIN
A certificate chain property that indicates that at least one signature in the chain uses an unsupported algorithm.
Since:
JDE 4.1.0
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.

UNTRUSTED_CERTIFICATE_CHAIN

public static final long UNTRUSTED_CERTIFICATE_CHAIN
A certificate chain property that indicates that no certificate in the chain is a member of a trusted key store.
Since:
JDE 4.1.0
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.

UNVERIFIED_CERTIFICATE_CHAIN

public static final long UNVERIFIED_CERTIFICATE_CHAIN
A certificate chain property that indicates that at least one signature in the chain does not verify.
Since:
JDE 4.1.0
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.

WEAK_CERTIFICATE_CHAIN

public static final long WEAK_CERTIFICATE_CHAIN
A certificate chain property that indicates that at least one signature in the chain was signed with a weak key.
Since:
JDE 4.1.0
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.

WEAK_CERTIFICATE_CHAIN_DIGEST

public static final long WEAK_CERTIFICATE_CHAIN_DIGEST
A certificate chain property that indicates that at least one signature in the chain was signed with a weak digest.
Since:
JDE 4.3.0
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.
Constructor Detail

CertificateProperties

public CertificateProperties()
Creates a new CertificateProperties object.

This is the default constructor and is not used.

Since:
JDE 4.1.0
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.
Method Detail

select

public static int[] select(long[] properties,
                           long[] propertyMasks)
Selects a set of properties based on a provided set of masks.
Parameters:
properties - an array of certiticate properties
propertyMasks - an array of certificate property masks
Returns:
an array of two integers (n,m) satisfying the following conditions:
  1. Set n only has properties specified in mask m (although it may not have all of the specified properties)
  2. There is no n' and no m' < m such that set n' only has properties specified in mask m'.
(In other words, m is the smallest index into the mask array for which there is a property set that only has properties specified in that mask, and n is the index of a property set that has those properties.)

If there is no property set matching any of the property masks, then the array (-1,-1) is returned.

Since:
JDE 4.1.0
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.

selectBest

public static int selectBest(long[] properties)
Returns the index of the best set of properties from the provided array.
Since:
JDE 4.1.0
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.

selectBestProperties

public static long selectBestProperties(long[] properties)
Returns the best set of properties from the provided array.
Since:
JDE 4.1.0
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.



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.