Image Added Tiqr Original Site

注意
If you are using TiqrShib version 2.0, we strongly recommend you update it to 2.1 or later.

最近の更新

添付ファイル

tiqrshib20130329.tar.gzを利用したtiqrshibのインストールについて。

以下では、Shibboleth IdP（ID、パスワード認証）が動作している環境へのインストール手順として記述しています。

Shibboleth SPをインストール、設定
TiqrShibを配置（tar.gzの解凍）
関連ライブラリを配置
ライブラリのバグ修正
Apacheの設定
ShibbolethへのTiqrShibハンドラー設定
TiqrShibの初期値設定

1. Shibboleth SPをIdPサーバにインストール、設定

Tiqr登録時のID,パスワード認証用。IdPでは、フェデレーションとは別の、単独のメタデータとしてインストールしたSPのメタデータを設定。インストールしたSPには、このIdPのメタデータのみを設定。

2. TiqrShibを配置

tiqrshib20130329.tar.gzを解凍して、

解凍ディレクトリ内のtiqrzenddemoを/var/tiqrzenddemo に配置。
解凍ディレクトリ内のvar/www/html/TiqrShibを/var/www/html/TiqrShibに配置（trans.phpの配置）。
解凍ディレクトリ内のvar/www/html/tiqrenroll/index.htmlを/var/www/html/tiqrenrollに配置（index.htmlの配置）
　上記で配置したindex.html内のサーバFQDNを修正します。（下記の（IdPサーバFQDN）部分）

コードブロック
<input style="font:8pt" type=button value="登録"           onclick="window.location.href='https://（IdPサーバFQDN）/TiqrShib/trans.php'">

3. 関連ライブラリを配置

下記をダウンロードして配置

アプリケーション	バージョン	ダウンロードサイト
Tiqr-library	1.0.0	https://tiqr.org/archives/196/
Tiqr-zendframework	1.0.0	https://tiqr.org/archives/196/
ZendFramework	1.12.2-minimal or 1.12.2-full (*) 2.x.xは未検証	http://framework.zend.com/downloads/latest
phpqrcode	1.1.4 (*) 実行にphp-gdが必要です。	http://phpqrcode.sourceforge.net/

コードブロック


mkdir /var/www/library
cp -rf tiqr-server-library-1.0.0/library/tiqr /var/www/library/libTiqr
cp -rf tiqr-server-zendframework-1.0.0/library/tiqr-zf /var/www/library/tiqr-zf
cp -rf phpqrcode /var/www/library/phpqrcode
ZendFramework-1.12.1-minimalを/usr/shareに展開して、
ln -s ZendFramework-1.12.1-minimal ZendFramework

【ライブラリリンク作成】＝＞作業報告書P24
　　　下記リンクを確認。リンクされてない場合は、リンクを作成。

コードブロック


ln -s /var/www/library/libTiqr    /var/tiqrzenddemo/library/tiqr
ln -s /var/www/library/phpqrcode  /var/tiqrzenddemo/library/phpqrcode
ln -s /var/www/library/tiqr-zf    /var/tiqrzenddemo/library/tiqr-zf
ln -s /usr/share/ZendFramework    /var/tiqrzenddemo/library/zend

(*) 上記はリンクでなく、直接配置しても良い。
　直接配置する場合は、/var/tiqrzenddemo/library/の下に配置して、/var/tiqrzenddemo/public/index.phpの修正（下記）が必要。

コードブロック


// Ensure library/ is on include_path
  set_include_path(implode(PATH_SEPARATOR, array(
    realpath(APPLICATION_PATH . '/../library/zend/library'),
    realpath(APPLICATION_PATH . '/../library/tiqr'),
    realpath(APPLICATION_PATH . '/../library/tiqr-zf'),
    realpath(APPLICATION_PATH . '/../library/libTiqrShib'),
    get_include_path(),
  )));

【library設定】

/etc/php.iniに下記を追加。

コードブロック
include_path = ".:/usr/share/ZendFramework/library:/var/www/library/libTiqr"

4. ライブラリのバグ修正

【ZendFramework修正】＝＞作業報告書P23

/usr/share/ZendFramework/library/Zend/View/Helper/Placeholder/Container/Abstract.php に以下を追記

コードブロック
/** * Sort the array by key * * @return array */ public function ksort() { $items = $this->getArrayCopy(); return ksort($items); }

【Tiqr,Tiqr-zf修正】＝＞作業報告書P25-P30（P28はTiqrShibに反映済み）

