SHOW Signed

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

java.lang.Object
  |
  +--net.rim.device.api.crypto.certificate.CertificateUtilities

public final class CertificateUtilities

extends Object

Verifies certificate chains.

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:

JDE 3.6.0

See Also:

Certificate, CertificateFactory, CertificateStatus

Method Summary

	static Certificate[]	buildCertificateChain(Certificate certificate, Certificate[] pool, KeyStore keyStore) Builds a certificate chain for a certificate from a pool of certificates and a keystore.
	static Certificate[]	buildCertificateChain(Certificate certificate, KeyStore keyStore) Builds a certificate chain for a certificate from a keystore.
	static Certificate[][]	buildCertificateChains(Certificate certificate, Certificate[] pool, KeyStore keyStore) Builds all of the certificate chains for a certificate from a pool of certificates and a keystore.
	static Certificate[][]	buildCertificateChains(Certificate certificate, KeyStore keyStore) Builds all of the certificate chains for a certificate from a keystore.
	static Certificate[]	buildTrustedCertificateChain(Certificate certificate, Certificate[] pool, KeyStore keyStore, KeyStore trustedKeyStore) Builds a trusted certificate chain for a certificate from a pool of certificates and a keystore.
	static Certificate[][]	buildTrustedCertificateChains(Certificate certificate, Certificate[] pool, KeyStore keyStore, KeyStore trustedKeyStore) Builds all of the trusted certificate chains for a certificate from a pool of certificates and a keystore.
	static String	calculateThumbprint(Certificate certificate, Digest digest) Calculates the thumbprint of the certificate using the given digest.
	static boolean	compareDistinguishedNames(DistinguishedName dn1, DistinguishedName dn2) Compares two DistinguishedNames component by component, and returns true if they both have the same number of components and same values for each component.
	static void	displayCertificateDetails(Certificate certificate) Blocks and displays a dialog box containing information about the specified certificate.
	static void	displayCertificateDetails(Certificate certificate, KeyStore keyStore) Blocks and displays a dialog box containing information about the specified certificate.
	static void	displayCertificateDetails(Certificate certificate, KeyStore keyStore, boolean allowFetchStatus, CertificateStatusManagerTicket ticket) Blocks and displays a dialog box containing information about the specified certificate.
	static String	getFriendlyName(DistinguishedName distinguishedName) Returns a string that contains a "friendly" name for the distinguished name of a certificate.
	static String	getHexAsciiString(byte[] data) Returns a String containing the hexadecimal ASCII encoding of the given data.
	static String	getHexAsciiString(byte[] data, int offset, int length) Returns a String containing the hexadecimal ASCII encoding of the given data.
	static String	getKeyUsageString(long keyUsage) Returns a String that determines how the key is used.
	static String	getSubjectFriendlyName(Certificate certificate) Returns a string that contains a "friendly" name for the subject of this certificate.
	static boolean	isCertificateChainTrusted(Certificate[] chain, KeyStore trustedKeyStore) Determines if the chain is trusted.
	static boolean	isCertificateTrusted(Certificate certificate, Certificate[] pool, KeyStore keyStore, KeyStore trustedKeyStore) Determines if this certificate is trusted by trying to build a chain into the trustedKeyStore.
	static boolean	isCertificateTrusted(Certificate certificate, KeyStore trustedKeyStore) Determines if this certificate is trusted by trying to build a chain into the trustedKeyStore.
	static int	selectCertificate(RichTextField descriptionField, String[] names, Certificate[] certificates, KeyStore keyStore) This method displays a dialog prompting the user to select a certificate from the list of certificates provided.
	static int[]	selectCertificates(RichTextField descriptionField, String[] names, Certificate[] certificates, int[] selectedCertificates, KeyStore keyStore) This method displays a dialog prompting the user to select a group of certificates from the list of certificates provided.
	static int[]	selectCertificates(RichTextField descriptionField, String[] names, Certificate[] certificates, KeyStore keyStore) This method displays a dialog prompting the user to select a group of certificates from the list of certificates provided.
	static boolean	verifyCertificateChain(Certificate[] chain, KeyStore trustedKeyStore, long date) Verifies the signatures of the certificates in a chain.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

