com.entrust.toolkit.util

Class HttpManagerServlet

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

com.entrust.toolkit.util.HttpManagerServlet

All Implemented Interfaces:

java.io.Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig, javax.servlet.SingleThreadModel

public class HttpManagerServlet
extends javax.servlet.http.HttpServlet
implements javax.servlet.SingleThreadModel

The HttpManagerServlet class is a servlet that acts as a proxy for client requests to an Entrust PKI, allowing users to be initialized through an http tunnel.

To use this class:

1. Create a class called ManagerServlet (or any other name you choose) using the following code

        import com.entrust.toolkit.util.HttpManagerServlet;
        public class ManagerServlet extends com.entrust.toolkit.util.HttpManagerServlet {
        }
     

2. Put ManagerServlet into your Web server's servlet folder. The specific location depends on the Web server you are using.

The HttpManagerServlet class receives the IP address and port number of an Entrust PKI as parameters called managerIP and managerPort. Configure this servlet using these paramenters. Specific configuration details depend on the Web server you are using. For example, the servletrunner program that is part of Sun's J2SDK, uses a servlet.properties file to pass configuration parameters to each servlet. A sample servlet.properties file for ManagerServlet contains the following information:

     # Manager servlet
     servlet.mainManager.code=ManagerServlet
     servlet.mainManager.initArgs=\
           managerIP=47.97.235.29,\
           managerPort=829,\
           maximumLifetime=3600,\
           debug=false
  

If you want to use this example, edit it to reflect the name and URL you choose for your servlet.

If you have several PKI's, you can re-use this HttpManagerServlet class. Wrap it in a second ManagerServlet class as above, but give it a new name. For example, the following servlet acts as a proxy for PKIX-CMP messages to port number 829.

     # Manager servlet
     servlet.backupManager.code=ManagerServletTwo
     servlet.backupManager.initArgs=\
           managerIP=47.97.235.30,\
           managerPort=829,\
           maximumLifetime=3600,\
           debug=false
 

Note

Typically, use port number 829 with the PKIX-CMP protocol.

Using the names in the example, the HttpManagerClient communicates with each HttpManagerServlet as follows:

     ManagerTransport main   = new HttpManagerClient("http://wothdmontg.entrust.com:80/servlet/mainManager",   0, "47.97.235.29");
     ManagerTransport backup = new HttpManagerClient("http://wothdmontg.entrust.com:80/servlet/backupManager", 0, "47.97.235.30");
 

The Web server is using port number 80 on wothdmontg.entrust.com, and the class files, ManagerServlet and ManagerServletTwo, are located in the server's servlet folder.

The value of the maximumLifetime property represents the maximum allowed time interval in seconds between client messages. The default value is is one hour.

Note

The HttpManagerClient constructor takes the PKI Manager's IP address as a parameter even though it's messages to the PKI are sent through a proxy. The managerIP parameter is required by the PKIX protocol itself, so the ManagerTransport superclass requires that address. If the address supplied by the application does not match the IP address of the PKI Manager, the PKIX protocol will fail. Ideally, the address should be specified in numeric IP address 'dot' format, 47.97.235.29 for example, but if supplied as a symbolic name, the constructor will attempt to resolve it using a DNS lookup.

See Also:

HttpManagerClient, Serialized Form

Constructor Summary

Constructors

Constructor and Description
HttpManagerServlet()

Method Summary

Methods

Modifier and Type	Method and Description
void	doGet(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res) Call the doGet() method in HttpManagerServletEngine class.
void	doPost(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res) Call the doPost() method in HttpManagerServletEngine class.
java.lang.String	getServletInfo() Returns a short description of this servlet.
void	init(javax.servlet.ServletConfig config) Overrides the init method in the servlet superclass.

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doOptions, doPut, doTrace, getLastModified, service, service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, init, log, log

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpManagerServlet

public HttpManagerServlet()

Method Detail

init

public void init(javax.servlet.ServletConfig config)
          throws javax.servlet.ServletException

Overrides the init method in the servlet superclass.

Initializes the servlet by attempting a connection to the Registration Authority server and throws an exception if the connection cannot be established.

Specified by:

init in interface javax.servlet.Servlet

Overrides:

init in class javax.servlet.GenericServlet

Parameters:

config -

Throws:

javax.servlet.ServletException

getServletInfo

public java.lang.String getServletInfo()

Returns a short description of this servlet.

Specified by:

getServletInfo in interface javax.servlet.Servlet

Overrides:

getServletInfo in class javax.servlet.GenericServlet

doPost

public void doPost(javax.servlet.http.HttpServletRequest req,
          javax.servlet.http.HttpServletResponse res)
            throws javax.servlet.ServletException,
                   java.io.IOException

Call the doPost() method in HttpManagerServletEngine class.

Overrides:

doPost in class javax.servlet.http.HttpServlet

Parameters:

req -

res -

Throws:

javax.servlet.ServletException

java.io.IOException

See Also:

HttpManagerServletEngine.doPost(HttpServletRequest, HttpServletResponse), doGet(HttpServletRequest req, HttpServletResponse res)

doGet

public void doGet(javax.servlet.http.HttpServletRequest req,
         javax.servlet.http.HttpServletResponse res)
           throws javax.servlet.ServletException,
                  java.io.IOException

Call the doGet() method in HttpManagerServletEngine class.

Overrides:

doGet in class javax.servlet.http.HttpServlet

Parameters:

req -

res -

Throws:

javax.servlet.ServletException

java.io.IOException

See Also:

HttpManagerServletEngine.doGet(HttpServletRequest, HttpServletResponse)