/var/www/library/tiqr-zf/Tiqr/Resource/Tiqr.php 修正（25ページ）

コードブロック
# require_once "Tiqr/Server.php"; require_once "Tiqr/Service.php";

/var/www/library/tiqr-zf/Tiqr/Controller/Login/Abstract.php 修正（26ページ）

コードブロック


# case Tiqr_Server::AUTH_RESULT_AUTHENTICATED:
case Tiqr_Service::AUTH_RESULT_AUTHENTICATED:
# case Tiqr_Server::AUTH_RESULT_INVALID_CHALLENGE:
case Tiqr_Service::AUTH_RESULT_INVALID_CHALLENGE:
# case Tiqr_Server::AUTH_RESULT_INVALID_REQUEST:
case Tiqr_Service::AUTH_RESULT_INVALID_REQUEST:
# case Tiqr_Server::AUTH_RESULT_INVALID_RESPONSE:
case Tiqr_Service::AUTH_RESULT_INVALID_RESPONSE:
# case Tiqr_Server::AUTH_RESULT_INVALID_USERID:
case Tiqr_Service::AUTH_RESULT_INVALID_USERID:

/var/www/library/libTiqr/Tiqr/Random.php 追記（27ページ）

コードブロック
(public static function randomBytes($length)以下に追記) $strong = false; $rnd = "";

/var/tiqrzenddemo/application/configs/application.ini 修正および追記（28ページ:提供コードで修正済）

・修正箇所（実際の修正時には、コメント行＝ "#"の付いた行は、エラーとなるので削除してください。）

コードブロック


# resources.tiqr.identifier = "zeus.local"
resources.tiqr.identifier = "vm2.peofiamp.nii.ac.jp"
# resources.tiqr.name = "Zeus"
resources.tiqr.name = "vm2"
# resources.tiqr.auth.protocol = "surfauth"
resources.tiqr.auth.protocol = "tiqrauth"
# resources.tiqr.logoUrl  = "http://zeus.local/img/surfmedia-logo.png"
resources.tiqr.logoUrl  = "https://vm2.peofiamp.nii.ac.jp/icons/GakuNin_logo.png"
# resources.tiqr.session.secret = "enter something truly random here, preferably generated using openssl"
resources.tiqr.session.secret = "0124567abcdefgh"

・追記箇所

コードブロック


# (resources.tiqr.userstorage.path = "/tmp" 以下に追記)
resources.tiqr.ocra.suite = "OCRA-1:HOTP-SHA1-6:QH10"
resources.log.stream.writerName = "Stream"
resources.log.stream.writerParams.stream = APPLICATION_PATH "/logs/application_" DATESTAMP ".log"
resources.log.stream.writerParams.mode = "a"
resources.log.stream.filterName = "Priority"
resources.log.stream.filterParams.priority = 7

/var/tiqrzenddemo/application/modules/v1/views/scripts/login/index.phtml 修正（29ページ）

コードブロック
# $this->headScript()->prependFile($this->baseURL().'/scripts/jquery.js') $this->headScript()->prependFile($this->baseUrl().'/scripts/jquery.js')

/var/tiqrzenddemo/library/tiqr-zf/Tiqr/Controller/Enroll/Abstract.php 修正（30ページ）

コードブロック
# $this->view->enrollmentURL = $this->_getTiqr()->generateEnrollmentURL($metadataURL); $this->view->enrollmentURL = $metadataURL;

/var/tiqrzenddemo/library/tiqr-zf/Tiqr/Login/Abstract.php 修正

コードブロック
//$secret = pack('H*', $this->_getUserSecret($userId)); $secret = $this->_getUserSecret($userId);

5. Apacheの設定

<httpd.conf>
追記：

コードブロック
Alias /tiqr/ "/var/tiqrzenddemo/public/"

<ssl.conf>

追記：

コードブロック


<Location /tiqr>
       RewriteEngine On
       RewriteBase /tiqr
       RewriteCond %{REQUEST_FILENAME} -s [OR]
       RewriteCond %{REQUEST_FILENAME} -l [OR]
       RewriteCond %{REQUEST_FILENAME} -d
       RewriteRule ^.*$ - [NC,L]
       RewriteRule ^.*$ /tiqr/index.php [NC,L]
</Location>

【.htacsess設定】＝＞作業報告書P22

/var/tiqrzenddemo/public/.htaccessの以下を削除

