java.lang.Object

i5.las2peer.security.PassphraseAgentImpl

All Implemented Interfaces:: Agent, PassphraseAgent, MessageReceiver, XmlAble, java.lang.Cloneable

Direct Known Subclasses:: MonitoringAgent, ServiceAgentImpl, UserAgentImpl

public abstract class PassphraseAgentImpl
extends AgentImpl
implements PassphraseAgent

Base class for pass phrase protected agents.

Constructor Summary

Constructors
Modifier	Constructor	Description
`protected`	`PassphraseAgentImpl(java.security.KeyPair pair, java.lang.String passphrase, byte[] salt)`	atm constructor for the MockAgent class, just don't know, how agent creation will take place later
`protected`	`PassphraseAgentImpl(java.security.PublicKey pubKey, byte[] encodedPrivate, byte[] salt)`	create an agent with a locked private key used within `AgentImpl.createFromXml(java.io.File)`

Method Summary

Modifier and Type	Method	Description
`void`	`changePassphrase(java.lang.String passphrase)`	Change the passphrase for unlocking the private key.
`java.lang.String`	`getPassphrase()`	Gets the current passphrase
`protected byte[]`	`getSalt()`	provide access to salt for subclasses (security risk?
`void`	`lockPrivateKey()`	(Re-)Lock the private key.
`void`	`unlock(java.lang.String passphrase)`	Unlocks this agent.
`void`	`unlockPrivateKey(java.lang.String passphrase)`

Methods inherited from class i5.las2peer.security.AgentImpl

cloneLocked, createFromXml, createFromXml, createFromXml, createFromXml, createSignature, decryptSymmetricKey, encryptPrivateKey, equals, getEncodedPrivate, getIdentifier, getPublicKey, getResponsibleForAgentSafeId, getRunningAtNode, isLocked, notifyRegistrationTo, notifyUnregister, receiveMessage, signContent, unlockPrivateKey

Methods inherited from class java.lang.Object

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

Methods inherited from interface i5.las2peer.api.security.Agent

getIdentifier, isLocked

Methods inherited from interface i5.las2peer.serialization.XmlAble

toXmlString

Constructor Details
- PassphraseAgentImpl
  
  protected PassphraseAgentImpl(java.security.KeyPair pair, java.lang.String passphrase, byte[] salt) throws AgentOperationFailedException, CryptoException
  
  atm constructor for the MockAgent class, just don't know, how agent creation will take place later
  
  Parameters:
  
  pair -
  
  passphrase -
  
  salt -
  
  Throws:
  
  AgentOperationFailedException
  
  CryptoException
- PassphraseAgentImpl
  
  protected PassphraseAgentImpl(java.security.PublicKey pubKey, byte[] encodedPrivate, byte[] salt)
  
  create an agent with a locked private key used within AgentImpl.createFromXml(java.io.File)
  
  Parameters:
  
  pubKey -
  
  encodedPrivate -
  
  salt -
Method Details
- unlock
  
  public void unlock(java.lang.String passphrase) throws AgentAccessDeniedException, AgentOperationFailedException
  
  Description copied from interface: PassphraseAgent
  
  Unlocks this agent.
  
  Specified by:
  
  unlock in interface PassphraseAgent
  
  Parameters:
  
  passphrase - The passphrase to unlock this agent.
  
  Throws:
  
  AgentAccessDeniedException - If the passphrase is not valid.
  
  AgentOperationFailedException - If the agent's private key can not be deserialized.
- unlockPrivateKey
  
  public void unlockPrivateKey(java.lang.String passphrase) throws AgentAccessDeniedException, AgentOperationFailedException
  
  Specified by:
  
  unlockPrivateKey in interface PassphraseAgent
  
  Parameters:
  
  passphrase - The passphrase to unlock this agent.
  
  Throws:
  
  AgentAccessDeniedException - If the passphrase is not valid.
  
  AgentOperationFailedException - If the agent's private key can not be deserialized.
- getSalt
  
  protected byte[] getSalt()
  
  provide access to salt for subclasses (security risk? - probably not)
  
  Returns:
  
  the random salt used to encode the private key
- changePassphrase
  
  public void changePassphrase(java.lang.String passphrase) throws AgentOperationFailedException, AgentLockedException
  
  Change the passphrase for unlocking the private key. The key has to be unlocked first, of course.
  
  Parameters:
  
  passphrase -
  
  Throws:
  
  AgentOperationFailedException
  
  AgentLockedException
- lockPrivateKey
  
  public void lockPrivateKey()
  
  Description copied from class: AgentImpl
  
  (Re-)Lock the private key.
  
  Overrides:
  
  lockPrivateKey in class AgentImpl
- getPassphrase
  
  public java.lang.String getPassphrase() throws AgentLockedException
  
  Gets the current passphrase
  
  Returns:
  
  Returns the passphrase of this agent
  
  Throws:
  
  AgentLockedException

Class PassphraseAgentImpl