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

Methods

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	getAllKeyNamesOfIdentity(Name identityName, ArrayList nameList, boolean isDefault) Append all the key names of a particular identity to the nameList.
IdentityCertificate	getCertificate(Name certificateName, boolean allowAny) 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.
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 the default key name for the specified identity.

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

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

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 - if a key with the keyName already exists.

getKey

public Blob getKey(Name keyName)

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. If not found, return a Blob with a null pointer.

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.

Specified by:

addCertificate in class IdentityStorage

Parameters:

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

Throws:

SecurityException - if the certificate is already installed.

getCertificate

public IdentityCertificate getCertificate(Name certificateName,
                                 boolean allowAny)

Get a certificate from the identity storage.

Specified by:

getCertificate in class IdentityStorage

Parameters:

certificateName - The name of the requested certificate.

allowAny - If false, only a valid certificate will be returned, otherwise validity is disregarded.

Returns:

The requested certificate. If not found, return null.

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.

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.

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)

Set the default key name for the specified identity.

Specified by:

setDefaultKeyNameForIdentity in class IdentityStorage

Parameters:

keyName - The key name.

identityNameCheck - The identity name to check the keyName.

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