手順 2: SAP システムを構成する

UiPath Test Manager と SAP システム間の通信を確立するには、通信ユーザーを作成して必要なサービスをアクティブ化し、SAP システムを構成します。

Web サービスの基本認証と RFC の場合

1. UiPath Test Manager と連携するために、SAP システム内に通信ユーザーを作成します。組織の内部ポリシーに基づいて、必要なロールと認可を割り当てます。
   • この連携には、RFC または Web サービス (HTTPS) を介した標準のインターフェイスを使用します。
   • UiPath では、RFC 接続の場合を除き、特定の認可を必要としません。
   注:

   RFC 接続を使用する場合は、 S_RFCACL 権限オブジェクトを通信ユーザに割り当てます。

2. 連携に Web サービス (HTTPS) 接続を使用する予定の場合は、UiPath との接続を確立するために必要な SAP サービスをアクティブ化します。
   注:

   これらのサービスは読み取り専用操作に使用されます。UiPath が SAP システムから情報を取得するときに使用するのは、 HTTP GET メソッドのみです。

次のリストに、ヒートマップと変更影響分析を使用するためにアクティブ化する必要がある SAP サービスを示します。

• ヒートマップ サービス:
  • /sap/opu/odata/UIPATH/HEATMAP_AGGREGATES_SRV/AllAggregatesSet
  • /sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet
  • /sap/opu/odata/UIPATH/TRANSPORT_LOOKBACK_SRV/TransportLookbackSet
  • /sap/opu/odata/UIPATH/S4_CHECK_SRV/S4Info
  • /sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet
• 変更影響分析サービス:
  • /sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet
  • /sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportStatusSet
  • /sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis
  • /sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/TransportAnalysisSet
  • /sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet前のサービスをアクティブ化するには、次の手順を実行します。

1. SAP システムのユーザー インターフェイスに移動します。
2. SICF トランザクションを実行します。

[ICF 階層呼出のフィルタ(Filter for Calling ICF Hierarchy)] セクションで、[階層タイプ(Hierarchy Type)] フィールドにSERVICE が入力されていることを確認します。

図 1.SAP の [ICF 階層呼出のフィルタ] 画面

3. Select Execute to finish the execution of the SCIF transaction. A selection screen appears, displaying various services available in your SAP system.

図 2. SAP で利用可能なすべてのサービスが表示された選択画面

4. Under Virtual Hosts/Services, expand the following menu path: default_host > sap > opu > odata > uipath. If this is your first activation, the UiPath services are likely greyed out, indicating they are installed but not active. Upon activation, they will display in bold. 5. Right-click each UiPath service entry under uipath, and select Activate Service.

図 3. UiPath サービスのアクティブ化

6. In the Activation of ICF services pop-up window, select Yes to confirm the service activation. Once a service is activated, it will display in bold.

Web サービスの OAuth 認証の場合

理論的根拠

提供される移送には、UiPath サービスに必要なすべての移送可能なオブジェクト (OAuth プロファイル、カスタマイジング エントリ) が含まれます。ただし、SAP では、セキュリティ上およびシステム固有の理由から、OAuth の完全な構成の移送は許可されていません。このため、提供されているトランスポートをインポートした後は、お使いの環境で OAuth の構成を手動で完了する必要があります。

Context

機密データを保護し、システムの整合性を維持するために、完全な OAuth 構成を転送することはできません。

• クライアント シークレットはシステム固有である - セキュリティ コンプライアンスのため、シークレットをエクスポートまたはインポートすることはできません。
• 認可サーバーの URL は環境によって異なる - 各ランドスケープ (開発、品質、本番) で一意のエンドポイントが使用されます。
• 証明書と STRUST エントリはローカルです - SSL/TLS 信頼は、各システムで手動で構成する必要があります。
• ユーザの割り当てとロールはクライアント依存 - 技術ユーザと権限はシステムによって異なります。
• 機密データの保護 - 露出を防ぐために OAuth の資格情報とトークンを移送することはできません。

前提条件

各環境 (DEV、QA、PROD) では、個別の手動設定が必要です。次の前提条件を必ず実行してください。

1. エンドポイントと資格情報のドキュメントを安全な場所に保管します。 手順 4.5 で認可エンドポイントとトークン エンドポイントを指定する必要があります。
2. 認可エンドポイントのチェックが実行されていることを確認します。
   1. Transaction SICF に移動して実行します。
   2. :/sap/bc/sec/oauth2 に移動します。authorize (認可エンドポイント) ノードがアクティブであることを確認します。ノードが非アクティブな場合は、ノードを右クリックし、コンテキストメニューから [Activate Service]を選択します。

