net.cnri.dobj

Class PKAuthentication

java.lang.Object

net.cnri.dobj.AbstractAuthentication

net.cnri.dobj.PKAuthentication

All Implemented Interfaces:

DOAuthentication

public class PKAuthentication
extends AbstractAuthentication

A PKAuthentication object uses a private key to prove our identity. The certificate credentials are handled as part of the AbstractAuthentication parent class.

Constructor Summary

Constructors

Constructor and Description
PKAuthentication(java.lang.String myID, java.security.PrivateKey myKey) Construct an authentication object that uses the given private key to prove that we are the entity identified by myID.

Method Summary

Methods

Modifier and Type	Method and Description
AbstractAuthentication	cloneAuthentication() The following must be implemented by subclasses of AbstractAuthentication in order to provide a copy of themselves for the purposes of authenticating when retrieving their credentials.
java.lang.String	getID() Returns the identifier representing the entity that is supposed to be authenticated by this object.
static java.lang.String	getSigAlgForKeyAlg(java.lang.String keyAlg)
void	initialize()
static PKAuthentication	readPKAuthenticationFromFile(java.lang.String myID, java.lang.String privateKeyFile, java.lang.String passphrase) Convenience method to read a private key from a file, decrypt that key with the given passphrase and return a PKAuthentication object for the given ID.
void	signChallenge(HeaderSet challenge, HeaderSet response) Signs the given challenge message and puts the result (including any required parameters) into the given HeaderSet object.
net.handle.hdllib.AuthenticationInfo	toHandleAuth() Returns this authentication in a form that will work with handle system administration.
java.lang.String	toString()

Methods inherited from class net.cnri.dobj.AbstractAuthentication

getAnonymousAuth, getCredentials, setAutoRetrieveCredentials, setCredentials

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PKAuthentication

public PKAuthentication(java.lang.String myID,
                java.security.PrivateKey myKey)

Construct an authentication object that uses the given private key to prove that we are the entity identified by myID.

Method Detail

toHandleAuth

public net.handle.hdllib.AuthenticationInfo toHandleAuth()

Returns this authentication in a form that will work with handle system administration.

getID

public java.lang.String getID()

Returns the identifier representing the entity that is supposed to be authenticated by this object.

See Also:

DOAuthentication.getID()

cloneAuthentication

public AbstractAuthentication cloneAuthentication()

The following must be implemented by subclasses of AbstractAuthentication in order to provide a copy of themselves for the purposes of authenticating when retrieving their credentials. The returned object will have the autoRetrieveCredentials option turned off when retrieving the credentials in order to avoid a recursive loop when authenticating with the server that holds the credentials.

Specified by:

cloneAuthentication in class AbstractAuthentication

readPKAuthenticationFromFile

public static final PKAuthentication readPKAuthenticationFromFile(java.lang.String myID,
                                            java.lang.String privateKeyFile,
                                            java.lang.String passphrase)
                                                           throws java.lang.Exception

Convenience method to read a private key from a file, decrypt that key with the given passphrase and return a PKAuthentication object for the given ID.

Throws:

java.lang.Exception

initialize

public void initialize()
                throws java.lang.Exception

Throws:

java.lang.Exception

signChallenge

public void signChallenge(HeaderSet challenge,
                 HeaderSet response)
                   throws java.lang.Exception

Description copied from interface: DOAuthentication

Signs the given challenge message and puts the result (including any required parameters) into the given HeaderSet object.

Throws:

java.lang.Exception

getSigAlgForKeyAlg

public static final java.lang.String getSigAlgForKeyAlg(java.lang.String keyAlg)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object