org.cassproject.ebac.identity

Class EcIdentityManager

java.lang.Object

org.cassproject.ebac.identity.EcIdentityManager

public class EcIdentityManager
extends Object

Manages identities and contacts, provides hooks to respond to identity and contact events, and builds signatures and signature sheets for authorizing movement of data. Also provides helper functions for identity management and reads the users contacts on application start with a static constructor that pulls them out of any temporary storage

Author:

fritz.ray@eduworks.com

Field Summary

Fields

Modifier and Type	Field and Description
static org.stjs.javascript.Array<EcContact>	contacts Contacts (Keys that we do not own)
static org.stjs.javascript.Array<EcIdentity>	ids The current user's owned identities (keys+displayName)
static org.stjs.javascript.functions.Callback1<EcContact>	onContactChanged Contacts change hook.
static org.stjs.javascript.functions.Callback1<EcIdentity>	onIdentityChanged Identity change hook.
static Object	signatureSheetCache
static boolean	signatureSheetCaching

Constructor Summary

Constructors

Constructor and Description
EcIdentityManager()

Method Summary

Modifier and Type	Method and Description
static void	addContact(EcContact contact) Adds a contact to the identity manager.
static void	addContactQuietly(EcContact contact) Adds a contact to the identity manager.
static void	addIdentity(EcIdentity identity) Adds an identity to the identity manager.
static void	addIdentityQuietly(EcIdentity identity) Adds an identity to the identity manager.
static void	clearContacts() Clears contacts from the local storage
static void	clearIdentities() Clears identities from the local storage
static void	contactChanged(EcContact contact) Trigger for the onContactChanged hook
static EbacSignature	createSignature(long duration, String server, EcPpk ppk) Create a signature for a specific identity, authorizing movement of data outside of our control.
static EcContact	getContact(EcPk pk) Get Contact from PK (if we have it)
static EcIdentity	getIdentity(EcPk pk) Get Identity from PK (if we have it)
static org.stjs.javascript.Array<EcPk>	getMyPks()
static EcPpk	getPpk(EcPk fromPem) Get PPK from PK (if we have it)
static void	identityChanged(EcIdentity identity) Trigger for the onIdentityChanged hook
static void	main(String[] args)
static String	myIdentitiesSearchString()
static void	readContacts() Reads contact data from localstorage.
static void	readIdentities() Reads contact data from localstorage.
static void	saveIdentities() Writes contact data to localstorage.
static void	sign(org.cassproject.schema.general.EcRemoteLinkedData d) Sign a piece of data with all available keys that own that data.
static String	signatureSheet(long duration, String server) Create a signature sheet for all identities, authorizing movement of data outside of our control.
static void	signatureSheetAsync(long duration, String server, org.stjs.javascript.functions.Callback1<String> success, org.stjs.javascript.functions.Callback1<String> failure) Asynchronous version of creating a signature sheet for all identities
static String	signatureSheetFor(org.stjs.javascript.Array<String> identityPksinPem, long duration, String server) Create a signature sheet, authorizing movement of data outside of our control.
static void	signatureSheetForAsync(org.stjs.javascript.Array<String> identityPksinPem, long duration, String server, org.stjs.javascript.functions.Callback1<String> success, org.stjs.javascript.functions.Callback1<String> failure) Asynchronous version of creating a signature sheet for a list of identities

Methods inherited from class java.lang.Object

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

Field Detail

ids

public static org.stjs.javascript.Array<EcIdentity> ids

The current user's owned identities (keys+displayName)

contacts

public static org.stjs.javascript.Array<EcContact> contacts

Contacts (Keys that we do not own)

onIdentityChanged

public static org.stjs.javascript.functions.Callback1<EcIdentity> onIdentityChanged

Identity change hook.

onContactChanged

public static org.stjs.javascript.functions.Callback1<EcContact> onContactChanged

Contacts change hook.

signatureSheetCaching

public static boolean signatureSheetCaching

signatureSheetCache

public static Object signatureSheetCache

Constructor Detail

EcIdentityManager

public EcIdentityManager()

Method Detail

main

public static void main(String[] args)

identityChanged

public static void identityChanged(EcIdentity identity)

Trigger for the onIdentityChanged hook

Parameters:

{EcIdentity} - identity Identity that has changed

contactChanged

public static void contactChanged(EcContact contact)

Trigger for the onContactChanged hook

Parameters:

{EcContact} - contact Contact that has changed

