net.named_data.jndn.security.identity

Class MemoryIdentityStorage

java.lang.Object

net.named_data.jndn.security.identity.IdentityStorage

net.named_data.jndn.security.identity.MemoryIdentityStorage

public class MemoryIdentityStorage
extends IdentityStorage

MemoryIdentityStorage extends IdentityStorage and implements its methods to store identity, public key and certificate objects in memory. The application must get the objects through its own means and add the objects to the MemoryIdentityStorage object. To use permanent file-based storage, see BasicIdentityStorage.

Constructor Summary

Constructors

Constructor and Description
MemoryIdentityStorage()

Method Summary

Modifier and Type	Method and Description
void	activateKey(Name keyName) Activate a key.
void	addCertificate(IdentityCertificate certificate) Add a certificate to the identity storage.
void	addIdentity(Name identityName) Add a new identity.
void	addKey(Name keyName, KeyType keyType, Blob publicKeyDer) Add a public key to the identity storage.
void	deactivateKey(Name keyName) Deactivate a key.
void	deleteCertificateInfo(Name certificateName) Delete a certificate.
void	deleteIdentityInfo(Name identity) Delete an identity and related public keys and certificates.
void	deletePublicKeyInfo(Name keyName) Delete a public key and related certificates.
boolean	doesCertificateExist(Name certificateName) Check if the specified certificate already exists.
boolean	doesIdentityExist(Name identityName) Check if the specified identity already exists.
boolean	doesKeyExist(Name keyName) Check if the specified key already exists.
void	getAllCertificateNamesOfKey(Name keyName, ArrayList nameList, boolean isDefault) Append all the certificate names of a particular key name to the nameList.
void	getAllIdentities(ArrayList nameList, boolean isDefault) Append all the identity names to the nameList.
void	getAllKeyNamesOfIdentity(Name identityName, ArrayList nameList, boolean isDefault) Append all the key names of a particular identity to the nameList.
IdentityCertificate	getCertificate(Name certificateName) Get a certificate from the identity storage.
Name	getDefaultCertificateNameForKey(Name keyName) Get the default certificate name for the specified key.
Name	getDefaultIdentity() Get the default identity.
Name	getDefaultKeyNameForIdentity(Name identityName) Get the default key name for the specified identity.
Blob	getKey(Name keyName) Get the public key DER blob from the identity storage.
String	getTpmLocator() Get the TPM locator associated with this storage.
boolean	revokeIdentity() Revoke the identity.
void	setDefaultCertificateNameForKey(Name keyName, Name certificateName) Set the default key name for the specified identity.
void	setDefaultIdentity(Name identityName) Set the default identity.
void	setDefaultKeyNameForIdentity(Name keyName, Name identityNameCheck) Set a key as the default key of an identity.

Methods inherited from class net.named_data.jndn.security.identity.IdentityStorage

getDefaultCertificate, getDefaultCertificateNameForIdentity, getNewKeyName, setDefaultKeyNameForIdentity

Methods inherited from class java.lang.Object

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

Constructor Detail

MemoryIdentityStorage

public MemoryIdentityStorage()

Method Detail

doesIdentityExist

public boolean doesIdentityExist(Name identityName)

Check if the specified identity already exists.

Specified by:

doesIdentityExist in class IdentityStorage

Parameters:

identityName - The identity name.

Returns:

True if the identity exists, otherwise false.

addIdentity

public void addIdentity(Name identityName)
                 throws SecurityException

Add a new identity. Do nothing if the identity already exists.

Specified by:

addIdentity in class IdentityStorage

Parameters:

identityName - The identity name to be added.

Throws:

SecurityException

revokeIdentity

public boolean revokeIdentity()

Revoke the identity.

Specified by:

revokeIdentity in class IdentityStorage

Returns:

True if the identity was revoked, false if not.

doesKeyExist

public boolean doesKeyExist(Name keyName)
                     throws SecurityException

Check if the specified key already exists.

Specified by:

doesKeyExist in class IdentityStorage

Parameters:

keyName - The name of the key.

Returns:

true if the key exists, otherwise false.

Throws:

SecurityException

addKey

public void addKey(Name keyName,
                   KeyType keyType,
                   Blob publicKeyDer)
            throws SecurityException

Add a public key to the identity storage. Also call addIdentity to ensure that the identityName for the key exists. However, if the key already exists, do nothing.

Specified by:

addKey in class IdentityStorage

Parameters:

keyName - The name of the public key to be added.

keyType - Type of the public key to be added.

publicKeyDer - A blob of the public key DER to be added.

Throws:

SecurityException

getKey

public Blob getKey(Name keyName)
            throws SecurityException

Get the public key DER blob from the identity storage.

Specified by:

getKey in class IdentityStorage

Parameters:

keyName - The name of the requested public key.

Returns:

The DER Blob.

Throws:

SecurityException - if the key doesn't exist.

activateKey

public void activateKey(Name keyName)

Activate a key. If a key is marked as inactive, its private part will not be used in packet signing.

Specified by:

activateKey in class IdentityStorage

Parameters:

keyName - The name of the key.

deactivateKey

public void deactivateKey(Name keyName)

Deactivate a key. If a key is marked as inactive, its private part will not be used in packet signing.

Specified by:

deactivateKey in class IdentityStorage

Parameters:

keyName - The name of the key.

doesCertificateExist

