貴学にてSPをインストールする場合の構築手順
1. Shibboleth SP (version 2.4以降) の動作要件
以下は本技術ガイドで構築する前提となる環境です。
Apache HTTP Server 2.2以上と mod_ssl
Apache 2.4を使う場合はShibboleth SP 2.5.2以降をお使いください。
他の環境および最新の情報はShibbolethのサイトでご確認ください:
全体, Linux, Mac OS X, Solaris, Windows, Java Servlets
2. OSをインストールする
1. OSでの設定
OS(CentOS 6)インストール
インストーラを起動してOSのインストールを行ってください。途中表示されるパッケージ選択画面では「Webサーバー」を選択してください。
その他に必要なパッケージがある場合は、適宜インストールしてください。
※このテキストはSELinuxは無効化されているものとして書かれております。下記コマンドでSELinux設定を確認してください。$ /usr/sbin/getenforce
- ネットワーク設定
環境に合わせ、ホスト名・ネットワーク・セキュリティを設定してください。
SPでは shibd サービスが通信を行います。
2. DNSへ登録
新しいホスト名とIPアドレスをDNSに登録してください。
3. 時刻同期の設定
ntpサービスを用い、貴学環境のntpサーバと時刻同期をしてください。
※Shibbolethでは、通信するサーバ間の時刻のずれが約5分を越えるとエラーになります。
3. Shibbolethのインストール
SPバージョン2.3からはrepositoryが用意され、yumに対応したのでインストールが大変楽になりました。
ここで説明するのは、以下のOSについてのインストール方法となります。
- CentOS 5/6/7, Red Hat Enterprise Linux 5/6/7 (i386)
- SUSE Linux Enterprise Server 10/11(無印/SP1/SP2/SP3) (i386)
- OpenSUSE Linux 12.1/12.2/12.3 (i386)
その他のOSについては、以下を参照してください。
※上記OSでx86_64の場合
⇒下記の"yum install shibboleth"を"yum install shibboleth.x86_64"と読み替えてください。
※Linuxの他のディストリビューションの場合
⇒こちら
※他のOSの場合
⇒こちら
1. repositoryファイル追加(★)
Shibboleth用のrepositoryファイルをダウンロードします。
(下記コマンドは、CentOS 6 の場合です。他のディストリビューションの場合はURLの "CentOS_CentOS-6" の部分を適宜読み替えてください。ただし、RHEL 7 の場合は "CentOS_7" をご利用ください。)
実習セミナー
研究クラウド環境の場合はこのままでOKです。シンクライアント環境の場合はCentOS 5なので、以下のコマンドラインの "CentOS_CentOS-6" を"CentOS_5" としてダウンロードを行なってください。
# wget http://download.opensuse.org/repositories/security://shibboleth/CentOS_CentOS-6/security:shibboleth.repo
yumにrepositoryファイルを追加します。
(コロンはちょっと気持ち悪いので、ファイル名も変更しています。)
# cp security\:shibboleth.repo /etc/yum.repos.d/shibboleth.repo
2. インストール(★)
yum コマンドの実行前に、まず※PGP鍵のインポートを参照してください。
yumコマンドを使用する為、依存性のあるunixODBCなども同時にインストールされます。
# yum install shibboleth
なお、OSインストール直後の状態でyum install shibbolethでインストールされるパッケージは以下の通りです。
(2013年10月22日現在, CentOS 6にて)
libcurl-openssl (*) libmemcached (*) libsaml8 libtool-ltdl (*) libxerces-c-3_1 libxml-security-c17 libxmltooling6 liblog4shib1 opensaml-schemas unixODBC xmltooling-schemas shibboleth 2.5.2-1.1
(2012年11月14日注:CentOS 5の場合は libcurl-openssl, libmemcached, libtool-ltdl はインストールされません)
(2011年6月21日注:ここでliblog4shib1でなく古いlog4shibがインストールされた場合はyum update liblog4shib1
を実行してアップデートしてください)
3. httpd 設定(★)
実習セミナー
ここで設定するホスト名は、各自SPサーバのホスト名を設定してください。
例)1番を割り振られた場合 ex-sp-test01.gakunin.nii.ac.jp
/etc/httpd/conf.d/ssl.confにて、ServerNameを設定します。
ServerName example-sp.nii.ac.jp:443 ← ホスト名を設定
加えて、SSL 3.0プロトコルに対する攻撃が発見されておりますので、当該プロトコルを無効化することをお勧めします。⇒SSLバージョン3の脆弱性について (CVE-2014-3566)
SSLProtocol all -SSLv2 -SSLv3
4. shibd 起動(★)
以下のコマンドでshibdを起動します。
# service shibd start
CentOS 7の場合コマンドが異なります。また、自動起動の設定も行う必要があります。
# systemctl start shibd
# systemctl enable shibd
4. サービスの起動・停止方法
httpd の起動方法
# service httpd start
CentOS 7の場合:
# systemctl start httpd
shibd の起動方法
# service shibd start
CentOS 7の場合:
# systemctl start shibd
httpd の停止方法
# service httpd stop
CentOS 7の場合:
# systemctl stop httpd
shibd の停止方法
# service shibd stop
CentOS 7の場合:
# systemctl stop shibd
httpd の再起動方法(停止→起動)
# service httpd restart
CentOS 7の場合:
# systemctl restart httpd
shibd の再起動方法(停止→起動)
# service shibd restart
CentOS 7の場合:
# systemctl restart shibd
※shibdと同様、httpdもSPの設定ファイル(shibboleth2.xml等)を読み込みますので、設定ファイルを変更した際はhttpdの再起動もしくは再読み込み(reload)もあわせて行うようにしてください。httpdに含まれるShibbolethモジュール(mod_shib)が当該ファイルを読み込みます。
インストールが完了したら,サイト情報等の設定を行って下さい.