このページを共有

# ステップ 1: ALM を SP として設定

前提条件: 「ステップ 0: 準備」

このステップでは、SSO 設定ツールで ALM を SP として設定します。

このトピックの内容:

注: このステップを完了すると、次の ALM リポジトリで SP 設定ファイルを見つけられます。`{ALM repository}\sa\DomsInfo\osp\basic.properties`

## ALM サーバの一般情報の指定

1. ALM サイト管理にログインします。

2. ［ツール］＞［SSO 設定］をクリックして、SSO 設定ツールを開きます。

3. ［一般設定］＞［プロパティ］をクリックして、次の情報を入力します。

   フィールド (* 必須) | 説明
   --- | ---
   *OAuth クライアント・シークレット | ALM サービス・プロバイダ (SP) でアクセス・トークンの生成に使用するシークレット
   *ローカル認証を有効にする | このオプションは、ALM ローカル・ユーザとして設定されているユーザが、ALM が SSO モードで実行されているときに ALM にローカルにログインできるかどうかを制御します。 いいえ: ALM が SSO モードで実行されている場合、ALM はローカル認証をサポートしません。 ALM が SSO モードで実行されているときは、実際の IdP ID を持つユーザのみが ALM にアクセスできます。 はい: ALM が SSO モードで実行されている場合、ALM はローカル認証もサポートします。 ALM が SSO モードで実行されているときは、実際の IdP ID を持つユーザに加えて、IdP ID が「local」に設定されているユーザも ALM にアクセスできます。 ユーザの IdP ID と ID キーの設定の詳細については、ALM ユーザの管理を参照してください。 ［一般設定］＞［自分のプロファイル］タブは、IdP ID と ID キーを設定するためのショートカットを提供します。
   *通信 FQDN | ALM サーバの FQDN (完全修飾ドメイン名) ALM サーバの前で Web サーバ/リバース・プロキシが使用されている場合は、Web サーバの FQDN にします。
   *通信ポート | リバース・プロキシが使用されない場合は、ALM サーバのポート番号です。 リバース・プロキシが使用される場合は、HTTP 要求ヘッダで使用されるポート番号です。ポート番号はサーバ・ログで確認できます。SSO ログを表示する方法の詳細については、FAQを参照してください。
   *セキュリティ保護された通信を有効にする | はい: HTTP 要求ヘッダのスキーマの値が「https」で始まる場合は、［はい］を選択します。 いいえ: HTTP 要求ヘッダのスキーマの値が「http」で始まる場合は、［いいえ］を選択します。
   リバースプロキシの使用 | リバース・プロキシを使用するかどうかを指定します。使用する場合は、リバース・プロキシ・ポートも指定してください。
   リバース プロキシ ポート | リバース・プロキシのポート番号
   セキュア リバース プロキシを有効化 | はい: リバース・プロキシで、セキュリティ保護された通信を有効にする場合は、［はい］を選択します。 いいえ: リバース・プロキシで、セキュリティ保護された通信を有効にしない場合は、［いいえ］を選択します。

4. ［保存］をクリックして設定を保存します。

先頭に戻る

## SAML 証明書のアップロード

SAML 証明書は、ALM と IdP 間の SAML 要求および応答の暗号化/復号化に使用されます。

ALM 用に SAML 証明書を作成する方法の詳細については、FAQを参照してください。

［一般設定］＞［SSO 証明書］をクリックして証明書を提示します。

証明書は、キーストア・ファイルをアップロードするか、証明書情報を手動で入力して提示できます。

キーストア・ファイルをアップロードして証明書を提示するには | ［証明書の送信タイプ］フィールドで、［キーストアファイルをアップロード］を選択します。 ［アップロードするファイルの選択］フィールドで、証明書が含まれているキーストア・ファイルを選択します。 キーストア・ファイルの証明書には秘密鍵と公開鍵の両方が含まれていることを確認してください。 ALM がサポートするキーストア・タイプは次のとおりです。JKS、JCEKS、および PKCS12。そのため、アップロードしようとするキーストア・ファイルの拡張子名は、次のいずれかであることが必要です。 JKS キーストア・タイプの場合: `.jks` または `.ks` JCEKS キーストア・タイプの場合: `.jce` PKCS12 キーストア・タイプの場合: `.p12` または `.pfx` キーストアと証明書のパスワードを入力します。 キーストア・ファイルで使用されている証明書のエイリアスを入力します。 ［送信］をクリックします。
証明書情報を手動で入力して証明書を提示するには | ［証明書の送信タイプ］フィールドで、［手動で入力］を選択します。 キーストアと証明書のパスワード、証明書チェーン、および秘密鍵を入力します。 ［送信］をクリックします。

### 証明書の管理

証明書のアップロード後は、その詳細を表示し、別の証明書をアップロードできます。

［SSO 証明書］タブには、証明書のエイリアスと有効期限が表示されます。詳細を表示するには、［証明書の表示］リンクをクリックします。