public boolean doesCertificateExist(Name certificateName)

Check if the specified certificate already exists.

Specified by:

doesCertificateExist in class IdentityStorage

Parameters:

certificateName - The name of the certificate.

Returns:

True if the certificate exists, otherwise false.

addCertificate

public void addCertificate(IdentityCertificate certificate)
                    throws SecurityException

Add a certificate to the identity storage. Also call addKey to ensure that the certificate key exists. If the certificate is already installed, don't replace it.

Specified by:

addCertificate in class IdentityStorage

Parameters:

certificate - The certificate to be added. This makes a copy of the certificate.

Throws:

SecurityException

getCertificate

public IdentityCertificate getCertificate(Name certificateName)
                                   throws SecurityException

Get a certificate from the identity storage.

Specified by:

getCertificate in class IdentityStorage

Parameters:

certificateName - The name of the requested certificate.

Returns:

The requested certificate.

Throws:

SecurityException - if the certificate doesn't exist.

getTpmLocator

public final String getTpmLocator()
                           throws SecurityException

Get the TPM locator associated with this storage.

Specified by:

getTpmLocator in class IdentityStorage

Returns:

The TPM locator.

Throws:

SecurityException - if the TPM locator doesn't exist.

getDefaultIdentity

public Name getDefaultIdentity()
                        throws SecurityException

Get the default identity.

Specified by:

getDefaultIdentity in class IdentityStorage

Returns:

The name of default identity.

Throws:

SecurityException - if the default identity is not set.

getDefaultKeyNameForIdentity

public Name getDefaultKeyNameForIdentity(Name identityName)
                                  throws SecurityException

Get the default key name for the specified identity.

Specified by:

getDefaultKeyNameForIdentity in class IdentityStorage

Parameters:

identityName - The identity name.

Returns:

The default key name.

Throws:

SecurityException - if the default key name for the identity is not set.

getDefaultCertificateNameForKey

public Name getDefaultCertificateNameForKey(Name keyName)
                                     throws SecurityException

Get the default certificate name for the specified key.

Specified by:

getDefaultCertificateNameForKey in class IdentityStorage

Parameters:

keyName - The key name.

Returns:

The default certificate name.

Throws:

SecurityException - if the default certificate name for the key name is not set.

getAllIdentities

public void getAllIdentities(ArrayList nameList,
                             boolean isDefault)

Append all the identity names to the nameList.

Specified by:

getAllIdentities in class IdentityStorage

Parameters:

nameList - Append result names to nameList.

isDefault - If true, add only the default identity name. If false, add only the non-default identity names.

getAllKeyNamesOfIdentity

public void getAllKeyNamesOfIdentity(Name identityName,
                                     ArrayList nameList,
                                     boolean isDefault)

Append all the key names of a particular identity to the nameList.

Specified by:

getAllKeyNamesOfIdentity in class IdentityStorage

Parameters:

identityName - The identity name to search for.

nameList - Append result names to nameList.

isDefault - If true, add only the default key name. If false, add only the non-default key names.

getAllCertificateNamesOfKey

public void getAllCertificateNamesOfKey(Name keyName,
                                        ArrayList nameList,
                                        boolean isDefault)
                                 throws SecurityException

Append all the certificate names of a particular key name to the nameList.

Specified by:

getAllCertificateNamesOfKey in class IdentityStorage

Parameters:

keyName - The key name to search for.

nameList - Append result names to nameList.

isDefault - If true, add only the default certificate name. If false, add only the non-default certificate names.

Throws:

SecurityException

setDefaultIdentity

public void setDefaultIdentity(Name identityName)

Set the default identity. If the identityName does not exist, then clear the default identity so that getDefaultIdentity() throws an exception.

Specified by:

setDefaultIdentity in class IdentityStorage

Parameters:

identityName - The default identity name.

setDefaultKeyNameForIdentity

public void setDefaultKeyNameForIdentity(Name keyName,
                                         Name identityNameCheck)
                                  throws SecurityException

Set a key as the default key of an identity. The identity name is inferred from keyName.

Specified by:

setDefaultKeyNameForIdentity in class IdentityStorage

Parameters:

keyName - The name of the key.

identityNameCheck - The identity name to check that the keyName contains the same identity name. If an empty name, it is ignored.

Throws:

SecurityException

setDefaultCertificateNameForKey

public void setDefaultCertificateNameForKey(Name keyName,
                                            Name certificateName)

Set the default key name for the specified identity.

Specified by:

setDefaultCertificateNameForKey in class IdentityStorage

Parameters:

keyName - The key name.

certificateName - The certificate name.

deleteCertificateInfo

public void deleteCertificateInfo(Name certificateName)
                           throws SecurityException

Delete a certificate.

Specified by:

deleteCertificateInfo in class IdentityStorage

Parameters:

certificateName - The certificate name.

Throws:

SecurityException

deletePublicKeyInfo

public void deletePublicKeyInfo(Name keyName)
                         throws SecurityException

Delete a public key and related certificates.

Specified by:

deletePublicKeyInfo in class IdentityStorage

Parameters:

keyName - The key name.

Throws:

SecurityException

deleteIdentityInfo

public void deleteIdentityInfo(Name identity)
                        throws SecurityException

Delete an identity and related public keys and certificates.

Specified by:

deleteIdentityInfo in class IdentityStorage

Parameters:

identity - The identity name.

Throws:

SecurityException