To install a quickplace realm you will need to edit a few files on your tomcat server.

 

1. Add the qprealm.jar and ncso.jar file to the server\lib directory

(e.g.  c:\\tomcat\5.5\server\lib\) You can obtain the qprealm.jar from this site and ncso.jar from your domino release. Ensure you use 7.0 as there is a diiop but in earlier versions related to class visibility.

2. Edit your projects web.xml to specify which pages are anonymous and which are secured. Once good way is to make all secure and make certain available for anonymous.

      <security-constraint>

            <web-resource-collection>

                  <web-resource-name>public-resources</web-resource-name>

                  <description>Public resources</description>

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

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

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

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

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

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

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

                  <url-pattern>/index.jsp</url-pattern>

                  <http-method>GET</http-method>

                  <http-method>POST</http-method>

            </web-resource-collection>

            <user-data-constraint>

                  <transport-guarantee>NONE</transport-guarantee>

            </user-data-constraint>

      </security-constraint>

 

      <!-- All other resources are for administrative users only -->

      <security-constraint>

            <web-resource-collection>

                  <web-resource-name>secure-resources</web-resource-name>

                  <description>Secured pages of the admin site</description>

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

                  <http-method>GET</http-method>

                  <http-method>POST</http-method>

            </web-resource-collection>

            <auth-constraint>

                  <role-name>manager</role-name>

            </auth-constraint>

            <user-data-constraint>

                  <transport-guarantee>NONE</transport-guarantee>

            </user-data-constraint>

      </security-constraint>

 

  <login-config>

    <auth-method>FORM</auth-method>

    <realm-name>realmname</realm-name>

    <form-login-config>

        <form-login-page>/login.jsp</form-login-page>

        <form-error-page>/login-fail.jsp</form-error-page>

    </form-login-config>

  </login-config>

 

      <security-role>

          <description>Manager Role</description>

            <role-name>manager</role-name>

   </security-role>

2. Edit your projects context.xml (or your context in the server.xml) to include the realm configuration with your server’s details.

      <Realm className="com.projectlounge.realm.QuickPlaceRealm" debug="99"

      userName="username" password="password" serverName="hostname.domain.com" />

      <Valve            className="org.apache.catalina.authenticator.FormAuthenticator"

            disableProxyCaching="false" />

3. Add a login.jsp form that has a form which has the same affect as:

<form name="loginForm" method="POST" action="<c:url value="/j_security_check" /> ">

<fieldset>

<legend>Login Details</legend>

<div>

<label>Username:</label>

<input type="text" name="username">

</div>

<div>

<label>QuickPlace name:</label>

<input type="text" name="placename">

</div>

<div>

<label>Password:</label>

<input type="password"name="j_password">

</div>

<input type="hidden" name="j_username" />

<input onClick="document.all.j_username.value = document.all.username.value + '@' +

document.all.placename.value;this.form.submit();" type="submit" value="login" />

</fieldset>

</form>

(notice how the username and placename is concatenated into username@placename – this allows us to know which quickplace to lookup)

 

4. Add the login-fail.jsp as you like (if you want to allow people to retry, make sure it also includes this form from 3)

 

 

 

 

 

 

Code initally provided and sponsored by: ProjectLounge.com Inc, visit their Online Collaboration solution here.