Authentication
API v8.1 SP2

com.rsa.ace.techservice.udpserver
Class AceAuthV3Request

java.lang.Object
  extended by com.rsa.ace.techservice.udpserver.AbstractAceRequest
      extended by com.rsa.ace.techservice.udpserver.AbstractV3Request
          extended by com.rsa.ace.techservice.udpserver.AceAuthV3Request
All Implemented Interfaces:
AceRequest
Direct Known Subclasses:
AceClientAuthV3Request

public class AceAuthV3Request
extends AbstractV3Request
implements AceRequest

This class represents an Ace Authentication Version 3 Request use by cross realm.

Usage:


      // Creates a new request object for the Agent.
      AceAuthV3Request request = new AceAuthV3Request("username", "pin", "passcode");

             // Get the packet
      DatagramPacket packet = request.getPacket();

      // After the packet can be sent to the server and the server can recreate the request
      // from the packet. THIS NEEDS TO BE IMPLEMENTED PROPERLY.

      AceAuthV3Request request = new AceAuthV3Request(packet);

      // Process the request by decrypting is necessary
                 request.processRequest();

             // Get the gesponse to the request.
      request.getResponse();




 


Nested Class Summary
 
Nested classes/interfaces inherited from class com.rsa.ace.techservice.udpserver.AbstractV3Request
AbstractV3Request.MessageType
 
Field Summary
 
Fields inherited from interface com.rsa.ace.techservice.udpserver.AceRequest
NO_RESPONSE, QUEUE_RESPONSE, RESPOND_NOW
 
Constructor Summary
AceAuthV3Request(AceDatagram pkt)
          Creates a new instance of AceAuthV3Request from a datagram.
AceAuthV3Request(java.lang.String username, java.lang.String pin, java.lang.String prn, AgentConfig agentConfig)
          Creates a new instance of AceAuthV3Request.
 
Method Summary
 AceDatagram getPacket()
          Provides the original packet received from the agent.
 AceResponse getResponse()
          Get an AceResponse from this request.
 byte[] getWpCode()
           
 Passkey getWpCodes(int i)
           
 int processRequest()
          Processes a V3 auth request.
 java.lang.String toString()
          String conversion method.
 
Methods inherited from class com.rsa.ace.techservice.udpserver.AbstractAceRequest
getAcePinUtil, getAgentConfig, getBuffer, getCipherProvider, getCreationTime, getEncryptOffset, getHeader, getNonce, getProtocolVersion, getSecretKey, haveNodeSecret, haveSecretKey, readTrailer, setEncode, setEncryptOffset, setNodeSecret, setSecretKey, setTrailer
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.rsa.ace.techservice.udpserver.AceRequest
getAgentConfig, getCipherProvider, getCreationTime, getHeader, getNonce, getProtocolVersion
 

Constructor Detail

AceAuthV3Request

public AceAuthV3Request(AceDatagram pkt)
                 throws AcePacketException
Creates a new instance of AceAuthV3Request from a datagram. Use by the Sever only

Parameters:
pkt - The packet used to construct the request.
Throws:
AcePacketException

AceAuthV3Request

public AceAuthV3Request(java.lang.String username,
                        java.lang.String pin,
                        java.lang.String prn,
                        AgentConfig agentConfig)
                 throws AcePacketException
Creates a new instance of AceAuthV3Request. Use by the Agent only

Parameters:
String - username
String - pin
String - prn
Throws:
AcePacketException - If an error occurs constructing the header.
Method Detail

processRequest

public int processRequest()
                   throws AcePacketException
Processes a V3 auth request. This is the actual function to process this type of packet. This always requests the packet to be queued. This constructs the appropriate response based on the passcode verification.

Specified by:
processRequest in interface AceRequest
Overrides:
processRequest in class AbstractAceRequest
Returns:
An AceRequest status providing the disposition of the packet.
Throws:
AcePacketException - If an exception occurs building the repsonse.

getResponse

public AceResponse getResponse()
Get an AceResponse from this request.

Specified by:
getResponse in interface AceRequest
Returns:
An AceResponse of the appropriate type.

toString

public java.lang.String toString()
String conversion method.

Specified by:
toString in interface AceRequest
Overrides:
toString in class AbstractV3Request
Returns:
A String representation of the V3 auth request.

getPacket

public AceDatagram getPacket()
                      throws AcePacketException
Provides the original packet received from the agent.

Specified by:
getPacket in interface AceRequest
Overrides:
getPacket in class AbstractAceRequest
Returns:
The original input packet.
Throws:
AcePacketException

getWpCodes

public Passkey getWpCodes(int i)
Returns:
Returns the wpCodes.

getWpCode

public byte[] getWpCode()
Specified by:
getWpCode in interface AceRequest
Overrides:
getWpCode in class AbstractAceRequest
Returns:
Returns the wpCode use by the response.

Authentication
API v8.1 SP2

Copyright © 1999 - 2011 EMC Corporation. All Rights Reserved.