buildCertificateChain

public static Certificate[] buildCertificateChain(Certificate certificate,
                                                  KeyStore keyStore)

Builds a certificate chain for a certificate from a keystore.

The chain will be built up until a root certificate is encountered, or until the issuer of a certificate cannot be found in the keystore.

Parameters:

certificate - The certificate for which the chain should be built.

keyStore - The keystore that should be searched when looking for certificates in the chain. Note this can be null.

Returns:

The certificate chain, with certificate in position 0, its issuer in position 1, etc.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

buildCertificateChain

public static Certificate[] buildCertificateChain(Certificate certificate,
                                                  Certificate[] pool,
                                                  KeyStore keyStore)

Builds a certificate chain for a certificate from a pool of certificates and a keystore.

The chain will be built up until a root certificate is encountered, or until the issuer of a certificate cannot be found in the pool or in the keystore. The pool will be searched first for each issuer certificate, and if the certificate is not found there, the keystore will be searched.

Parameters:

certificate - The certificate for which the chain will be built.

pool - The pool of certificates that should be searched for certificates in the chain. Note this can be null.

keyStore - The keystore that should be searched for certificates in the chain. Note this can be null.

Returns:

The certificate chain, with certificate in position 0, its issuer in position 1, etc.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

buildCertificateChains

public static Certificate[][] buildCertificateChains(Certificate certificate,
                                                     KeyStore keyStore)

Builds all of the certificate chains for a certificate from a keystore.

The chains will be built up until a root certificate is encountered, or until the issuer of a certificate cannot be found in the keystore.

Parameters:

certificate - The certificate for which the chains should be built.

keyStore - The keystore that should be searched for certificates in the chains. Note this can be null.

Returns:

The certificate chains as an array of Certificate[], with certificate in position 0, its issuer in position 1, etc.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

buildCertificateChains

public static Certificate[][] buildCertificateChains(Certificate certificate,
                                                     Certificate[] pool,
                                                     KeyStore keyStore)

Builds all of the certificate chains for a certificate from a pool of certificates and a keystore.

The chains will be built up until a root certificate is encountered, or until the issuer of a certificate cannot be found in the pool or in the keystore. The pool will be searched first for each issuer certificate, and if the certificate is not found there, the keystore will be searched.

Parameters:

certificate - The certificate for which the chains will be built.

pool - The pool of certificates that should be searched for certificates in the chains. Note this can be null.

keyStore - The keystore that should be searched for certificates in the chains. Note this can be null.

Returns:

The certificate chains as an array of Certificate[], with certificate in position 0, its issuer in position 1, etc.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

buildTrustedCertificateChain

public static Certificate[] buildTrustedCertificateChain(Certificate certificate,
                                                         Certificate[] pool,
                                                         KeyStore keyStore,
                                                         KeyStore trustedKeyStore)

Builds a trusted certificate chain for a certificate from a pool of certificates and a keystore. If no trusted chain is found, null is returned.

The chain will be built up until a root certificate is encountered, or until the issuer of a certificate cannot be found in the pool or in the keystore. The pool will be searched first for each issuer certificate, and if the certificate is not found there, the keystore will be searched.

Parameters:

certificate - The certificate for which the chain will be built.

pool - The pool of certificates that should be searched for certificates in the chain. Note this can be null.

keyStore - The keystore that should be searched for certificates in the chain. Note this can be null.

trustedKeyStore - The keystore that should be searched for the trusted certificates.

Returns:

The certificate chain, with certificate in position 0, its issuer in position 1, etc. or null if no trusted chain could be created.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

buildTrustedCertificateChains

public static Certificate[][] buildTrustedCertificateChains(Certificate certificate,
                                                            Certificate[] pool,
                                                            KeyStore keyStore,
                                                            KeyStore trustedKeyStore)

Builds all of the trusted certificate chains for a certificate from a pool of certificates and a keystore. If no trusted chains are found, null is returned.

The chains will be built up until a root certificate is encountered, or until the issuer of a certificate cannot be found in the pool or in the keystore. The pool will be searched first for each issuer certificate, and if the certificate is not found there, the keystore will be searched.

