このページを共有

# ステップ 7: SSO の有効化

前提条件: 「ステップ 6: IdP の検証」

このステップでは、SSO を有効にします。これは、IdP「alm」の検証が成功した後にのみ実行してください。SSO を有効にすると ALM SSO 認証が完成し、必要に応じて他の IdP を追加できます。

SSO を有効にするには、SSO 設定ツールの右上隅にある［SSOの有効化］トグルをオンにします。いったん有効にした SSO 認証は、無効にできません。

## FAQ

Q: ALM 15.0 で SSO を有効にした後に、ALM Client Launcher を介して ALM にログインできないのはなぜですか？

A: 根本原因: 古いバージョンの ALM Client Launcher が使用されました。

解決策: ALM 15.x SSO ソリューションを使用するには、最新の ALM Client Launcher をダウンロードしてください。

https://marketplace.microfocus.com/appdelivery/content/alm-client-launcher

Q: IdP の「alm」の検証に失敗した後でも、［SSOの有効化］ボタンをクリックできるのはなぜですか？

A: 「ステップ 1: ALM を SP として設定」で「ローカル認証を有効にする」を「はい」に設定すると、ローカル・ユーザは ALM 側で、IdP ユーザは IdP 側で認証されます。ALM では、ALM ローカル・ユーザは、IdP「alm」が検証に合格しなかった場合でも、SSO を有効にできます。これは、合格しなかったような場合でも IdP ユーザが ALM にログインできるように、ユーザがローカル・ユーザとして ALM にログインして、IdP 設定を修正する可能性があるためです。

Q: 何かの問題が原因で SSO 認証に失敗し、SSO 設定ツールを開くことができない場合は、どうすればよいですか？

A: SSO が有効になった後でも、ローカル・ユーザが ALM にログインして SSO 設定の問題を修正できるように、ローカル認証を有効にすることをお勧めします。

Q: SSO を有効にしたら、ローカル・アカウントは失われますか？

A: 15.0.1 以降、SSO が有効になった後は、すべてのユーザが SSO 認証またはローカル認証のいずれかを介して認証されます。

ローカル・アカウントは、SSO が有効になった後も ALM に保持されます。認証を受けるには、ローカル・アカウントが次の要件のどちらかを満たしている必要があります。

- IdP ユーザにマップされている。
- ALM ローカル・ユーザとして設定されていて、ローカル認証が有効になっている。

Q: フェデレーション・パートナシップをバイパスして ALM に直接ログインできますか？

A: ALM 15.0.1 以降では、ローカル認証がサポートされています。ローカル認証が有効になっている場合、サイト管理者は、ユーザの IdP ID を「local」として指定することにより、そのユーザを ALM ローカル・ユーザとして設定できます。このようなローカル・ユーザは、ALM に直接ログインできます。

Q: SSO が有効になる前に作成しアクセスされていたプロジェクトは、SSO の有効後にどうなりますか？

A: プロジェクト・データへの影響はありません。SSO 認証で変更されるのはユーザ管理のみです。

Q: QC/ALM を何年も使用している場合、同じリソースに対して以前と同じ方法でアクセスできますか？

A: SSO モードに切り替えても、既存ユーザのユーザ名は変更されません。ユーザは、ALM が非 SSO モードで実行されていたときにアクセスしていたのと同じリソースに引き続きアクセスできます。

ユーザは、対応する IdP ユーザにマップされるだけです。USERS テーブルには 2 つの追加カラム (US_IDENTITY_KEY および US_IDPID_NAME) があり、このカラムに各ユーザのユーザ・マッピング情報が保持されます。

Q: IdP で認証された後で ALM 15.0 にアクセスしようとしたときに、Web ブラウザに「431 Request Header Fields Too Large」と報告されるのはなぜですか？

A: ALM 15 が SSO モードで動作する場合、いくつかの IdP セッションおよび SP セッションが HTTP 要求の Cookie の末尾に追加されます。これにより、要求ヘッダ・サイズは ALM が非 SSO モードで実行される場合よりも大幅に大きくなります。この問題は、ユーザのリバース・プロキシまたは ALM が、要求ヘッダのサイズを実際のサイズよりも小さく制限しているときに発生します。

この問題を解決するには、ALM Jetty 設定を変更して、要求ヘッダ・サイズを大きくします。推奨サイズ: 81920。Jetty コネクタの "requestHeaderSize" を設定する方法については、Jetty のドキュメントを参照してください。

リバース・プロキシでも要求ヘッダのサイズを制限している場合は、ネットワーク管理者にサイズの変更を依頼してください。

Q: SSO が有効になった後で ALM リポジトリ・フォルダが変更された場合、SSO 設定ファイルを手動で変更するにはどうすればよいですか？

A: SSO 設定ファイルを手動で変更するには、次の手順を実行します。

1. `{installzation_folder}` にある `qcConfigFile.properties` ファイルで、「repositoryPath」の値を新しいリポジトリ・フォルダに更新します。

2. `{deployment_folder}/wrapper` にある `wrapper.conf` ファイルで、「wrapper.java.additional.34」の値を次のように更新します。

   `wrapper.java.additional.34=-Dalm.osp.framework.generic-properties-filename="{New ALM repository}/sa/DomsInfo/osp/basic.properties"`

3. `{project repository folder}` にある `basic.properties` ファイルで、「oauth-keystore.file」の値を次のように更新します。

   `oauth-keystore.file={New ALM repository}\\sa\\DomsInfo/osp/basic.pfx`

4. `{project repository folder}` にある `ospcfg.xml` ファイルで、「name="propertiesFile"」の値を次のように更新します。

   `<NamedValue value="{New ALM repository}\sa\DomsInfo/osp/alm.properties" name="propertiesFile"/>`

5. SSO 設定ツールで「ステップ 1: ALM を SP として設定」、「ステップ 2: 標準設定の IdP の設定」、および「ステップ 3: SSO コンポーネントのデプロイ」を実行します。

注: ALM リポジトリを変更する方法の詳細については、ナレッジベース記事を参照してください。

Q: SSO が有効になった後で、Chrome または Edge (バージョン 86 以降) を使用して ALM にログインすると、IdP ログイン・ページにリダイレクトされます。IdP にログインした後も、Chrome や Edge で、ALM と IdP の間でリダイレクトが繰り返されます。

A: Chrome または Edge のセキュリティ設定を変更します。

1. Chrome の場合は「chrome://flags/」、Edge の場合は「edge://flags/」と入力します。
2. キーワード「SameSite by default cookies」を検索します。

3. Chrome の場合: ［Cookies without SameSite must be secure］および［SameSite by default cookies］オプションを［Disabled］に設定します。

   Edge の場合: ［SameSite by default cookies］および［Schemeful Same-Site］オプションを［Disabled］に設定します。

先頭に戻る

次のステップ:

- 「 (オプション) ステップ 8: IdP の追加」

https://admhelp.microfocus.com ALM 8942
検索結果の改善のヒント... ALM ヘルプセンター ALM ヘルプセンター ALM ヘルプ 16.00 すべてローカル・ヘルプセンターの表示オンライン・ヘルプセンターの表示戻るブラウザ履歴で元に戻る進むブラウザ履歴で前に進む検索の強調表示を解除次のトピック次のトピックに移動前のトピック前のトピックに移動現在のトピックを印刷バージョン: