|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
|
+--net.rim.device.api.crypto.keystore.RIMKeyStore
|
+--net.rim.device.api.crypto.keystore.PersistableRIMKeyStore
|
+--net.rim.device.api.crypto.keystore.SyncableRIMKeyStore
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
RIMKeyStore,
PersistableRIMKeyStore| 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 |
| 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 |
public SyncableRIMKeyStore(String syncName, String displayName, long id, CodeSigningKey key, PersistableRIMKeyStoreFactory factory) throws KeyStoreRegisterException
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.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).public SyncableRIMKeyStore(String syncName, String displayName, long id, CodeSigningKey key, PersistableRIMKeyStoreFactory factory, KeyStore keyStore) throws KeyStoreRegisterException
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.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).| Method Detail |
public boolean checkTicket(KeyStoreTicket ticket)
RIMKeyStorecheckTicket in class RIMKeyStore
RIMKeyStoreticket - The specified ticket.public KeyStoreTicket getTicket() throws KeyStoreCancelException
KeyStoreThis method may prompt for a passphrase from the user.
getTicket in class RIMKeyStore
KeyStoreKeyStoreCancelException - Thrown when the user fails to enter a password
or decides to cancel the password entry operation.public KeyStoreTicket getTicket(String prompt) throws KeyStoreCancelException
KeyStoreThis method may prompt for a passphrase from the user.
getTicket in class RIMKeyStore
KeyStoreprompt - an additional string provided to the allow the application developer to customize
the ticket prompt dialog to better fit their application needs.KeyStoreCancelException - Thrown when the user fails to enter a password
or decides to cancel the password entry operation.protected void set(AssociatedData[] associatedData, KeyStoreData data)
set in class RIMKeyStore
RIMKeyStoreassociatedData - An associated data array containing all of the aliases
to index this record on in the keystore.data - The information that is to be stored in the
keystore.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
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.