org.eclipse.higgins.cardstore.schemas._2005._05.identity
Interface IEncryptedStore

All Superinterfaces:
XMLSerializer
All Known Implementing Classes:
EncryptedStore

public interface IEncryptedStore
extends XMLSerializer

This interface presents a encrypted CRDS (Card Space card store). CRDS files are typically exported from a CardSpace implementation. They are encrypted with a key derived from a user supplied password.

The XML schema can be found at: http://schemas.xmlsoap.org/ws/2005/05/identity

Author:
pwardrop

Field Summary
static String copyright
           
 
Method Summary
 byte[] getByteOrderMark()
          Returns the the byte order marker for the CRDS file.
 IRoamingStore getRoamingStore(PasswordCallback passwdCallback)
          Returns a RoamingStore object.
 byte[] getStoreSalt()
          This method will return the store salt.
 void setRoamingStore(IRoamingStore roamingStore)
          This method is used to replace or add a roaming store that the encrypted store is based on.
 byte[] toXml(PasswordCallback passwdCallback)
          Returns a EncryptedStore XML object encrypted using the provided password.
 
Methods inherited from interface org.eclipse.higgins.cardstore.schemas.XMLSerializer
fromXml, getParent, setParent, toXml
 

Field Detail

copyright

public static final String copyright
See Also:
Constant Field Values
Method Detail

getStoreSalt

public byte[] getStoreSalt()
This method will return the store salt.

Returns:
byte array of store salt. The value will be Base64 decoded.

getByteOrderMark

public byte[] getByteOrderMark()
Returns the the byte order marker for the CRDS file.

The typical values are: {0xEF, 0xBB, 0xBF}.

Returns:
three bytes; null if no byte order marker is present.

setRoamingStore

public void setRoamingStore(IRoamingStore roamingStore)
This method is used to replace or add a roaming store that the encrypted store is based on.

Parameters:
roamingStore -

getRoamingStore

public IRoamingStore getRoamingStore(PasswordCallback passwdCallback)
                              throws StoreDecryptionException
Returns a RoamingStore object.

Parameters:
passwdCallback - the required password to decrypt the store.
Returns:
Throws:
StoreDecryptionException

toXml

public byte[] toXml(PasswordCallback passwdCallback)
             throws StoreEncryptionException
Returns a EncryptedStore XML object encrypted using the provided password.

Parameters:
passwdCallback -
Returns:
Throws:
StoreEncryptionException