------------------------------------------------------------------------------------------
SecureSwitch - SSO Solution Software
  with SecureSwitch Portal - EIP*1 Solution Software
  with Nyx Custom Tag Library - JSP Custom Tag Library
  Powered by Nyx Kernel - Library for Authentication Authorization System
                                                                     2008/04/23 NyxProject
                                                                        Yoshihiro.Hamanaka
*1:Enterprise Information Portal
------------------------------------------------------------------------------------------
[ Open Source License ]
SecureSwitchはLGPL3.0ライセンスで使用することが出来ます。
SecureSwitchは非営利目的で使用することを想定して開発されていますが、
営利目的の利用である場合もLGPLライセンスの諸条件を満たすならば使用可能です。

------------------------------------------------------------------------------------------
[ Linked Library ]
SecureSwitchはオープンソースライセンスとして公開されているライブラリを使用しています。
SecureSwitchはこれらのライブラリを同梱した状態で配布していますが、
その使用に関しては各ライブラリのライセンスに許諾されます。
以下にSecureSwitchが使用している主なオーブンソースソフトウエアを示します。

 * ExtJS 2.0 - LGPL3.0
 * Spring Framework - Apache Software License, Version 2.0.
 * Bouncy Castle Crypto APIs - Apache Software License, Version 1.1.
 * Apache Derby - Apache Software License, Version 2.0.
 * Apache Commons FileUpload - Apache Software License, Version 2.0.
 * Apache Commons Logging - Apache Software License, Version 2.0.
 * Apache Log4j Component - Apache Software License, Version 2.0.
 * Apache XML-RPC 3.1 - Apache Software License, Version 2.0.
 * JSP Standard Tag Library 1.1 - Apache Software License, Version 2.0.
 * J2EE JavaMail API - Sun Public License
 * OpenID 2.0 Java Library - Apache Software License, Version 2.0.

なお上記ソフトウエアの中でExtJSについては、次期バージョンよりGPL3.0ライセンスを採用するとの発表があり、
SecureSwitchとしては商用利用可能な配布を実現すべく、オープンソースライセンスのJavaScriptライブラリを探しています。

------------------------------------------------------------------------------------------
[ Install ]
●動作環境
・CentOS5 or Windows XP/Vista
・JavaSE 6 update 2　以降
・SecureSwitch v0.5.6 以降

●推奨環境
・CentOS5 or Windows XP/Vista
・JavaSE 6 update 2
・SecureSwitch v0.5.5
・PostgreSQL 8.3

●A.SecureSwitchのインストール
１．Sun　MicrosystemsのJavaSEダウンロードサイトからJDK6をダウンロードしインストールします。
　　http://java.sun.com/javase/ja/6/download.html
　　（c:\jdk1.6.0_04\にインストールしたとして以後解説します）
２．NyxProjectのサイトからSecureSwitchをダウンロードします。
　　https://sourceforge.jp/projects/nyx
３．ダウンロードしたSecureSwitchのアーカイブを、
　　空白文字や２バイト文字を含まない場所に解凍します。
　　（C:\secure-switch\に解凍したとして以後解説します）
４．起動スクリプトにインストールパスの設定を行います。
　　env.batをテキストエディタで開き、JAVA_HOME環境変数とNYX_HOME環境変数を編集します。
　　（ファイルはC:\secure-switch\env.batにあります）
５．JAVA_HOME環境変数にはJDKのインストール先ディレクトリを指定します。
　　（今回の場合c:\jdk1.6.0_04\となります）
６．NYX_HOME環境変数にはSecureSwitchの解凍先ディレクトリを指定します。
　　（今回の場合C:\secure-switch\になります）

●B.SecureSwitchのセットアップ
１．SecureSwitchを起動します。
　　sw_start.batをダブルクリックしてSecureSwitchを起動します。
　　（今回の場合C:\secure-switch\sw_start.batになります）
２．InternetExplorerやFireFoxなどのWebブラウザで、
　　SecureSwitch Portalを開きます。
　　http://localhost:8080/portal/index.sv
　　（このときsw_start.batを起動した時のコンソールにエラーが表示されますが、
　　　SSOデータベースを初期化するまでは正常な動作です）
３．SecureSwitchPortalの画面が開きます。
４．[管理メニュー]->[SSO設定]->[SSO-JDBC設定]を開きます。
５．「SSO-DBの初期化」ボタンを押しSSOデータベースを初期化します。
　　（初期の接続設定のまま実行すると、SecureSwitch内部のSSO-DBを初期化します）
　　IDとパスワードの入力が求められた場合以下のID/PWを入力します。
　　ID : administrator
　　PW : admin
６．SecureSwitchを再起動します。
　　sw_stop.batをダブルクリックしてSecureSwitchを停止します。
　　（今回の場合C:\secure-switch\sw_stop.batになります）
　　sw_start.batをダブルクリックしてSecureSwitchを起動します。
７．一度Webブラウザを終了させ、再度SecureSwitchPortalの画面を開きます。
　　http://localhost:8080/portal/index.sv
８．IDとパスワードの入力を求められますので、以下のID/PWを入力します。
　　ID : Administrator
　　PW : admin
９．[個人設定]->[パスワード設定]を開きAdministratorユーザーのパスワードを変更します。
10．[管理者メニュー]->[SSO設定]->[ユーザー管理]を開きます。
11．「Guest User」の「編集」ボタンを押し、このユーザーのパスワードを変更します。

●C.SecureSwitchをPostgreSQLで使用する場合
１．PostgreSQL上にSSO-DB用の接続ユーザーとデータベースを作成します。
　　（PostgreSQLのインストール・セットアップについては省略します）
　　・接続ユーザーは以下のSQL文で作成できます。(ID:sso / PW:ssoの場合)
  CREATE ROLE sso LOGIN
  ENCRYPTED PASSWORD 'md5570246a7da8c8c304c17ea2bd6f462d6'
  NOSUPERUSER NOINHERIT CREATEDB NOCREATEROLE;
  ・データベースは以下のSQL文で作成できます。（DB名がsso、接続ユーザーIDがssoの場合）
  CREATE DATABASE sso WITH OWNER = sso ENCODING = 'UTF8';
２．SecureSwitch Portalを開きます。
　　http://localhost:8080/portal/index.sv
３．[管理メニュー]->[SSO設定]->[SSO-JDBC設定]を開きます。
４．「JDBCドライバ」の「編集」ボタンを押し、「org.postgresql.Driver」に変更します。
５．「JDBC接続パスワード」の「編集」ボタンを押し、
　　１の手順で作成した接続ユーザーのパスワードに変更します。
６．「JDBC接続URL」の「編集」ボタンを押し、
　　「jdbc:postgresql://localhost:5432/sso」に変更します。
　　（DBホストがlocalhost、ポートが5432、DB名がssoの場合）
７．「JDBC接続ユーザー」の「編集」ボタンを押し、
　　１の手順で作成した接続ユーザーのユーザーIDに変更します。
８．SecureSwitchを再起動します。
９．SecureSwitch Portalを開きます。
　　http://localhost:8080/portal/index.sv
　　（このときsw_start.batを起動した時のコンソールにエラーが表示されますが、
　　　SSOデータベースを初期化するまでは正常な動作です）
10．[管理メニュー]->[SSO設定]->[SSO-JDBC設定]を開きます。
11．「SSO-DBの初期化」ボタンを押しSSOデータベースを初期化します。