コードブロック
RewriteEngine On RewriteCond %{REQUEST_FILENAME} -s [OR] RewriteCond %{REQUEST_FILENAME} -l [OR] RewriteCond %{REQUEST_FILENAME} -d RewriteRule ^.$ - [NC,L] RewriteRule ^.$ index.php [NC,L]

６. ShibbolethへのTiqrShibハンドラー設定

CDのtiqrshibAuthn.javaをコンパイルして、tiqrshibAuthn.classを作成。
/usr/java/tomcat/webapps/idp/WEB-INF/classes/を作成して配置。
コンパイルは、こんな感じです；

コードブロック


javac -classpath /usr/java/tomcat/lib/servlet-api.jar:/root/shibIdP230/shibboleth-identityprovider-2.3.0/lib/shibboleth-common-1.3.0.jar:/root/shibIdP230/shibboleth-identityprovider-2.3.0/lib/shibboleth-identityprovider-2.3.0.jar:/root/shibIdP230/shibboleth-identityprovider-2.3.0/lib/shibboleth-jce-1.1.0.jar:/root/shibIdP230/shibboleth-identityprovider-2.3.0/lib/slf4j-api-1.6.1.jar:/root/shibIdP230/shibboleth-identityprovider-2.3.0/lib/openws-1.4.2.jar:/root/shibIdP230/shibboleth-identityprovider-2.3.0/lib/xmltooling-1.3.2.jar tiqrshibAuthn.java

web.xmlとhandler.xmlの設定。＝＞作業報告書P38,P39
(*) handler.xmlでの設定は、UserPasswordハンドラーを残したままで、（つまり、コメントアウトしないで、）追加して下さい。

/usr/java/tomcat/webapps/idp/WEB-INF/web.xmlを修正。

コードブロック


<!-- Servlet protected by container used for TiqrShib authentication -->
    <servlet>
        <servlet-name>TiqrShibAuthHandler</servlet-name>
        <servlet-class>tiqrshibAuthn</servlet-class>
            <init-param>
                 <param-name>authnMethod</param-name>
                 <param-value>urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract</param-value>
            </init-param>
        <load-on-startup>3</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>TiqrShibAuthHandler</servlet-name>
        <url-pattern>/Authn/TiqrShib</url-pattern>
    </servlet-mapping>

idpのhandler.xmlに下記を設定。

コードブロック


<ph:LoginHandler xsi:type="ph:ExternalAuthn"
                     externalAuthnPath="/Authn/TiqrShib" >
         
    <ph:AuthenticationMethod>urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract</ph:AuthenticationMethod>
</ph:LoginHandler>

【Shib設定】

(1) IdPの設定

Username/PasswordHandlerをデフォルトにする設定。
/usr/java/tomcat/webapps/idp/WEB-INF/web.xmlに下記を追記。

コードブロック


    <!-- Servlet for doing Username/Password authentication -->
    <servlet>
        <servlet-name>UsernamePasswordAuthHandler</servlet-name>
        <servlet-class>edu.internet2.middleware.shibboleth.idp.authn.provider.UsernamePasswordLoginServlet</servlet-class>
            <init-param>
                 <param-name>authnMethod</param-name>
                 <param-value>urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport</param-value>
            </init-param>
        <load-on-startup>3</load-on-startup>
    </servlet>

relying-party.xmlに下記を設定。

コードブロック


<rp:DefaultRelyingParty provider="https://IdPサーバ/idp/shibboleth"
                         defaultSigningCredentialRef="IdPCredential"
                         defaultAuthenticationMethod="urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport">

(2) IdPサーバのSPの設定

shibboleth2.xmlへのSessionInitiator追加

コードブロック


            <!-- Special SessionInitiator for Tiqr!!! -->
            <SessionInitiator type="SAML2" Location="/TiqrShib" id="siid1" entityID="https://simptest2.nec.test/idp/shibboleth" template="bindingTemplate.html" authnContextClassRef="urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport" />

/etc/httpd/conf.d/shibd.confへの追加

コードブロック
<Location /TiqrShib> AuthType shibboleth ShibRequestSetting requireSessionWith siid1 require valid-user </Location>

(3) SPの設定（Tiqr認証を要求するIdPサーバとは別のSPの設定）

SessionInitiatorで、="urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract"を設定する。

コードブロック


            <SessionInitiator type="Chaining" Location="/DS" isDefault="true" id="tiqrshiblogin" authnContextClassRef="urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract">
               <SessionInitiator type="SAML2" template="bindingTemplate.html"/>
               <SessionInitiator type="Shib1"/>
               <SessionInitiator type="SAMLDS" URL="https://DSサーバ/ds/WAYF"/>
            </SessionInitiator>

