TestRail の SSO 機能を利用すると、SAML 2.0、OAuth 2.0 および OpenID Connect プロトコルを使用する任意の SSO ID プロバイダー (IDP) と TestRail を統合できます。SSO 設定を有効にしたら、プロトコルを選択できます。
このガイドでは、特に SAML 2.0 – ADFS プロトコルの設定について説明します。次の手順に従って、ADFS for SSO を設定します。
-
- ADFS Management で [Trust Relationships] > [Relying Party Trust] エリアに移動します。
- 右パネル ウィンドウで [Add Relying Party Trust ] をクリックします。
- [Start] をクリックし、[Enter data about relying party manually] を選択します。
- [Next] をクリックし、[Display Name] に入力します。
- [Configure Certificate Page] で [Next] をクリックします。
- [Enable Support for SAML 2.0 WebSSO Protocol ] を選択し、TestRail SSO 設定ページのシングル サイン オン URL を設定します。
- [Next] をクリックし、[Relying Party Trust Identifier] のメタデータおよび index.php リンクを追加します。
- 他のすべてのページで [Next] をクリックし、要件に合わせて設定を行い、[Finish] をクリックします。
- Relying Party Trust に Following Edit Claim Rules を追加します。
- ルール 1:
- 要求ルール テンプレート「LDAP 属性を要求として送信」を使用します。
- ルール名を入力し、属性ストアとして Active Directory を選択します。
- 次のように LDAP 属性を出力方向の要求にマッピングします (Active Directory Users および Computers で、ユーザーに対して表のすべての詳細が入力されていることを確認します)。
LDAP 属性 出力方向の要求タイプ User-Principal-Name UPN Given-Name Given Name Surname Surname E-Mail-Addresses E-Mail Address Display-Name Name - ルールを保存します。
- ルール 2:
- 要求ルール テンプレート ->入力方向の要求を変換するを使用します。
- 要求ルール名を入力します。
- ルール テンプレートに以下の値を設定します。
- Incoming Claim Type : UPN
- Incoming Name ID Format : Unspecified
- Outgoing Claim Type : Name ID
- Outgoing Name ID Format : Email
- [すべての要求の値のパススルー] をオンにし、ルールを保存します。
- ルール 1:
- [Primary Authentication] -> [Global Setting] の [Authentication Policy] をクリックします。Authentication Method を編集し、[Extranet] および [Intranet] の両方に Forms Authentication を追加します。
- TestRail にユーザーを追加し、SSO for ADFS を有効にします。
- [ユーザーとロール] で新規ユーザーを追加し、ADFS サーバー側と同じ電子メールアドレスを指定します。
- Single Sign-on (SSO) Authentication を有効にします。
- [Service] -> [Certificate select] で [Token-Signing Certificate] を選択します。
- 証明書を右クリックして表示し、詳細タブの [Copy to File] をクリックします。
- 証明書を任意の場所に保存し、証明書のフォーマットが Base-64 encoded X.509 (.CER) であることを確認します。
- TestRail に証明書をアップロードします。
- サーバーの FQDN 値を [IDP Issuer URL] にコピーし、/adfs/ls を付加します。
SAML Assertion Encryption の設定
-
- アプリケーションで設定された秘密鍵に対応する公開鍵証明書を取得します。
- 公開鍵は X.509 証明書ファイルに .cer フォーマットで保存する必要があります。
- Relying Party Trust の暗号化タブに証明書を追加します。
- TestRail の SSO 設定で暗号化アサーションを有効化します。
- 手順 1 で取得した秘密鍵をコピーします。