Parameters:

certificate - The certificate for which the chains will be built.

pool - The pool of certificates that should be searched for certificates in the chains. Note this can be null.

keyStore - The keystore that should be searched for certificates in the chains. Note this can be null.

trustedKeyStore - The keystore that should be searched for the trusted certificates.

Returns:

The certificate chains as an array of Certificate[], with certificate in position 0, its issuer in position 1, etc. or null if no trusted chain could be created.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

verifyCertificateChain

public static boolean verifyCertificateChain(Certificate[] chain,
                                             KeyStore trustedKeyStore,
                                             long date)
                                      throws CertificateVerificationException,
                                             CertificateChainTooLongException,
                                             CertificateRevokedException,
                                             CertificateInvalidException,
                                             DecodeException,
                                             InvalidSignatureEncodingException,
                                             NoSuchAlgorithmException,
                                             CryptoTokenException,
                                             CryptoUnsupportedOperationException,
                                             InvalidCryptoSystemException

Verifies the signatures of the certificates in a chain.

The last known on-device status of each certificate is checked as the signatures are verified. The function returns normally if every signature verifies properly, and no certificate in the chain is known to be revoked.

Parameters:

chain - The chain of certificates to be verified. Must be non null and contain at least one certificate. Note that the end entity certificate must appear at array index [0].

trustedKeyStore - A keyStore that contains keys that the user trusts.

date - The date of the signature.

Returns:

True if a certificate in the chain was contained in trustedKeyStore, and false if no certificate in the chain was contained in trustedKeyStore.

Throws:

CertificateVerificationException - Thrown if a signature on a certificate in the chain did not verify properly

CertificateChainTooLongException - Thrown if the chain is longer than allowed by the CA's path length constraint, as defined in the Basic Constraints Extension

CertificateRevokedException - Thrown if a certificate in the chain is known to be revoked

CertificateInvalidException - Thrown if a certificate in the chain is not valid (ie. it has expired or it has not yet become valid).

DecodeException - Thrown if an error occurs while decoding the certificate.

InvalidSignatureEncodingException - Thrown if a signature is encoded incorrectly.

NoSuchAlgorithmException - Thrown if the specified algorithm is invalid.

CryptoTokenException - Thrown if an error occurs with the crypto token or the crypto token is invalid.

CryptoUnsupportedOperationException - Thrown if a call is made to an unsupported operation.

InvalidCryptoSystemException - Thrown if the specified crypto system is invalid.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

isCertificateChainTrusted

public static boolean isCertificateChainTrusted(Certificate[] chain,
                                                KeyStore trustedKeyStore)

Determines if the chain is trusted.

Returns true if the certificate chain contains some certificate in the trusted key store, and false otherwise. Note that this function does not verify signatures, check revocation statuses, or check the validity of any of the certificates in the chain.

Parameters:

chain - The specified certificate chain. Must be non null, with at least one certificate in the chain. Note that the end entity certificate must appear at array index [0].

trustedKeyStore - The trusted key store.

Returns:

True if the certificate chain is trusted and false otherwise.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

isCertificateTrusted

public static boolean isCertificateTrusted(Certificate certificate,
                                           KeyStore trustedKeyStore)

Determines if this certificate is trusted by trying to build a chain into the trustedKeyStore.

Note that this function does not verify signatures, check revocation statuses, or check the validity of any of the certificates in the chain.

Parameters:

certificate - The certificate to check.

trustedKeyStore - The trusted key store.

Returns:

True if the certificate is trusted and false otherwise.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

isCertificateTrusted

public static boolean isCertificateTrusted(Certificate certificate,
                                           Certificate[] pool,
                                           KeyStore keyStore,
                                           KeyStore trustedKeyStore)

Determines if this certificate is trusted by trying to build a chain into the trustedKeyStore. The pool and keyStore, if provided, help to find intermediate certificates in the chain to the trusted key store.

Note that this function does not verify signatures, revocation status, or validity of any of the certificates in the chain.

Parameters:

certificate - The certificate to check.

