シングルサインオンとは、一回の認証(ログオン)で複数のアプリケーションを利用できるようにする仕組みです。シングルサインオンの実現には、「認証サーバ」というものを用意する必要があります。認証サーバを経由することで、Windows Active Directory / LDAP といった認証方式をはじめ、多くの認証に対応することができます。
Wagby はオープンソースの認証サーバ Central Authentication Service (CAS) を同梱しています。CAS を使った認証を設定すると、
http://サーバー名:8921/wagby/
へのアクセスがいったん
http://サーバー名:8921/cas/login
へ転送されます。下図に示すCASのログオン画面を使って認証します。
ここで Windows Active Directory / LDAP に登録されているユーザーID/パスワードを使ってログイン認証を行います。認証後は Wagby アプリケーションのメニュー画面へ遷移します。
「環境 > サーバ」を設定します。
Windows Active Directory サーバで、dsquery コマンドを使うとユーザ情報の DN を調べることができます。 例えばユーザ admin の DN は次のように調べることができます。
C:\Users\jasmine>dsquery user -name admin "CN=admin,CN=Users,DC=jasminesoft,DC=co,DC=jp"
企業での利用例として、次の環境を想定します。
設定は次のようになります。
| LDAPサーバのURL | ldap://A.B.com/ |
|---|---|
| ユーザ情報のDN | %u@B.com |
| ユーザ情報の検索開始エントリ | (空欄) |
| ユーザ情報の検索範囲 | (空欄) |
| CASサーバのURL接頭辞 | http://app.B.com:8921/cas |
| 認証を適用するサービスのURL | http://app.B.com:8921 |
大学での利用例として、次の環境を想定します。
設定は次のようになります。
| LDAPサーバのURL | ldap://ldap.sample.ac.jp/ |
|---|---|
| ユーザ情報のDN | uid=%u |
| ユーザ情報の検索開始エントリ | dc=sample,dc=ac,dc=jp |
| ユーザ情報の検索範囲 | サブツリー |
| CASサーバのURL接頭辞 | http://app.sample.ac.jp:8921/cas |
| 認証を適用するサービスのURL | http://app.sample.ac.jp:8921 |
Windows Active Directory / LDAP を使用してユーザ認証を行うためには、Wagbyと Windows Active Directory / LDAP の両方に同一のアカウント/ユーザを登録する必要があります。
はじめにアカウント/ユーザ "admin"を登録します。Wagbyにはあらかじめ、アカウント "admin" が標準で登録されているため、Windows Active Directory / LDAP にユーザ "admin" を登録することで、Wagbyにログオンできるようになります。
Windows Active Directory / LDAP で他のユーザを作成した後、Wagby側に同じアカウントを作成してください。
ここでは、Windows Server 2008 Standardの Windows Active Directory にユーザ "admin"を追加する手順を示します。前提条件として、Windows Active Directoryサーバおよびドメイン"jasminesoft.co.jp"がすでに用意されているものとします。
Wagbyにアカウント (juser) を作成します。「所属グループ」「プリンシパル」も通常通り設定できます。
なお、パスワードに関しては、以下のような扱いになります。
Wagby と Windows Active Directory / LDAP で同一アカウント/ユーザが登録されている必要があります。
Wagby側でアカウント登録を行っても、Windows Active Directory / LDAP に同アカウントを登録しない場合はログオンできません。
Wagby のアカウントは所属グループやプリンシパルなどの権限設定のために使用されますが、ユーザ認証時のバスワードはWindows Active Directory / LDAP のものが使用されます。アカウント登録時にパスワードの設定は必要ですが、運用時には無視されます。従って、パスワードはダミーデータとして設定してください。
また、Wagby で設定・変更したパスワードは Windows Active Directory / LDAP には反映されません。
本設定を利用する場合、「パスワード有効日数」及び「パスワード有効日数警告」に "-1" を指定してください。(パスワード有効期限設定を無効にします。)
本設定によって、利用者が最初にログオンする場合は (Wagby が標準で提供するログオン画面に代わって) CASの画面が表示されるようになります。
ここで、Windows のアカウントとパスワードを入力すると、認証後に Wagby のメニュー画面に遷移します。
Windows Active Directory / LDAP で設定した権限情報を、Wagby で利用することはできません。
Wagby の権限情報は、Wagby 内で管理されます。Wagby 上のアカウントに対して、所属グループやプリンシパルなどの権限設定を行うようにしてください。
CASの設定ファイルは以下に用意されています。
wagbyapp/webapps/cas/WEB-INF/deployerConfigContext.xml
うまく接続できない場合、CASのマニュアルを参考にしながら、このファイルを直接、修正してください。
CASの画面をカスタマイズすることができます。
ログオン画面及びログオフ後の画面は次のファイルによって実現されています。
このファイルを書き換えることで、画面をカスタマイズすることができます。
ファイルの編集後は、下記のカスタマイズフォルダに配置することにより、次回以降のビルドは自動的に反映されるようになります。
customize/tomcat/webapps/cas/WEB-INF/view/jsp/default/ui/
Wagby が利用している CAS はシングルサインオンを実現するための製品です。そのため Wagby でログオフを行っても、CAS としては「まだログオンしている状態」です。これは CAS を使った他のシステムへの認証を残すためです。
Wagby のログオフ処理の後に http://xxx/cas/logout へ別途アクセスを行う必要があります。このため Wagby が標準で提供している logoff.jsp を修正します。
具体的には logoff.jsp の先頭に次の行を加えます。
<c:redirect url="http://xxx/cas/logout" />
修正した logoff.jsp を customize/webapp/system フォルダに保存します。(system フォルダはインストール直後の状態では用意されていませんので、フォルダも作成してください。)これにより、次回以降のビルド処理で常に修正した logoff.jsp が利用されるようになります。
セキュリティの観点から、CAS のログアウト後はいったんブラウザを終了するようにしてください。これは CAS が推奨する方式です。