Google SSO 設定

TestRail の SSO 機能を利用すると、SAML 2.0、OAuth 2.0 および OpenID Connect プロトコルを使用する任意の SSO ID プロバイダー (IDP) と TestRail を統合できます。SSO 設定を有効にしたら、プロトコルを選択できます。

このガイドでは、特に Google プロトコルの設定について説明します。まず、Google の Web アプリケーション登録手順に従います。

1. Google Dashboard に移動します: https://console.cloud.google.com/apis/dashboard
2. Registration: Google API Console でプロジェクトを作成します。
  1. [CREATE PROJECT] をクリックします。
  2. [Project Name]、[Organization]、[Location] に入力し、[Create] をクリックします。
3. Dashboard: ナビゲーションバーからプロジェクトを選択します (下の図で a としてマークされています)。
4. OAuth Consent screen: 左側のパネルで OAuth Consent Screen を選択して設定します (上の図で c としてマークされています)。
  1. [App Information]、[App Domain]、[Developer Contact Information] を指定します。[Save] をクリックして続行します。
  2. Scopes – OpenID、email、profile としてスコープを追加します。[Save] をクリックして続行します。
  3. [ Optional Information] を指定します。
  4. 詳細を確認し、求められたら確定します。
5. Credentials: 左側のナビゲーションパネルの [Credentials] をクリックします (上の図で b としてマークされています)。
  1. [Create Credentials] をクリックし、[OAuth client ID] を選択します。
  2. [Application type] を選択します (ここでは Web Application を選択します)。
  3. 名前を指定します。
  4. Authorized redirect URLs: 認可の後にリダイレクトするためのリダイレクト URL を追加する必要があります。この URL は、OAuth および OpenID の SSO 設定ページに表示されるものと同じでなければなりません。[シングルサインオン URL] ラベルの下の SSO 設定ページでリダイレクト URL を参照できます。
    例: “https://${domain}/testrail/index.php?/auth/redirect_oidc_acs”
  5. [Create] をクリックします。
  6. 設定のためにコピーする必要がある Client ID および Client Secret を示すポップアップが表示されます。
  7. クライアント ID およびシークレットは、後で [Credentials] タブからコピーすることもできます。
    1. [OAuth 2.0 Client IDs] で認証情報を選択します。新しいページが表示され、右側のパネルにクライアント ID とシークレットが表示されます。
    2. ここでリダイレクト URL を追加/削除/編集することもできます。

Google での SSO 設定 – OpenID Connect

1. 管理者として TestRail にログインします。
2. [管理] > [サイト設定] > [SSO] に移動します。
3. 認証プロトコルの選択: [OpenID Connect] を選択します。
4. シングルサインオン URL: Google で APP の新規登録時にリダイレクト URL を設定するために使用される値があらかじめ設定されています。
5. Google Dashboard にログインしてアプリケーションにアクセスし、TestRail に設定が必要な情報を取得します。
  1. Google の [Credentials] タブから [Application (client) ID] をコピーし、TestRail の [クライアント ID] に設定します。
  2. Google の [Credentials] からクライアントシークレットの [Value] をコピーし、TestRail の [クライアントシークレット] に設定します。
  3. URL https://accounts.google.com/ をコピーし、TestRail の [IDP 発行者 URL]にペーストします。
6. 初回ログイン時にアカウントを作成: この設定は、ユーザーが正常に認証された場合に、TestRail が新しいユーザーアカウントを自動的に作成するかどうかを指定します。
7. ホワイトリストドメイン: 認可されていない組織からのリクエストを防ぐため、アカウントの作成を特定の電子メールドメインだけに制限します。1 行に 1 ドメインを入力します。 ([ホワイトリストドメイン] が空の場合、デフォルトではすべてのドメインが許可されます)。
8. [設定の保存] をクリックします。

Google での SSO 設定 – OAuth 2.0