別の証明書をアップロードするには、次の手順を実行します。

1. ［SSO 証明書］タブの［証明書の削除］リンクをクリックして、現在の証明書を削除します。

   現在の証明書をディレクトリ`{ALM Deploy Directory}\ALM\repository\sa\DomsInfo\osp\basic.pfx` から削除することもできます。

2. 現在のページを更新します。
3. 新しい証明書をアップロードします。
4. ALM サーバを再起動します。ALM がクラスタ環境にある場合は、各ノードを再起動します。
5. ALM の SP メタデータを IdP と共有している場合は、更新された SP メタデータを取得して、IdP と共有し直す必要があります。「ステップ 2: 標準設定の IdP の設定」を参照してください。

先頭に戻る

## 自分のプロファイルの設定

［一般設定］＞［自分のプロファイル］タブは、IdP 名と ID キーを指定するためのショートカットを提供します。これは、IdP ユーザをマップするために使用されます。

プロファイルを設定するには、次のフィールドに入力して、［保存］をクリックします。

フィールド | 説明
--- | ---
IdP | サイト管理者として、SSO を有効にするのであれば、次のいずれかを実行します。 すでに IdP ユーザにマップされている場合は、マップされた IdP ユーザが属する IdP 名を IdP に設定します。 まだ IdP ユーザにマップされていない場合は、「local」を選択してローカル認証を有効にします。 このようにしない場合、SSO を有効にした後は、自分が ALM にアクセスできず、おそらくどのユーザも ALM にアクセスできません。詳細については、IdP を検証せずに SSO を有効化を参照してください。 以下で、使用可能なオプションについて説明します。 (空) : SSO を有効にする前に ALM にすでに存在していたユーザの IdP と ID キーは空です。このようなユーザは、SSO が有効になった後は ALM にアクセスできません。SSO の設定中に、自分の IdP を「空」に設定しないでください。 local: IdP が「local」に設定されているユーザは、ローカル ALM ユーザです。このようなユーザは、SSO が有効になった後で、ローカル認証が有効になっている場合にのみ ALM にローカルにアクセスできます。ローカル認証の設定については、*ローカル認証を有効にするを参照してください。 <実際の IdP ID>: IdP ユーザにマップされたユーザは、実際の IdP を持っています。
ID キー | ユーザの IdP が「local」として設定されている場合、［ID キー］は空にすることができます。ユーザの IdP が実際の IdP として設定されている場合、［ID キー］は、ユーザを識別するための一意の値として設定する必要があります。

先頭に戻る

## FAQ

Q: ALM 用の SAML 証明書はどのように作成しますか？

A: SAML 証明書は、一般に、より安全な証明書を取得できるように、認定された組織から取得することをお勧めします。ただし、組織がさほど高度なセキュリティ・ポリシーを必要としない場合は、SAML 証明書を自分で作成できます。

Windows、Mac、または Linux で keytool コマンドを使用して自己署名 SSL 証明書を生成するには、次の手順を実行します。

1. コマンド・プロンプトまたはターミナルを開き、次のコマンドを実行します。

       keytool-genkey-keyalgRSA -alias <alias> -keystoreselfsigned.jks-validity <days> -keysize2048

   ここで、`<alias>` は証明書の名前を示します。`<days>` は、証明書が有効な日数を示します。

2. キーストア・ファイルのパスワードを入力します。このパスワードはメモしておいてください。サーバを設定するときに必要になります。

3. 姓名の入力を求められたら、サーバのドメイン名を入力します。たとえば、myserver や myserver.mycompany.com です。

4. その他の詳細 (組織単位、組織、市、州、国など) を入力します。

5. 入力した情報が正しいことを確認します。

6. <tomcat> の「Enter key」パスワードの入力を求められたら、`Enter` を押して、キーストア・ファイルと同じパスワードを使用します。

7. 次のコマンドを実行して、キーストア・ファイルの内容を確認します。

       keytool-list -v -keystoreselfsigned.jks

8. プロンプトが表示されたら、キーストア・ファイルのパスワードを入力します。

生成する証明書の名前は `selfsigned.jks` になります。その拡張子名は変更しないでください。「Owner」と「Issuer」が同じであることを確認します。エイリアス、キー・パスワード、およびキーストア・ファイル・パスワードは、SSO 設定ツールで証明書をアップロードまたは削除するのに必要なため、安全な場所に保管してください。

Q: SSO ログを取得する方法は？

A:

1. ALM リポジトリにある SP 設定ファイルを開きます。`{ALM repository}\sa\DomsInfo\osp\basic.properties`
2. 「logging.level=ALL」を設定します。

3. ALM を再起動し、ALM に再度ログインします。

4. サーバ・ログで `java.io.tmpdir` のディレクトリを確認します。そのディレクトリ内の `osp-*` ファイルは、すべて SSO ログ・ファイルです。

先頭に戻る

次のステップ:

- 「ステップ 2: 標準設定の IdP の設定」

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