図 4. 認可エンドポイントのチェック

3. Ensure the Token Endpoint check is running.

1. Transaction SICF に移動します。
2. :/sap/bc/sec/oauth2 に移動します。ノード「token (トークン エンドポイント)」がアクティブであることを確認します。ノードが非アクティブな場合は、ノードを右クリックし、コンテキストメニューから [Activate Service]を選択します。
3. 認可エンドポイントの命名規則に従います。 認可エンドポイントの例を次に示します。https://vhclashci.dummy.nodomain:44301/sap/bc/sec/oauth2/authorization?sap-client=100
   • パート 1 はドメイン名 - https://vhclashci.dummy.nodomain
   • パート 2 はポート番号 - 44301
   • パート 3 は静的文字列です - /sap/bc/sec/oauth2/authorization
   • パート 4 は SAP クライアント - 100承認文字列を作成するには、以下の手順を実行します。
   1. パート 1 - transaction RZ11 を実行して、エントリ「icm/host_name_full」を検索します。この値は、エンドポイント内のエントリのドメイン名になります。
   2. パート 2 – transaction SMICM を実行して、メニュー パス「Goto->Services」を選択し、HTTPS プロトコルを検索して HTTPS に関連付けられた番号を使用します。
   3. パート 3 – 値「/sap/bc/sec/oauth2/authorization」をハードコーディングします。
   4. パート 4 – 現在使用している SAP クライアントを入力します。
   5. 必要に応じて、セミコロンやその他の句読点を使用します。
4. トークン エンドポイントの命名規則に従ってください。
5. 認可エンドポイントの例を次に示します。https://vhclashci.dummy.nodomain:44301/sap/bc/sec/oauth2/token?sap-client=100
   • パート 1 はドメイン名 - https://vhclashci.dummy.nodomain
   • パート 2 はポート番号 - 44301
   • パート 3 は静的文字列です - /sap/bc/sec/oauth2/token
   • パート 4 は SAP クライアント - 100承認文字列を作成するには、以下の手順を実行します。
   1. パート 1 - transaction RZ11 を実行して、エントリ「icm/host_name_full」を検索します。この値は、エンドポイント内のエントリのドメイン名になります。
   2. パート 2 – transaction SMICM を実行して、メニュー パス「Goto->Services」を選択し、HTTPS プロトコルを検索して HTTPS に関連付けられた番号を使用します。
   3. パート 3 – 値「/sap/bc/sec/oauth2/token」をハードコードディングします。
   4. パート 4 – 現在使用している SAP クライアントを入力します。
   5. 必要に応じて、セミコロンやその他の句読点を使用します。

手順

1. 移送のインポートの詳細と利用可否を確認します。
   1. OAuth プロファイルが利用可能であることを確認します。transaction SE80 を使用して、OAuth 2.0 クライアント プロファイルが利用可能であることを確認します。
   2. ドロップダウン メニューから [パッケージ] を選択します。
   3. テキストボックスに「UiPath/HEATMAP」と入力し、Enter キーを押します。ドロップダウン メニューに [OAuth 2.0 クライアント プロファイル] が表示されます。プロファイルが利用できない場合は、UiPath サポートにお問い合わせください。

図 5. 移送のインポートを確認する

2. Configure Client ID/User Id/System User and Client Secret.

1. transaction SUO1 については、セキュリティ チームに連絡してユーザーを作成します。
2. 会社の命名基準に従って、/UIPATH/ サービスへのアクセス権を持つシステム ユーザーを作成します。
3. 会社の命名基準に従ってパスワードを生成します – これは後で OAuth2 構成時の「シークレット」になります。
4. SSL/TLS 信頼を構成します。transaction STRUSTについては、証明書の確認についてBasisチームにお問い合わせください。
5. OAuth 2.0 の設定を作成します。
   1. transaction OA2C_CONFIG で [作成] を選択し、使用する移送されたプロファイルをポップアップで選択します。(最終的には、リストに表示されているすべてのプロファイルを使用します。)
   2. プロファイル名を入力します。
   3. [クライアント名] に [ユーザー名] を入力します。
   4. [OK] をクリックします。
   5. フィールドを設定し、構成を保存します。
      1. クライアント シークレット: 各クライアントに対応するスコープ (サーバー) を選択し、Enter キーを押します。
      2. 認可エンドポイント URL (このトピックの「前提条件」のセクションを確認してください。)
      3. トークン エンドポイント URL (このトピックの「前提条件」のセクションを確認してください。)
      4. クライアントの認可: [基本] のラジオ ボタンを選択します。
      5. 選択した付与タイプ: [クライアント資格情報] のラジオ ボタンを選択します。
      6. 更新トークンの有効性: テキストボックスに -1 を入力します。
      7. クロックスキュー許容範囲:テキストボックスに 5 を入力します。
   6. [ 概要 ] 画面を確認します。この画面は以下のスクリーンショットのようになります。

