README revision 94ab7a4a8fa00e44d9fe93df2c2a77c134a8e31c
48N/A<!--
48N/A DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
48N/A
48N/A Copyright (c) 2007 Sun Microsystems Inc. All Rights Reserved
493N/A
48N/A The contents of this file are subject to the terms
48N/A of the Common Development and Distribution License
48N/A (the License). You may not use this file except in
48N/A compliance with the License.
48N/A
48N/A You can obtain a copy of the License at
48N/A https://opensso.dev.java.net/public/CDDLv1.0.html or
48N/A opensso/legal/CDDLv1.0.txt
48N/A See the License for the specific language governing
48N/A permission and limitations under the License.
48N/A
48N/A When distributing Covered Code, include this CDDL
48N/A Header Notice in each file and include the License file
48N/A at opensso/legal/CDDLv1.0.txt.
48N/A If applicable, add the following below the CDDL Header,
48N/A with the fields enclosed by brackets [] replaced by
48N/A your own identifying information:
48N/A "Portions Copyrighted [year] [name of copyright owner]"
48N/A
48N/A $Id: README,v 1.2 2009/05/12 05:38:47 kevinserwin Exp $
48N/A
48N/A-->
48N/A
48N/AEmbedded OpenSSO sample
48N/A
48N/AThis directory contains the sample code for Embedded OpenSSO.
48N/AThe contents of opensso.war are included, as well as Embedded OpenSSO specific
493N/Aclasses.
48N/A
48N/AContents of this directory:
70N/A <> (root directory where opensso.zip is extracted)
493N/A |- README (this README file)
48N/A |- build.sh (script to build the Hello sample)
48N/A |- run.sh (script to execute the Hello sample)
493N/A |- login.jsp (login script for deployed version of sample)
48N/A |- config (contents from opensso.war)
48N/A |- source (sample source code directory)
48N/A |- Hello.java (sample code for Embedded OpenSSO)
48N/A |- WEB-INF (contents from opensso.war)
70N/A |- classes (contains opensso.war classes plus Hello.class)
48N/A |- classes/configparam.properties (contains configuration parameters
48N/A for embedded opensso.
48N/A NOTE: This file must be modified to
48N/A use the deployed version)
70N/A
493N/ASteps to run Embedded OpenSSO:
70N/A
493N/AStandalone
48N/A==========
70N/A
48N/A1. Extract the opensso-embedded.war file:
70N/A % mkdir <staging area>
493N/A % cd <staging area>
493N/A % jar xvf <war-file-location>/opensso-embedded.war
70N/A
70N/A2. Fix permissions on the run.sh script
70N/A % chmod 755 run.sh
70N/A
70N/A3. Execute the run.sh script:
48N/A % run.sh
48N/A
48N/A4. Modify source/Hello.java and then rebuild to test your modifications.
48N/A % build.sh
% run.sh
Deployed
==========
1. Extract the opensso-embedded.war file:
% mkdir <staging area>
% cd <staging area>
% jar xvf <war-file-location>/opensso-embedded.war
2. Modify the configuration parameters for your environment:
% vi WEB-INF/classes/configparam.properties
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:
http://myhost:8080/hello/login.jsp