Lychee Redmineのシングルサインオン設定

概要

Access Controlで、Lychee Redmineとシングルサインオンを行う手順を説明します。

注意事項

1. 本記事の内容は、作成時点で弊社が実施した検証結果に基づくものであり、サービスのアップデート等により予告なく変更される場合があります。
   弊社は、本記事の正確性、有用性の確保につき可能な限り努めておりますが、その内容の網羅性、正確性、完全性、最新性、適時性、特定目的適合性その他内容の一切について、いかなる保証も行うものではありません。
2. 本記事は、サービスを提供するベンダー様による公式の監修または認定を受けているものではありません。
3. Email DLP / Secure Browser の動作検証は行っておりません。

連携仕様

Lychee Redmineの連携仕様は以下のとおりです。

• 連携キー：メールアドレス
• Lychee Redmine側の設定：お客様にて実施
• アカウントプロビジョニング：プロビジョニングあり（HENNGE oneにて管理可能）
• アクセス方法：SP-Initiatedのみ対応
  ※IdP-Initiatedは非対応です。
• デバイス証明書対応状況：ブラウザ

手順

1. Lychee Redmine側のシングルサインオン設定を行うためには、予めHENNGE Oneの値を取得する必要があります。以下の記事をもとに、HENNGE Oneのサービスプロバイダーを設定し、HENNGE Oneの値を取得してください。
   記事：HENNGE One サービスプロバイダーの仮設定 
2. Lychee Redmineの設定を行います。Lychee Redmine管理画面上の[管理]をクリックします。次に、[SAML認証]をクリックします。 
   
3. [＋SAML認証]をクリックします。 
   
4. タイプ欄に[その他]を選択します。 
   
5. [名称]に任意の名称を入力します。
   例：HENNGE One 
   
6. [Domain]に/loginを除いたLychee RedmineのログインURLを入力します。
   例：Lychee RedmineのログインURLがhttps://hennge.test.jp/loginの場合、https://hennge.test.jpをDomainに入力します。 
   
7. [IdP SSO target URL]に本記事の手順1で取得したIdP Issuer を入力します。
   
8. [IdP metadata URL]に本記事の手順1で取得したIdPメタデータを入力します。
   
9. [Attribute mapping mail]に「Email」と入力します。 
   
10. [Attribute mapping firstname]に「FirstName」と入力します。 
    
11. [Attribute mapping lastname]に「LastNam」と入力します。 
    
12. [IdP Cert Algorithm]に[SHA256]を選択します。 
    
13. 本記事の手順1で取得したSAML署名証明書をテキストファイル等で開き、表示された値を全てコピーして[IdP Cert Fingerprint]に貼り付けます。 
    
14. [Audience]欄の[EntityIDとの一致を確認する]にチェックします。 
    
15. Just in Time Provisioningを利用する場合は、[ユーザーが存在しなければ自動作成]にチェックを入力します。
    Just in Time Provisioningとは：ユーザーがLychee RedmineにSSOでログインした際に、自動的に当該ユーザーのアカウントがLychee Redmine上に作成されます。なお、既にLychee Redmine上に当該ユーザーのアカウントが存在していた場合は自動作成されません。 
    
16. [保存]をクリックします。 
    
17. [ACS URL]に記載されたURLをコピーして控えます。 
    
18. 本記事の手順1で設定したHENNGE Oneのサービスプロバイダーの設定を更新します。以下の記事を参照してください。
    記事：SAML 接続時の HENNGE One 側方法（カスタムでの登録の場合）
    • ACS URL：本記事の手順17で控えたACS URL
    • SP Issuer：/loginを除いたLychee RedmineのログインURL
    • Name ID：email または UserPrincipalName (UPN)
    • 署名方式：アサーション
    • Name IDフォーマット：email
    • 追加属性
      • 属性：FirstName　値：名
      • 属性：LastName　値：姓
      • 属性：Email　値：Email 
19. シングルサインオンにてLychee Redmineにアクセスするためには、アクセス許可を設定する必要があります。以下の記事をもとに設定を行います。
    記事：[Access Control] アクセスポリシーグループの作成 / 編集 
20. Lychee Redmine側のSAML有効化の設定を行います。管理画面上の[管理]ー[ユーザー]をクリックします。
    
21. SSOを有効化するユーザーを選択します。 
    
22. [認証方式]に本記事の手順5で作成したSAML認証を選択します。その後、[保存]をクリックし、SSOを有効化します。 
    

23. Lychee Redmineにアクセスし、SSO連携が無事に完了していることを確認します。Lychee Redmineには、SP-Initiated方式にてアクセスが可能です。

    SP-Initiatedのみ対応のサービスはログインURLにシングルサインオン用のURLを設定することでAccess Control ユーザーポータルからもアクセスできるようになります。
    [Access Control] サービスからのアクセスのみが可能なサービスへHENNGEからアクセスする手順