README revision 94ab7a4a8fa00e44d9fe93df2c2a77c134a8e31c
<!--
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
Copyright (c) 2007 Sun Microsystems Inc. All Rights Reserved
The contents of this file are subject to the terms
of the Common Development and Distribution License
(the License). You may not use this file except in
compliance with the License.
You can obtain a copy of the License at
See the License for the specific language governing
permission and limitations under the License.
When distributing Covered Code, include this CDDL
Header Notice in each file and include the License file
at opensso/legal/CDDLv1.0.txt.
If applicable, add the following below the CDDL Header,
with the fields enclosed by brackets [] replaced by
your own identifying information:
"Portions Copyrighted [year] [name of copyright owner]"
-->
Embedded OpenSSO sample
This directory contains the sample code for Embedded OpenSSO.
The contents of opensso.war are included, as well as Embedded OpenSSO specific
classes.
Contents of this directory:
<> (root directory where opensso.zip is extracted)
|- README (this README file)
|- build.sh (script to build the Hello sample)
|- run.sh (script to execute the Hello sample)
|- login.jsp (login script for deployed version of sample)
|- config (contents from opensso.war)
|- source (sample source code directory)
|- Hello.java (sample code for Embedded OpenSSO)
|- WEB-INF (contents from opensso.war)
|- classes (contains opensso.war classes plus Hello.class)
|- classes/configparam.properties (contains configuration parameters
for embedded opensso.
NOTE: This file must be modified to
use the deployed version)
Steps to run Embedded OpenSSO:
Standalone
==========
1. Extract the opensso-embedded.war file:
% mkdir <staging area>
% cd <staging area>
2. Fix permissions on the run.sh script
% chmod 755 run.sh
3. Execute the run.sh script:
% run.sh
4. Modify source/Hello.java and then rebuild to test your modifications.
% build.sh
% run.sh
Deployed
==========
1. Extract the opensso-embedded.war file:
% mkdir <staging area>
% cd <staging area>
2. Modify the configuration parameters for your environment:
SERVER_URL=http://<your host>:<deployed port>
locale=en_US
PLATFORM_LOCALE=en_US
AM_ENC_KEY=abcdefghijklm
ADMIN_PWD=11111111
ADMIN_CONFIRM_PWD=11111111
AMLDAPUSERPASSWD=00000000
AMLDAPUSERPASSWD_CONFIRM=00000000
COOKIE_DOMAIN=
DATA_STORE=embedded
DIRECTORY_SSL=SIMPLE
DIRECTORY_SERVER=localhost
DIRECTORY_PORT=50389
ROOT_SUFFIX=dc=openam,dc=java,dc=net
SESSION_ROOT_DN=dc=internal,dc=openam,dc=java,dc=net
SESSION_STORE_TYPE=None
DS_DIRMGRDN=cn=Directory Manager
DS_DIRMGRPASSWD=11111111
3. Jar the modified contents:
% jar cvf hello.war *
4. Deploy the war file on your favorite container
5. Goto the Embedded OpenSSO URL in your browser: