------------------------------------------------------------------------------------------
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/10/16 NyxProject
                                                                        Yoshihiro.Hamanaka
                                                                http://nyx.sourceforge.jp/
*1:Enterprise Information Portal
------------------------------------------------------------------------------------------
[ Open Source License ]
SecureSwitchはMIT Licenseで使用することが出来ます。
SecureSwitchは非営利目的で使用することを想定して開発されていますが、
営利目的の利用である場合もMIT Licenseの諸条件を満たすならば使用可能です。

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

 * jQuery 1.2.x - MIT License
 * 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.

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

●推奨環境
・CentOS5 or Windows XP/Vista
・JavaSE 6 update 2
・SecureSwitch v0.6.0
・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\に解凍したとして以後解説します）
４．起動スクリプトにインストールパスの設定を行います。
　　SecureSwitch.batをテキストエディタで開き、JAVA_HOME環境変数とNYX_HOME環境変数を編集します。
　　（ファイルはC:\secure-switch\SecureSwitch.batにあります）
５．JAVA_HOME環境変数にはJDKのインストール先ディレクトリを指定します。
　　（今回の場合c:\jdk1.6.0_04\となります）
６．NYX_HOME環境変数にはSecureSwitchの解凍先ディレクトリを指定します。
　　（今回の場合C:\secure-switch\になります）

●B.SecureSwitchのセットアップ
１．SecureSwitchを起動します。
　　SecureSwitch.batをダブルクリックしてSecureSwitch BootLoaderを起動します。
　　（今回の場合C:\secure-switch\SecureSwitch.batになります）
２．起動モードの入力を求められますので、「start」を入力しEnterキーを押下します。
３．InternetExplorerやFireFoxなどのWebブラウザでSecureSwitch Portalを開きます。
　　http://localhost:8080/portal/index.sv
４．SecureSwitchPortalの画面が開きます。
　　パスワードの入力を求められますので、以下のID/PWを入力します。
　　ID : administrator
　　PW : admin
５．[管理メニュー]->[基本情報]を開きます。
６．「SMTPサーバーホスト」と「SMTPサーバーポート」の設定を
　　SecureSwitchを設置しているサーバーからアクセス可能な
　　SMTPサーバーで設定します。
７．「Cookieドメイン」の設定をSecureSwitchを設置している、
　　サーバー名(公開名)で設定します。
８．[管理メニュー]->[カーネル情報]を開きます。
９．「Nyx-RPCサーバーURL」の設定を７で設定した
　　サーバー名を含めたURLで設定します。
10．[個人設定]->[パスワード設定]を開きAdministratorユーザーのパスワードを変更します。
11．[管理者メニュー]->[SSO設定]->[ユーザー管理]を開きます。
12．「Guest User」の設定を開きこのユーザーのパスワードを変更します。
13．SecureSwitchを再起動します。
　　SecureSwitch.batをダブルクリックしてSecureSwitch BootLoaderを起動します。
　　（今回の場合C:\secure-switch\SecureSwitch.batになります）
14．起動モードの入力を求められますので、「restart」を入力しEnterキーを押下します。
15．一度Webブラウザを終了させ、再度SecureSwitchPortalの画面を開きます。
　　http://localhost:8080/portal/index.sv
16．新しく設定したIDとパスワードでログインします。

●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接続ユーザー」の設定を
　　１の手順で作成した接続ユーザーのユーザーIDに変更します。
７．「JDBC接続URL」の設定を
　　「jdbc:postgresql://localhost:5432/sso」に変更します。
　　（DBホストがlocalhost、ポートが5432、DB名がssoの場合）
８．「DBタイプ(derby|postgresql)」の設定を「postgresql」に変更します。
９．SecureSwitchを再起動します。