図 6. OAuth の概要ページ 1

図 7. OAuth の概要ページ 2

5. Configure transaction SOAUTH2 OAuth2 Clients.

1. transaction SOAUTH2 で [作成] を選択し、最初の画面で次の情報を入力します。
   • **クライアントタイプ:**機密
   • **クライアント ID:**上記と同じユーザー名を入力します (手順 4.3
     • 4.c)
   • **説明:**サービス名またはプロファイル名を入力します。
   • **トークンの有効期間:**3600秒
2. [次へ] を選択し、2 番目の画面で次の情報を入力します。
   • クライアント ユーザー ID とパスワード - オン
   • SSL 証明書 - オン
   • チェック パラメーター:「クライアント ID」– オン
3. [次へ] を選択し、3 番目の画面で次の情報を入力します。
   • 付与タイプ クライアント資格情報アクティブ – オン
4. [次へ] を選択し、4 番目の画面で次の情報を入力します。
   • [ OAuth2 スコープ ID] で最初の空の行を見つけ、空白行の末尾にあるドロップダウン リストをクリックします。
   • UiPath に関連付けられているスコープを 1 つずつ選択して、すべて選択します。
     • /UIPATH/ANALYZED_YES_OR_NO_SRV_0001
     • /UIPATH/EXE_ANALYSIS_SRV_0001
     • /UIPATH/GET_TRANSPORT_ALLITEMS_SRV_0001
     • /UIPATH/GET_TRANSPORT_DETAILS_SRV_0001
     • /UIPATH/GET_TRANSPORT_EXES_SRV_0001
     • /UIPATH/HEATMAP_AGGREGATES_SRV_0001
     • /UIPATH/HEATMAP_OVERVIEW_SRV_0001
     • /UIPATH/TRANSPORT_INFO_SRV_0001
     • /UIPATH/TRANSPORT_LOOKBACK_SRV_0001
     • /UIPATH/TRANSPORT_STATUS_SRV_0001
     • /UIPATH/ZS4_CHECK_SRV_0001
5. [ 概要] を選択します。画面は次の例のようになります。

図 8. OAuth2 クライアントの概要ページ

6. Test the connection for Non-RISE compliant systems.

1. transaction SE38 を実行し、RISE に準拠していない S4 システムのプログラム名「/UIPATH/TEST_OAUTH2_SERVICE」を入力します。
2. [ 実行] を選択します。選択/パラメータ画面が表示されます。
3. システム/ユーザー/パスワードと一致するように次のパラメーターを更新します。
   • ポート – HTTPS ポート
   • クライアント – 現在のクライアントが既定で変数に設定されます。
   • シークレット – Client_ID/ユーザーのパスワードを入力します。
   • システム名 – 現在のシステム名が既定で変数に設定されます。
   • クライアント ID – UiPath サービスのユーザー ID を入力します。
4. [ 実行] を選択します。結果は次の画面に表示されます。「200」に等しいサービスステータスを探します。その他のリターンコードはエラーを示します。

図 9. RISE に準拠していない接続をテストする

7. Test the connection for RISE compliant systems.

1. transaction SE38 を実行し、RISE に準拠している S4 システムのプログラム名「/UIPATH/TEST_OAUTH2_SRV_RISE」を入力します。
2. [ 実行] を選択します。選択/パラメータ画面が表示されます。
3. システム/ユーザー/パスワードと一致するように次のパラメーターを更新します。
   • ポート – HTTPS ポート
   • クライアント – 現在のクライアントが既定で変数に設定されます。
   • シークレット – Client_ID/ユーザーのパスワードを入力します。
   • システム名 – 現在のシステム名が既定で変数に設定されます。
   • クライアント ID – UiPath サービスのユーザー ID を入力します。
4. [ 実行] を選択します。結果は次の画面に表示されます。「200」に等しいサービスステータスを探します。その他のリターンコードはエラーを示します。