Package i5.las2peer.security

Class AnonymousAgentImpl

java.lang.Object

i5.las2peer.security.AgentImpl

i5.las2peer.security.AnonymousAgentImpl

All Implemented Interfaces:

Agent, AnonymousAgent, MessageReceiver, XmlAble, Cloneable

public class AnonymousAgentImpl
extends AgentImpl
implements AnonymousAgent

Field Summary

Fields inherited from interface i5.las2peer.api.security.AnonymousAgent

IDENTIFIER, LOGIN_NAME

Method Summary

Modifier and Type	Method	Description
Signature	createSignature()	Uses the CryptoTools to create a java.security.Signature and initializes the object for signing with the agent's private key.
SecretKey	decryptSymmetricKey(byte[] crypted)	Uses the CryptoTools to decrypt the passed crypted content with the agent's private key.
void	encryptPrivateKey(SecretKey key)	Encrypts the private key into a byte array with strong encryption based on a passphrase.
boolean	equals(Object other)
String	getIdentifier()	The agent id
static AnonymousAgentImpl	getInstance()
PublicKey	getPublicKey()
boolean	isLocked()	Returns whether the agent is locked or not.
void	receiveMessage(Message message, AgentContext c)	Hook to be called by the node where this agent is registered to, when the node receives a message destined to this agent.
byte[]	signContent(byte[] plainData)	Uses the CryptoTools to sign the passed data with the agent's private key.
String	toXmlString()	Returns a XML representation of this object.
void	unlockPrivateKey(SecretKey key)	Unlocks the private key.

Methods inherited from class i5.las2peer.security.AgentImpl

cloneLocked, createFromXml, createFromXml, createFromXml, createFromXml, getEncodedPrivate, getResponsibleForAgentSafeId, getRunningAtNode, lockPrivateKey, notifyRegistrationTo, notifyUnregister

Methods inherited from class java.lang.Object

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

Method Details

getInstance

public static AnonymousAgentImpl getInstance()

toXmlString

public String toXmlString()

Description copied from interface: XmlAble

Returns a XML representation of this object.

Specified by:

toXmlString in interface XmlAble

Returns:

a XML String representation

receiveMessage

public void receiveMessage(Message message,
 AgentContext c)
                    throws MessageException

Description copied from class: AgentImpl

Hook to be called by the node where this agent is registered to, when the node receives a message destined to this agent.

Specified by:

receiveMessage in interface MessageReceiver

Specified by:

receiveMessage in class AgentImpl

Throws:

MessageException

unlockPrivateKey

public void unlockPrivateKey(SecretKey key)

Description copied from class: AgentImpl

Unlocks the private key.

Overrides:

unlockPrivateKey in class AgentImpl

Parameters:

key - A key that is used to unlock the agents private key.

encryptPrivateKey

public void encryptPrivateKey(SecretKey key)

Description copied from class: AgentImpl

Encrypts the private key into a byte array with strong encryption based on a passphrase. to unlock the key

Overrides:

encryptPrivateKey in class AgentImpl

Parameters:

key - A key that is used to encrypt the agents private key.

isLocked

public boolean isLocked()

Description copied from interface: Agent

Returns whether the agent is locked or not.

Specified by:

isLocked in interface Agent

Overrides:

isLocked in class AgentImpl

Returns:

true, if the private key of this agent is still locked

getIdentifier

public String getIdentifier()

Description copied from interface: Agent

The agent id

Specified by:

getIdentifier in interface Agent

Overrides:

getIdentifier in class AgentImpl

Returns:

The agent id.

getPublicKey

public PublicKey getPublicKey()

Overrides:

getPublicKey in class AgentImpl

Returns:

the cryptographic public key of this agent

decryptSymmetricKey

public SecretKey decryptSymmetricKey(byte[] crypted)
                              throws AgentLockedException,
SerializationException,
CryptoException

Description copied from class: AgentImpl

Uses the CryptoTools to decrypt the passed crypted content with the agent's private key.

Overrides:

decryptSymmetricKey in class AgentImpl

Parameters:

crypted - The encrypted content that is decrypted using the agents private key.

Returns:

Returns a SecretKey decrypted from the crypted input and the agent's private key

Throws:

AgentLockedException - the private key has not been unlocked yet

SerializationException - If an issue occurs with deserializing the given and decrypted data.

CryptoException - If an issue occurs with decryption.

createSignature

public Signature createSignature()
                          throws InvalidKeyException,
AgentLockedException,
NoSuchAlgorithmException

Description copied from class: AgentImpl

Uses the CryptoTools to create a java.security.Signature and initializes the object for signing with the agent's private key.

Overrides:

createSignature in class AgentImpl

Returns:

a java.security.Signature

Throws:

InvalidKeyException

AgentLockedException - the private key has not been unlocked yet

NoSuchAlgorithmException

signContent

public byte[] signContent(byte[] plainData)
                   throws CryptoException,
AgentLockedException

Description copied from class: AgentImpl

Uses the CryptoTools to sign the passed data with the agent's private key.

Overrides:

signContent in class AgentImpl

Parameters:

plainData - The plain data to sign

Returns:

Returns a signed version of the input

Throws:

CryptoException

AgentLockedException - the private key has not been unlocked yet

equals

public boolean equals(Object other)

Overrides:

equals in class AgentImpl