readContacts

public static void readContacts()

Reads contact data from localstorage.

readIdentities

public static void readIdentities()

Reads contact data from localstorage.

saveIdentities

public static void saveIdentities()

Writes contact data to localstorage.

clearContacts

public static void clearContacts()

Clears contacts from the local storage

clearIdentities

public static void clearIdentities()

Clears identities from the local storage

addIdentity

public static void addIdentity(EcIdentity identity)

Adds an identity to the identity manager. Checks for duplicates. Triggers events.

Parameters:

{EcIdentity} - identity Identity to add.

addIdentityQuietly

public static void addIdentityQuietly(EcIdentity identity)

Adds an identity to the identity manager. Checks for duplicates. Does not trigger events.

Parameters:

{EcIdentity} - identity Identity to add.

addContact

public static void addContact(EcContact contact)

Adds a contact to the identity manager. Checks for duplicates. Triggers events.

Parameters:

{EcContact} - contact Contact to add.

addContactQuietly

public static void addContactQuietly(EcContact contact)

Adds a contact to the identity manager. Checks for duplicates. Does not trigger events.

Parameters:

{EcContact} - contact Contact to add.

signatureSheetFor

public static String signatureSheetFor(org.stjs.javascript.Array<String> identityPksinPem,
                                       long duration,
                                       String server)

Create a signature sheet, authorizing movement of data outside of our control.

Parameters:

{String[]} - identityPksinPem Which identities to create signatures for.

{long} - duration Length of time in milliseconds to authorize control.

{String} - server Server that we are authorizing.

Returns:

{String} JSON Array containing signatures.

signatureSheetForAsync

public static void signatureSheetForAsync(org.stjs.javascript.Array<String> identityPksinPem,
                                          long duration,
                                          String server,
                                          org.stjs.javascript.functions.Callback1<String> success,
                                          org.stjs.javascript.functions.Callback1<String> failure)

Asynchronous version of creating a signature sheet for a list of identities

Parameters:

{String[]} - identityPksinPem Which identities to create signatures for.

{long} - duration Length of time in milliseconds to authorize control.

{String} - server Server that we are authorizing.

{Callback1} - success Callback triggered once the signature sheet has been created, returns the signature sheet

signatureSheet

public static String signatureSheet(long duration,
                                    String server)

Create a signature sheet for all identities, authorizing movement of data outside of our control.

Parameters:

{long} - duration Length of time in milliseconds to authorize control.

{String} - server Server that we are authorizing.

Returns:

{String} JSON Array containing signatures.

signatureSheetAsync

public static void signatureSheetAsync(long duration,
                                       String server,
                                       org.stjs.javascript.functions.Callback1<String> success,
                                       org.stjs.javascript.functions.Callback1<String> failure)

Asynchronous version of creating a signature sheet for all identities

Parameters:

{long} - duration Length of time in milliseconds to authorize control.

{String} - server Server that we are authorizing.

{Callback} - success Callback triggered once the signature sheet has been created, returns the signature sheet

createSignature

public static EbacSignature createSignature(long duration,
                                            String server,
                                            EcPpk ppk)

Create a signature for a specific identity, authorizing movement of data outside of our control.

Parameters:

{long} - duration Length of time in milliseconds to authorize control.

{String} - server Server that we are authorizing.

{EcPpk} - ppk Key of the identity to create a signature for

Returns:

{Ebac Signature} Signature created

getPpk

public static EcPpk getPpk(EcPk fromPem)

Get PPK from PK (if we have it)

Parameters:

{EcPk} - fromPem PK to use to look up PPK

Returns:

{EcPpk} PPK or null.

getContact

public static EcContact getContact(EcPk pk)

Get Contact from PK (if we have it)

Parameters:

{EcPk} - pk PK to use to look up PPK

Returns:

{EcPpk} PPK or null.

getIdentity

public static EcIdentity getIdentity(EcPk pk)

Get Identity from PK (if we have it)

Parameters:

{EcPk} - pk PK to use to look up PPK

Returns:

{EcIdentity} identity or null.

sign

public static void sign(org.cassproject.schema.general.EcRemoteLinkedData d)

Sign a piece of data with all available keys that own that data.

Parameters:

{EcRemoteLinkedData} - d Data to sign.

myIdentitiesSearchString

public static String myIdentitiesSearchString()

getMyPks

public static org.stjs.javascript.Array<EcPk> getMyPks()