SHOW Signed

net.rim.device.api.crypto.keystore
Class SyncableRIMKeyStore

java.lang.Object
  |
  +--net.rim.device.api.crypto.keystore.RIMKeyStore
        |
        +--net.rim.device.api.crypto.keystore.PersistableRIMKeyStore
              |
              +--net.rim.device.api.crypto.keystore.SyncableRIMKeyStore

All Implemented Interfaces:

Collection, CollectionEventSource, KeyStore

Direct Known Subclasses:

DeviceKeyStore, TrustedKeyStore

public class SyncableRIMKeyStore

extends PersistableRIMKeyStore

Implements a key store that receives information through the cradle and saves this information in a key store. When the information is updated, created, or deleted on the desktop these changes will be reflected on the device in the keystore.

For sample code on how to use a key store see: here

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:

RIMKeyStore, PersistableRIMKeyStore

Fields inherited from class net.rim.device.api.crypto.keystore.PersistableRIMKeyStore

_persist

Fields inherited from interface net.rim.device.api.crypto.keystore.KeyStore

SECURITY_LEVEL_HIGH, SECURITY_LEVEL_LOW, SECURITY_LEVEL_MEDIUM, SECURITY_LEVEL_NOT_APPLICABLE

Constructor Summary

	SyncableRIMKeyStore(String syncName, String displayName, long id, CodeSigningKey key, PersistableRIMKeyStoreFactory factory) Constructs a keystore that can synchronize with the desktop.
	SyncableRIMKeyStore(String syncName, String displayName, long id, CodeSigningKey key, PersistableRIMKeyStoreFactory factory, KeyStore keyStore) Constructs a keystore that can synchronize with the desktop.

Method Summary

	boolean	checkTicket(KeyStoreTicket ticket) Checks the validity of the ticket.
	KeyStoreTicket	getTicket() Returns a ticket that allows the caller to use the keystore without prompting the user for their password.
	KeyStoreTicket	getTicket(String prompt) Returns a ticket that allows the caller to use the keystore without prompting the user for their password.
	protected void	set(AssociatedData[] associatedData, KeyStoreData data) Override this method in the RIMKeyStore implementation to tell the KeyStoreManager when a certificate has been added so it can update its dirty bit implementation of certificates not yet synchronized with the BES.

Methods inherited from class net.rim.device.api.crypto.keystore.PersistableRIMKeyStore

addIndex, changePassword, removeIndex, removeKey

Methods inherited from class net.rim.device.api.crypto.keystore.RIMKeyStore

addCollectionListener, addIndices, deleteKey, elements, elements, elements, elements, elements, elements, exists, existsIndex, getBackingKeyStore, getName, isMember, isMember, isMember, isMember, removeCollectionListener, set, set, set, set, set, set, set, size

Methods inherited from class java.lang.Object

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

Constructor Detail

SyncableRIMKeyStore

public SyncableRIMKeyStore(String syncName,
                           String displayName,
                           long id,
                           CodeSigningKey key,
                           PersistableRIMKeyStoreFactory factory)
                    throws KeyStoreRegisterException

Constructs a keystore that can synchronize with the desktop.

Parameters:

syncName - The name of the keystore that is displayed to the desktop software as a database. This string should NOT be resourced.

displayName - The name that is displayed to the user (or retrieved from the getName method). This string should be resourced.

id - The unique long representing the key store.

key - a CodeSigningKey which can be used to prevent unauthorized access to your keystore.

factory - The factory used to create the key store. See PersistableRIMKeyStore for more information on the unique id.

Throws:

KeyStoreRegisterException - thrown when there is an error registering this class with the KeyStoreManager which is typically caused by one of three exceptions being thrown in that method (ClassNotFoundException, InstantiationException, IllegalAccessException).

Since:

JDE 3.6.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.

SyncableRIMKeyStore

public SyncableRIMKeyStore(String syncName,
                           String displayName,
                           long id,
                           CodeSigningKey key,
                           PersistableRIMKeyStoreFactory factory,
                           KeyStore keyStore)
                    throws KeyStoreRegisterException

Constructs a keystore that can synchronize with the desktop.

Parameters:

syncName - The name of the keystore that is displayed to the desktop software as a database. This string should NOT be resourced.

displayName - The name that is displayed to the user (or retrieved from the getName method). This string should be resourced.

id - The unique long representing the key store.

key - a CodeSigningKey which can be used to prevent unauthorized access to your keystore.

factory - The factory used to create the key store.

keyStore - An underlying keystore that allows for chaining of key stores similar to how key store works.

Throws:

KeyStoreRegisterException - thrown when there is an error registering this class with the KeyStoreManager which is typically caused by one of three exceptions being thrown in that method (ClassNotFoundException, InstantiationException, IllegalAccessException).

Since:

JDE 3.6.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.

Method Detail

set

protected void set(AssociatedData[] associatedData,
                   KeyStoreData data)

Override this method in the RIMKeyStore implementation to tell the KeyStoreManager when a certificate has been added so it can update its dirty bit implementation of certificates not yet synchronized with the BES.

Overrides:

set in class RIMKeyStore

Since:

JDE 4.0.2

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.

getTicket

public KeyStoreTicket getTicket()
                         throws KeyStoreCancelException

Description copied from interface: KeyStore

Returns a ticket that allows the caller to use the keystore without prompting the user for their password.

This method may prompt for a passphrase from the user.

Overrides:

getTicket in class RIMKeyStore

Since:

JDE 3.6.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.

getTicket

public KeyStoreTicket getTicket(String prompt)
                         throws KeyStoreCancelException

Description copied from interface: KeyStore

Returns a ticket that allows the caller to use the keystore without prompting the user for their password.

This method may prompt for a passphrase from the user.

Overrides:

getTicket in class RIMKeyStore

Since:

JDE 4.0.2

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.

checkTicket

public boolean checkTicket(KeyStoreTicket ticket)

Description copied from class: RIMKeyStore

Checks the validity of the ticket.

Overrides:

checkTicket in class RIMKeyStore

Since:

JDE 4.0.2

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.