<< Return to Headlines

Lotus Domino and Apache Tomcat - Single Sign On (SSO) - Quick Start Guide
Last updated on 2007-12-10




To view the complete article, and to download the required .jar file, click here.


QUICK START


domino.acme.com = your Lotus Domino server (6.5.3 or later)
tomcat.acme.com = your Apache Tomcat server

Suppose you have an application on your Tomcat server named "myapp".
How would you add domino-sso to the application? Read on...


STEP #1 - JAR FILES


Copy NCSO.jar and dominosso.jar to the "myapp" location for .jar files. For example, D:\Tomcat5\webapps\myapp\WEB-INF\lib




TIPS

STEP #2 - APACHE TOMCAT CONFIGURATION


Find web.xml in the myapp application. For example, D:\Tomcat5\webapps\myapp\WEB-INF\web.xml
Add this "filter". Replace "domino.acme.com" with your Domino server's host name.

    <filter>

        <filter-name>DominoLoginFilter</filter-name>

        <filter-class>com.automatedlogic.domino.sso.DominoLoginFilter</filter-class>

        <init-param>

            <param-name>DominoDIIOPConnection</param-name>

            <param-value>domino.acme.com:63148</param-value>

        </init-param>

        <init-param>

            <param-name>DominoTomcatLoginContext</param-name>

            <param-value></param-value>

        </init-param>

        <init-param>

            <param-name>DominoTomcatLoginContextParam</param-name>

            <param-value>RedirectTo</param-value>

        </init-param>

        <init-param>

            <param-name>DominoSecurityGroupName</param-name>

            <param-value></param-value>

        </init-param>

        <init-param>

            <param-name>DominoPersonDetail</param-name>

            <param-value>1</param-value>

        </init-param>

        <init-param>

            <param-name>DominoTomcatLoginDebug</param-name>

            <param-value>0</param-value>

        </init-param>

    </filter>

    <filter-mapping>

        <filter-name>DominoLoginFilter</filter-name>

	    <url-pattern>/*</url-pattern>

    </filter-mapping>


TIPS

STEP #3 - DEMO


Add this example JSP to your application. For example, D:\Tomcat5\webapps\myapp\userinfo.jsp

userinfo.jsp

Restart your Apache Tomcat server. Open your web browser to the page "userinfo.jsp". For example, tomcat.acme.com/myapp/userinfo.jsp



DominoLoginFilter will redirect you to a Lotus Domino login page. When you are authenticated, the Lotus Domino web server will redirect you back to the Tomcat web server. DominoLoginFilter will find your LtpaToken cookie, and allow you to view the web page.

For more information, please read the full article.


<< Return to Headlines


Technorati tags:




What do you think of this document? (comments do not appear on web)
It rocks! (5) Comments?
Good stuff (4)
So-so, not bad (3)
Needs work (2)
Lame! (1)


Enter Code shown below:






Copyright (C) 2008 Automated Logic Corporation
1150 Roberts Blvd., Kennesaw, Georgia 30144 USA

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.