ページ履歴

1. はじめに

Shibboleth IdPでの認証において、Google Authenticatorなど、TOTPに対応したデバイス/アプリのワンタイムパスワードを追加で必要とするように変更します。

...

...

以下の手順で作業を進めてください。

添付の totpauth-impl-0.5.11oncepatch-bin.zip をマシンにダウンロード、展開。 をマシンにダウンロード、展開。（参考まで、添付のパッケージとオリジナルの差分はこちら）

conf/, edit-webapp/, flows/, views/ の内容をディレクトリ構造を保持したまま/opt/shibboleth-idp/以下に配置。

idpconf/authn/authn.propertiesのidp.authn.flowsに "| Totp "を追加。を指定。

-idp.authn.flows = Password
+idp.authn.flows = Password|Totp

conf/authn/general-authn.xmlの <util:list id="shibboleth.AvailableAuthenticationFlows"> の子要素として以下を挿入します。TOTPの優先順位を高くするためには先頭に挿入してください。global.xmlの末尾（</beans>の上）に以下を挿入します。

        <bean id="authn/Totp" parent="shibboleth.AuthenticationFlow"
                p:passiveAuthenticationSupported="true"
                p:forcedAuthenticationSupported="true">
            <property name="supportedPrincipals">
                <util:list>
                    <bean parent="shibboleth.SAML2AuthnContextClassRef"
                        c:classRef="urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncToken" />
<!--
                </util:list>
    <bean parent="shibboleth.SAML2AuthnContextClassRef"
       </property>
        </bean>

conf/authn/password-authn-config.xmlにパスワードを持ち回る必要があるため以下の行を追加します。

@@ -23,6 +23,8 @@
     <bean idc:classRef="shibboleth.authn.Password.PasswordFieldName" class="java.lang.String" c:_0="j_password"urn:mace:gakunin.jp:idprivacy:ac:classes:Level2" />
                    <bean idparent="shibboleth.authn.Password.SSOBypassFieldNameSAML2AuthnContextClassRef" class="java.lang.String" c:_0="donotcache" />
 
+    <util:constant id="shibboleth.authn.Password.RemoveAfterValidation" static-field="java.lang.Boolean.FALSE"/>
+
     <!-- Simple transforms to apply to username before validation. -->
     <util:constant id="shibboleth.authn.Password.Lowercase" static-field="java.lang.Boolean.FALSE"/>
     <util:constant id="shibboleth.authn.Password.Uppercase" static-field="java.lang.Boolean.FALSE"/>

...

                        c:classRef="urn:mace:gakunin.jp:idprivacy:ac:classes:Level1" />
-->
                </util:list>
            </property>
        </bean>

※ 他の活用編メニューにてLevel1/Level2の認証強度の設定を実施済みの場合は、コメントアウトを解除してTOTPをLevel2相当としてください。

conf/authn/authn.propertiesにパスワードを持ち回る必要があるため以下の行を修正します。

@@ -42,7 +42,7 @@
 # Override this and removeAfterValidation to require all validators to succeed
 #idp.authn.Password.requireAll = false
 # Override to keep the password around
-#idp.authn.Password.removeAfterValidation = true
+idp.authn.Password.removeAfterValidation = false
 # Override to store password in Java Subject
 #idp.authn.Password.retainAsPrivateCredential = false
 # Simple username transforms before validation

/opt/shibboleth-idp/bin/build.shを実行し、WARファイル再作成およびデプロイします。
最後にJettyの再起動を行います。

...

...

3. 手順書

以下は、利用するTOTPプラグインの開発元のURLです。詳細にご興味がある方はご参照ください。以下は、利用するTOTPプラグインの開発元のURLです。手順の詳細にご興味がある方はご参照ください。
Shibboleth IdPバージョン3.2対応のものであるため、3.3以降に対応するためには上記の追加手順が必要となります。2対応のものであるため、4以降で実行するためには上記のパッケージおよび手順が必要となります。

参考: https://github.com/korteke/Shibboleth-IdP3-TOTP-Auth

...

1. 接続確認用SPから各自が使用するIdPを選択します。（どのSPからの認証要求でもTOTP認証フローが実行されます）
2. 第一画面は通常と変わりませんので、通常のUsername/Passwordを入力して次に進みます。
3. "Token code"というワンタイムパスワードを入力する画面になりますが、まだ登録していませんので、画面に指示のある通り任意の6桁の数字を入力し「Login」ボタンを押してください。
4. 同じ画面の下にというワンタイムパスワードを入力する画面になりますが、まだ登録していませんので下の"Register a new Token"ボタンをクリックします。ボタンが現れますのでクリックします。そうすると登録のためのQRコードが表示されます。
5. TOTP対応アプリ（例: Google Authenticator）を起動します。
6. 「設定を開始」をタップします。
   
7. 「バーコードをスキャン」をタップします。
   
8. 登録画面に表示されているQRコードを読み取ります。
   
9. 登録後に数字6桁のワンタイムパスワードが表示されますので、IdPのQRコードの下にある"Token code"欄に入力し"Register"ボタンをクリックします。
   

...

1. 上記登録直後はワンタイムパスワード入力画面になりますが、入力せずに、再度接続確認用SPから各自が使用するIdPを選択します。
2. 第一画面は通常と変わりませんので、通常のUsername/Passwordを入力して次に進みます。
3. "Token code"というワンタイムパスワードを入力する画面になりますので、TOTP対応アプリ/デバイスに表示されている数字6桁のワンタイムパスワードを入力して次に進みます。
   
4. 通常通り送信属性同意画面および属性受信の確認ページが表示されます。

5. ページ下部の「セッション情報」をクリックして、以下のように認証手段がパスワード認証時と異なることを確認してください。

   パネル
   Authentication Context Class: urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncToken

   （もしくは他の活用編メニューを実施していればLevel1ないしLevel2）