Shibboleth IdPでStoredIDを利用するための設定方法(MySQL)
StoredIDはeduPersonTargetedID(ePTID)を生成する方法の一つで、 ComputedIDと比較して、
- 使用中のePTIDを失効させ新しいIDを再生成できる
- 万が一のSHA-1のコリジョンを防げる
- インシデント発生時に、IdP側でePTIDから個人を特定するのが容易
という利点があります。
1. データベースにテーブルを作成する。
MySQL上にデータベース shibbolethを作成し、以下のテーブルを追加します。
CREATE TABLE shibpid ( localEntity VARCHAR(255) NOT NULL, peerEntity VARCHAR(255) NOT NULL, persistentId VARCHAR(50) NOT NULL, principalName VARCHAR(50) NOT NULL, localId VARCHAR(50) NOT NULL, peerProvidedId VARCHAR(50) NULL, creationDate TIMESTAMP NOT NULL, deactivationDate TIMESTAMP NULL, PRIMARY KEY (localEntity, peerEntity, persistentId)) ENGINE=InnoDB DEFAULT CHARSET=utf8;※端末のサイズによっては表記がずれる可能性がございます。画面を広くしてご覧ください。
2. JDBCのドライバー（mysql-connector-java-5.1.xx-bin.jar)を取得する。
https://dev.mysql.com/downloads/connector/j/
よりmysql-connector-java-5.1.xx.zipをダウンロードしてください。
その際、PGP署名を確認するようにしてください。"Signature"リンクの先にある
-----BEGIN PGP SIGNATURE----- ... -----END PGP SIGNATURE-----
の部分をヘッダフッタも含めてコピーし、mysql-connector-java-5.1.xx.zip.ascというファイルにペーストした上で
https://dev.mysql.com/doc/refman/5.1/ja/checking-gpg-signature.html
にある手順に従って署名検証してください。
ダウンロードしたZIPを展開すると中にmysql-connector-java-5.1.xx-bin.jarというファイルがあります。
3. JDBCドライバーをインストールする。
2.で取得したJARファイルを
/usr/java/tomcat/webapps/idp/WEB-INF/lib
に配置してください。
# cp mysql-connector-java-5.1.xx/mysql-connector-java-5.1.xx-bin.jar /usr/java/tomcat/webapps/idp/WEB-INF/lib/
本来は、/opt/shibboleth-idp /edit-webapp/WEB-INF/lib/に配置した上でインストールスクリプトを実行してidp.warを再生成するものですが、 ひとまず上記ディレクトリに置き、次回セキュリティアップデート時にでも下記方法でidp.warを生成、配置すればOKです。
# cp mysql-connector-java-5.1.xx/mysql-connector-java-5.1.xx-bin.jar /opt/shibboleth-idp/edit-webapp/WEB-INF/lib
# /opt/shibboleth-idp/bin/build.sh
Installation Directory: [/opt/shibboleth-idp][Enter] ←入力なし
Rebuilding /opt/shibboleth-idp/war/idp.war ...
...done
BUILD SUCCESSFUL
Total time: 3 seconds
※端末のサイズによっては表記がずれる可能性がございます。画面を広くしてご覧ください。
4. /opt/shibboleth-idp/conf/global.xml を修正する。
/opt/shibboleth-idp/conf/global.xmlでbean MyDataSourceを定義します。
<!-- Use this file to define any custom beans needed globally. -->
<bean id="MyDataSource"
class="org.apache.tomcat.dbcp.dbcp.BasicDataSource"
p:driverClassName="com.mysql.jdbc.Driver"
p:url="jdbc:mysql://localhost:3306/データベース名"
p:username="データベースユーザー名"
p:password="データベースパスワード"
p:maxActive="10"
p:maxIdle="5"
p:maxWait="15000"
p:testOnBorrow="true"
p:validationQuery="select 1"
p:validationQueryTimeout="5" />
<!--
Algorithm whitelists and blacklists that override or merge with library defaults. Normally you can leave
these empty or commented and use the system defaults, but you can override those defaults using these lists.
Each <value> element is an algorithm URI, or you can use <util:constant> elements in place of literal values.
-->
5. /opt/shibboleth-idp/conf/saml-nameid.xmlを修正する。
<ref bean="shibboleth.SAML2PersistentGenerator" /> をアンコメントして有効にします。
<!-- Uncommenting this bean requires configuration in saml-nameid.properties. -->
<!-- -->
<ref bean="shibboleth.SAML2PersistentGenerator" />
<!-- -->
6. /opt/shibboleth-idp/conf/saml-nameid.properties を修正する。
idp.persistentId.sourceAttribute, idp.persistentId.salt, idp.persistentId.generatorとidp.persistentId.storeを設定します。
idp.persistentId.saltには他人が推測できないランダムな値を指定してください。古いIdPから設定を引き継ぐ場合は同じ値を指定してください。
# For computed IDs, set a source attribute and a secret salt:
idp.persistentId.sourceAttribute = uid←アンコメントして修正
#idp.persistentId.useUnfilteredAttributes = true
# Do *NOT* share the salt with other people, it's like divulging your private key.
#idp.persistentId.algorithm = SHA
idp.persistentId.salt = XXXXXXXXXXXXXXXX←アンコメントして修正
# To use a database, use shibboleth.StoredPersistentIdGenerator
idp.persistentId.generator = shibboleth.StoredPersistentIdGenerator← アンコメントして修正
# For basic use, set this to a JDBC DataSource bean name:
idp.persistentId.dataSource = MyDataSource←アンコメントして修正
# For advanced use, set to a bean inherited from shibboleth.JDBCPersistentIdStore
#idp.persistentId.store = MyPersistentIdStore
7. /opt/shibboleth-idp/conf/attribute-resolver.xml を修正する。
idp.persistentId.sourceAttributeで指定した属性がLDAPで定義されているのみでconf/attribute-resolver.xmlの対応するresolver:AttributeDefinitionがコメントアウトされている場合、
当該resolver:AttributeDefinitionをアンコメントします。（以下はsourceAttributeとしてuidを指定した場合の例）
<!-- Attribute Definition for uid -->
<!-- -->
<resolver:AttributeDefinition xsi:type="ad:Simple" id="uid" sourceAttributeID="uid">
<resolver:Dependency ref="myLDAP" />
<resolver:AttributeEncoder xsi:type="enc:SAML1String" name="urn:mace:dir:attribute-def:uid" encodeType="false" />
<resolver:AttributeEncoder xsi:type="enc:SAML2String" name="urn:oid:0.9.2342.19200300.100.1.1" friendlyName="uid" encodeType="false" />
</resolver:AttributeDefinition>
<!-- -->
8. Tomcatを再起動する。
すべての作業が終わりましたらTomcatを再起動してください。
参考: GakuNinShare:Shibboleth IdP 3 のstoredIdの項