pool - A certificate array of potential members in the certificate chain. Can be null.

keyStore - A key store to try and find potential members of the certificate chain. Can be null.

trustedKeyStore - The trusted key store.

Returns:

True if the certificate is trusted and false otherwise.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getSubjectFriendlyName

public static String getSubjectFriendlyName(Certificate certificate)

Returns a string that contains a "friendly" name for the subject of this certificate.

The friendly name created using the first present attribute in the following list, taken from the subject distinguished name.

• The common name ( OIDs.idAtCommonName )
• The name ( OIDs.idAtName )
• The given name + initials + surname ( OIDs.idAtGivenName + OIDs.idAtInitials + OIDs.idAtSurname )
• The organizational unit ( OIDs.idAtOrganizationalUnitName )
• The organizational name ( OIDs.idAtOrganizationName )

Parameters:

certificate - The specified certificate.

Returns:

A String containing the friendly name or null if no friendly name could be created.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getFriendlyName

public static String getFriendlyName(DistinguishedName distinguishedName)

Returns a string that contains a "friendly" name for the distinguished name of a certificate.

The friendly name created using the first present attribute in the following list, taken from the distinguished name provided as the parameter to this method.

• The common name ( OIDs.idAtCommonName )
• The name ( OIDs.idAtName )
• The given name + initials + surname ( OIDs.idAtGivenName + OIDs.idAtInitials + OIDs.idAtSurname )
• The organizational unit ( OIDs.idAtOrganizationalUnitName )
• The organizational name ( OIDs.idAtOrganizationName )

Parameters:

distinguishedName - The specified DistinguishedName.

Returns:

A String containing the friendly name or null if no friendly name could be created.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

displayCertificateDetails

public static void displayCertificateDetails(Certificate certificate)

Blocks and displays a dialog box containing information about the specified certificate.

Parameters:

certificate - The certificate about which information is to be displayed.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

displayCertificateDetails

public static void displayCertificateDetails(Certificate certificate,
                                             KeyStore keyStore)

Blocks and displays a dialog box containing information about the specified certificate. If a key store is specified, the dialog will also allow the user to display information about the certificate belonging to the issuer of this certificate. By default, the user will also be able to fetch the certificate's status over the air.

Parameters:

certificate - The certificate about which information is to be displayed.

keyStore - The key store that will be searched for the issuer's certificate.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

displayCertificateDetails

public static void displayCertificateDetails(Certificate certificate,
                                             KeyStore keyStore,
                                             boolean allowFetchStatus,
                                             CertificateStatusManagerTicket ticket)

Blocks and displays a dialog box containing information about the specified certificate. If a key store is specified, the dialog will also allow the user to display information about the certificate belonging to the issuer of this certificate.

Parameters:

certificate - The certificate about which information is to be displayed.

keyStore - The key store that will be searched for the issuer's certificate.

allowFetchStatus - If set to true, the dialog will contain a button for fetching the certificate's status over the air.

ticket - A CertificateStatusManagerTicket to be used to update the certificate status if requested. If this is null, the user will be prompted for their password.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

calculateThumbprint

public static String calculateThumbprint(Certificate certificate,
                                         Digest digest)

Calculates the thumbprint of the certificate using the given digest.

Parameters:

certificate - The certificate to calculate the thumbprint on.

digest - The digest used in the calculation of the thumbprint.

Returns:

A String containing the thumbprint formatted using a hexadecimal ASCII encoding with spaces every 4 characters.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getHexAsciiString

public static String getHexAsciiString(byte[] data)

Returns a String containing the hexadecimal ASCII encoding of the given data. Spaces are inserted every 4 characters.

Parameters:

data - The specified byte buffer.

Returns:

The hexadecimal Ascii encoded string. Returns an empty string if the length of the data is 0.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getHexAsciiString

public static String getHexAsciiString(byte[] data,
                                       int offset,
                                       int length)

Returns a String containing the hexadecimal ASCII encoding of the given data. Spaces are inserted every 4 characters.

Parameters:

data - The specified byte buffer.

offset - The starting position of the data in the array.

length - The length of the data in the array.