1. 管理者として TestRail にログインします。
2. [管理] > [サイト設定] > [SSO] に移動します。
3. 認証プロトコルの選択: [Oauth 2.0] を選択します。
4. シングルサインオン URL: Google で APP の新規登録時にリダイレクト URL を設定するために使用される値があらかじめ設定されています。
5. 次の手順で Google Dashboard にログインしてアプリケーションにアクセスし、情報を取得します。
  1. Google の [Credentials] タブから [Application (client) ID] をコピーして、TestRail の [クライアント ID] に設定します。
  2. Google の [Credentials] からクライアントシークレットの [Value] をコピーし、TestRail の [クライアントシークレット] に設定します。
6. ユーザー認可 URI : URL https://accounts.google.com/o/oauth2/v2/auth を設定します。
7. アクセストークン URI: URL https://oauth2.googleapis.com/token を設定します。
8. ユーザー情報 URI : URL https://openidconnect.googleapis.com/v1/userinfo を設定します。
9. 初回ログイン時にアカウントを作成: この設定は、ユーザーが正常に認証された場合に、TestRail が新しいユーザーアカウントを自動的に作成するかどうかを指定します。
10. ホワイトリストドメイン: 認可されていない組織からのリクエストを防ぐため、アカウントの作成を特定の電子メールドメインだけに制限します。1 行に 1 ドメインを入力します。([ホワイトリストドメイン] が空の場合、デフォルトではすべてのドメインが許可されます)。
11. [設定の保存] をクリックします。

Google での SSO 設定 – SAML 2.0

TestRail – SSO URL

1. 管理者として TestRail にログインします。
2. [管理] > [サイト設定] > [SSO] に移動します。
3. [SSO 設定のオフ/オン] ラジオボタンをクリックします。
4. あとで使用するため、[エンティティ ID] で URL をコピーします。
5. あとで使用するため、[シングルサインオン URL] で URL をコピーします。
6. これ以上の設定は必要がないため、[キャンセル] をクリックします。
7. 次の手順に進みます。

Google – カスタム SAML App の作成

1. Google Admin Console にアクセスします。
2. Dashboard で [Apps] をクリックし、[SAML apps] を選択します。
3. [Add a service/App to your domain] をクリックし、[Setup my own custom app] オプションを選択します。
4. あとで使用するため、[SSO URL] を保存します。
5. あとで使用するため、[Entity ID] URL を保存します。
6. Certificate をダウンロードしてテキストエディターまたはメモ帳で開き、あとで使用するために保存します。
7. [Next] をクリックし、アプリケーションに TestRail という名前を付け、もう一度 [Next] をクリックします。
8. [ACS URL] に「TestRail – SSO URL」の手順 5 の シングルサインオン URL を指定し、保存します。
9. [Entity ID] に「TestRail – SSO URL」の手順 4 の エンティティ ID メタデータ URL を指定します。
10. デフォルトのオプションをすべてそのままにして [Next] をクリックします。
11. [Add New Mapping] を 3 回クリックして以下の値を設定します。
  
  Application Attribute Category User Field
  
  user.givenname Basic Information First Name
  
  user.surname Basic Information Last Name
  
  user.mail Basic Information Primary Email
12. 画面ショットと同じように設定できたら、[Finish] をクリックして先に進みます。
13. [SAML Apps] にアクセスします。TestRail app が表示されます。
14. 右側の 3 つの点をクリックし、[ON for everyone] または [ON for some] を選択します。

Application Attribute	Category	User Field
user.givenname	Basic Information	First Name
user.surname	Basic Information	Last Name
user.mail	Basic Information	Primary Email

TestRail – SSO の設定

1. 管理者として TestRail にログインします。
2. [管理] > [サイト設定] > [SSO] に移動します。
3. [SSO 設定のオフ/オン] ラジオボタンをクリックします。
4. [IDP SSO URL] に「Google – カスタム SAML App の作成」の手順 4 の Google の URL を入力します。
5. [IDP 発行者 URL] に「Google – カスタム SAML App の作成」の手順 5 の Google の URL を入力します。
6. [IDP 証明書] に「Google – カスタム SAML App の作成」の手順 6 の Google の証明書テキストを入力します。
7. 必要に応じて [認証のフォールバック] または [初回ログイン時にアカウントを作成] を有効にします。
8. [設定の保存] をクリックします。