７. TiqrShibの初期値設定

application/Bootstrap.phpに初期値読み込みを設定。（＝＞作業報告書P34）

コードブロック


<?php

class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
{
    // retrieve tiqrshib constants
    protected function _initConstants()
    {
        $options = $this->getOption('constants');

        if (is_array($options)) {
            foreach($options as $key => $value) {
                if(!defined($key)) {
                    define($key, $value);
                }
            }
        }
    }


    protected function _initLogger() {

         $this->bootstrap("log");
         $logger = $this->getResource("log");
         Zend_Registry::set("logger", $logger);
     }

}

(*) tiqrshib20130329.tar.gz内のtiqrshibコードには、ログ出力コードを入れているため、上記のLogger設定も必要。

【Tiqr初期値設定】（作業報告書P33)

/var/tiqrzenddemo/application/config/application.iniの設定を修正。

コードブロック


resources.tiqr.identifier = "vm2.peofiamp.nii.ac.jp"
↑サーバのFQDNを記入。
resources.tiqr.name = "vm2"
↑Tiqrサーバの名称（アプリ上に表示される）を記入。
resources.tiqr.logoUrl  = "https://vm2.peofiamp.nii.ac.jp/icons/gakunin-logo.png"
↑アプリに表示するロゴを指定。5KBくらいのpngファイル。100KBくらいだとアプリへのロードに時間が掛る。
constants.TIQRSHIB_DOMAIN = "nii.ac.jp"
↑IdPが送るeppnのセキュリティドメイン

↓以下のLDAP設定には、attribute-resolver.xmlと同じものを設定。
constants.TIQRSHIB_LDAP_HOST = "localhost"
constants.TIQRSHIB_LDAP_PORT = "389"
constants.TIQRSHIB_LDAP_BASEDN = "o=test_o,dc=ac,c=JP"
constants.TIQRSHIB_LDAP_BINDREQUIRESDN = "true"
constants.TIQRSHIB_LDAP_USERNAME = "cn=Manager,o=test_o,dc=ac,c=JP"
constants.TIQRSHIB_LDAP_PASSWORD = "password"

   (*) LDAPの検索では、"uid"をフィルタとして検索しています。
        uidと異なる属性名を利用している場合は、/var/tiqrzenddemo/library/libTiqrShib/tiqrShibLdap.phpの
       $result = $ldap->search('(uid='.$userId.')');
　　　の行（２か所）にて、"uid"を修正して下さい。

子ページ

比較バージョン

古いバージョン 24

新しいバージョン現在

キー

How to Use

Installing Shibbolized Tiqr

Sequence Diagram

tiqrshib20130329.tar.gzを利用したtiqrshibのインストールについて。

1. Shibboleth SPをIdPサーバにインストール、設定

2. TiqrShibを配置

3. 関連ライブラリを配置

4. ライブラリのバグ修正

【ZendFramework修正】＝＞作業報告書P23

【Tiqr,Tiqr-zf修正】＝＞作業報告書P25-P30（P28はTiqrShibに反映済み）

5. Apacheの設定

６. ShibbolethへのTiqrShibハンドラー設定

【Shib設定】

(1) IdPの設定

(2) IdPサーバのSPの設定

(3) SPの設定（Tiqr認証を要求するIdPサーバとは別のSPの設定）

７. TiqrShibの初期値設定

【Tiqr初期値設定】（作業報告書P33)

子ページ

ページ履歴

比較バージョン

古いバージョン 24

新しいバージョン 現在

キー

How to Use

Installing Shibbolized Tiqr

Sequence Diagram

tiqrshib20130329.tar.gzを利用したtiqrshibのインストールについて。

1. Shibboleth SPをIdPサーバにインストール、設定

2. TiqrShibを配置

3. 関連ライブラリを配置

4. ライブラリのバグ修正

【ZendFramework修正】＝＞作業報告書P23

【Tiqr,Tiqr-zf修正】＝＞作業報告書P25-P30（P28はTiqrShibに反映済み）

5. Apacheの設定

６. ShibbolethへのTiqrShibハンドラー設定

【Shib設定】

(1) IdPの設定

(2) IdPサーバのSPの設定

(3) SPの設定（Tiqr認証を要求するIdPサーバとは別のSPの設定）

７. TiqrShibの初期値設定

【Tiqr初期値設定】（作業報告書P33)

新しいバージョン現在