Returns:

The hexadecimal Ascii string. Returns an empty string if the length of the data or the length parameter is 0.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getKeyUsageString

public static String getKeyUsageString(long keyUsage)

Returns a String that determines how the key is used.

Parameters:

keyUsage - A long that represents how the key is used.

Returns:

A String representing the key usage type or null if the keyUsage is not supported.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

selectCertificate

public static int selectCertificate(RichTextField descriptionField,
                                    String[] names,
                                    Certificate[] certificates,
                                    KeyStore keyStore)

This method displays a dialog prompting the user to select a certificate from the list of certificates provided. The user is given the option to press v to view any of the certificates. The user is also given the choice to cancel out of the dialog. The certificate at index 0 gets selected by default when the dialog first gets displayed.

Parameters:

descriptionField - A field that will be inserted at the top of the dialog. This field should describe the reason the user is selecting a certificate.

names - An array of strings containing the names of the certificates that you want to show the user. These could be the DNs of the certificates, the labels of the key store data or something else.

certificates - An array of Certificate objects that contain the certificates that you are considering using.

keyStore - A keystore that will be used to display the certificate details for any of the certificates provided. Providing the keystore, allows the certificate display dialog to show information about the issuer of the certificate. This parameter may be null.

Returns:

An integer representing the index into the data array of the certificate that was selected by the user. If the user selects cancel, -1 is returned.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

selectCertificates

public static int[] selectCertificates(RichTextField descriptionField,
                                       String[] names,
                                       Certificate[] certificates,
                                       KeyStore keyStore)

This method displays a dialog prompting the user to select a group of certificates from the list of certificates provided. The user is given the option to press v to view any of the certificates. The user is also given the choice to cancel out of the dialog. No certificates are selected when the dialog first gets displayed.

Parameters:

descriptionField - A field that will be inserted at the top of the dialog. This field should describe the reason the user is selecting certificates.

names - An array of strings containing the names of the certificates that you want to show the user. These could be the DNs of the certificates, the labels of the key store data or something else.

certificates - An array of Certificate objects that contain the certificates that you are considering using.

keyStore - A keystore that will be used to display the certificate details for any of the certificates provided. Providing the keystore, allows the certificate display dialog to show information about the issuer of the certificate. This parameter may be null.

Returns:

An integer array representing the indicies ( within the data array ) that was selected by the user. Returns null if the user selected cancel. Returns an empty array is no certificates were selected.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

selectCertificates

public static int[] selectCertificates(RichTextField descriptionField,
                                       String[] names,
                                       Certificate[] certificates,
                                       int[] selectedCertificates,
                                       KeyStore keyStore)

This method displays a dialog prompting the user to select a group of certificates from the list of certificates provided. The user is given the option to press v to view any of the certificates. The user is also given the choice to cancel out of the dialog.

Parameters:

descriptionField - A field that will be inserted at the top of the dialog. This field should describe the reason the user is selecting certificates.

names - An array of strings containing the names of the certificates that you want to show the user. These could be the DNs of the certificates, the labels of the key store data or something else.

certificates - An array of Certificate objects that contain the certificates that you are considering using.

keyStore - A keystore that will be used to display the certificate details for any of the certificates provided. Providing the keystore, allows the certificate display dialog to show information about the issuer of the certificate. This parameter may be null.

selectedCertificates - An array of indicies ( within the data array ) which indicate which certificates are to be selected by default when the dialog first gets displayed. If this parameter is null, no certificates are selected when the dialog first gets displayed.

Returns:

An integer array representing the indicies ( within the data array ) that was selected by the user. Returns null if the user selected cancel. Returns an empty array if no certificates were selected.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

compareDistinguishedNames

public static boolean compareDistinguishedNames(DistinguishedName dn1,
                                                DistinguishedName dn2)

Compares two DistinguishedNames component by component, and returns true if they both have the same number of components and same values for each component. The comparison between component values is case sensitive.

Parameters:

dn1 - The first distinguished name to compare. Must be non null.

dn2 - The second distinguished name to compare. Must be non null.

Returns:

True if the distinguished names are equal and false otherwise.

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.