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

java.lang.Object
  net.rim.device.api.crypto.keystore.RIMKeyStore
      net.rim.device.api.crypto.keystore.PersistableRIMKeyStore
          net.rim.device.api.crypto.keystore.SyncableRIMKeyStore
              net.rim.device.api.crypto.keystore.DeviceKeyStore

All Implemented Interfaces:

CollectionEventSource, KeyStore

public final class DeviceKeyStore
extends SyncableRIMKeyStore

The device key store is a key store which has the ability to sync with the desktop software.

There is a program called CertSync that runs in the desktop software which allows for people to modify the contents of this keystore. It is important to note that any changes done on the desktop will be reflected here and any changes done here (on the device) will be reflected on the desktop.

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

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

Field Summary

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

Method Summary
	static KeyStore	getInstance() Returns a reference to the current desktop key store.
	String	getName() Returns the localised string representing this key store name for the Device Key Store.

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

checkTicket, getTicket, getTicket, set

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, 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

Method Detail

getInstance

public static KeyStore getInstance()

Returns a reference to the current desktop key store.

Note that any changes to this key store will be saved to the database and that this is the _only_ desktop keystore.

Returns:

The key store.

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

getName

public String getName()

Returns the localised string representing this key store name for the Device Key Store. In English it would return "Handheld Key Store".

Specified by:

getName in interface KeyStore

Overrides:

getName in class RIMKeyStore

Returns:

the localised name for the Device Key Store.

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.7.0