Etapa 2: configuração de seu sistema SAP

Para estabelecer uma comunicação entre o UiPath Test Manager e seu sistema SAP, configure o sistema SAP criando um usuário de comunicação e ativando os serviços necessários.

Para autenticação básica de serviço da Web e RFC

1. Crie um usuário de comunicação em seu sistema SAP para a integração com o UiPath Test Manager. Atribua as funções e autorizações necessárias com base nas políticas internas de sua organização.
   • A integração usa interfaces padrão por meio de RFC ou serviço da Web (HTTPS).
   • A UiPath não requer autorizações específicas, exceto para conexões RFC.
   Observação:

   Se você usar uma conexão RFC, atribua o objeto de autorização S_RFCACL ao usuário de comunicação.

2. Se você planeja usar uma conexão de serviço da Web (HTTPS) para a integração, ative os serviços SAP necessários para estabelecer a conexão com a UiPath.
   Observação:

   Esses serviços são usados para operações somente leitura. A UiPath usa apenas métodos HTTP GET para recuperar informações do sistema SAP.

As listas a seguir apresentam os serviços SAP necessários para ativar para usar o Mapa de calor e a Análise de impacto de alterações:

• Serviços do mapa de calor:
  • /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
• Altere os serviços de Análise de impacto:
  • /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/DetailsSetPara ativar os serviços anteriores, siga estas subetapas:

1. Navegue até a interface do usuário do seu sistema SAP.
2. Execute a transação SICF .

Na seção Filtro para Chamar a Hierarquia do IIF , certifique-se de que SERVICE seja inserido no campo Tipo de hierarquia .

Figura 1. A tela Filtro para chamar a hierarquia IIF no SAP

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

Figura 2. A tela de seleção exibindo todos os serviços disponíveis no 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.

Figura 3. Ativação de serviços da 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.

Para a autenticação OAuth do serviço da Web

Lógica

The transport provided includes all transportable objects (OAuth profiles, customizing entries) required for UiPath services. However, SAP does not allow full OAuth configuration to be transported for security and system-specific reasons. For this reason, after importing the transport provided, you must complete the OAuth configuration manually in your environment.

Context

The full OAuth configuration cannot be transported to protect sensitive data and maintain system integrity.

• Client Secrets are system-specific - Secrets cannot be exported or imported for security compliance.
• Authorization Server URLs differ per environment - Each landscape (DEV, QA, PROD) uses unique endpoints.
• Certificates and STRUST entries are local - SSL/TLS trust must be configured manually in each system.
• User assignments and roles are client-dependent - Technical users and authorizations vary across systems.
• Sensitive data protection - OAuth credentials and tokens cannot be transported to prevent exposure.

Pré-requisitos

Each environment (DEV, QA, PROD) requires separate manual setup. Ensure you perform the following prerequisites.

1. Keep the documentation of endpoints and credentials secure. You will need to provide the Authorization Endpoint and the Token Endpoint in step 4.5.
2. Ensure the Authorization Endpoint check is running.
   1. Acesse Transaction SICF e execute-o.
   2. Navigate to :/sap/bc/sec/oauth2. Check that the following node is active: authorize (Authorization Endpoint). If the node is inactive, right-click it, and from the context menu, select Activate Service.

Figure 4. Authorization Endpoint Check

3. Ensure the Token Endpoint check is running.

1. Acesse Transaction SICF.
2. Navigate to :/sap/bc/sec/oauth2. Check that the following node is active: token (Token Endpoint). If the node is inactive, right-click it, and from the context menu, select Activate Service.
3. Observe the naming convention for the Authorization Endpoint. Here is an example of the Authorization Endpoint: https://vhclashci.dummy.nodomain:44301/sap/bc/sec/oauth2/authorization?sap-client=100
   • A parte 1 é o nome de domínio - https://vhclashci.dummy.nodomain
   • A parte 2 é o Número da Porta - 44301
   • Part 3 is the Static string - /sap/bc/sec/oauth2/authorization
   • Part 4 is the SAP Client - 100To build the authorization string, do the following:
   1. Parte 1 — execute transaction RZ11 e procure a entrada 'icm/host_name_full' — esse valor será o nome de domínio para sua entrada no endpoint.
   2. Parte 2 — execute transaction SMICM e selecione o caminho do menu "Goto->Serviços", encontre o protocolo HTTPS e use o número associado ao HTTPS.
   3. Parte 3 — Embuta em código o valor '/sap/bc/sec/oauth2/authorization'.
   4. Parte 4 — Insira o cliente SAP que você está usando no momento.
   5. Certifique-se de usar ponto e vírgula e outras pontuações, conforme necessário.
4. Observe the naming convention for the Token Endpoint.
5. Here is an example of the Authorization Endpoint: https://vhclashci.dummy.nodomain:44301/sap/bc/sec/oauth2/token?sap-client=100
   • A parte 1 é o nome de domínio - https://vhclashci.dummy.nodomain
   • A parte 2 é o Número da Porta - 44301
   • Part 3 is the Static string - /sap/bc/sec/oauth2/token
   • Part 4 is the SAP Client - 100To build the authorization string, do the following:
   1. Parte 1 — execute transaction RZ11 e procure a entrada 'icm/host_name_full' — esse valor será o nome de domínio para sua entrada no endpoint.
   2. Parte 2 — execute transaction SMICM e selecione o caminho do menu "Goto->Serviços", encontre o protocolo HTTPS e use o número associado ao HTTPS.
   3. Parte 3 — Embuta em código o valor '/sap/bc/sec/oauth2/token'.
   4. Parte 4 — Insira o cliente SAP que você está usando no momento.
   5. Certifique-se de usar ponto e vírgula e outras pontuações, conforme necessário.

Etapas

1. Verify your transport import details and availability.
   1. Check that OAuth profiles are available. Use transaction SE80 to ensure OAuth 2.0 Client Profiles are available.
   2. From the dropdown menu, select Package.
   3. Digite "/UIPATH/HEADMAP" na caixa de texto e pressione Enter. Os perfis do cliente OAuth 2.0 devem aparecer no menu suspenso. Se os perfis não estiverem disponíveis, entre em contato com o suporte da UiPath.

Figure 5. Verify transport import

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

1. Para transaction SUO1, entre em contato com sua equipe de segurança para a criação do usuário.
2. Crie um usuário do sistema com acesso aos serviços /UIPATH/ de acordo com os padrões de nomenclatura da sua empresa.
3. Gere uma senha de acordo com os padrões de nomenclatura da sua empresa — isso se tornará seu 'segredo' na configuração do OAuth2 posteriormente.
4. Configure SSL/TLS Trust. For transaction STRUST, contact your Basis Team for certificate verification.
5. Create the OAuth 2.0 configuration.
   1. For transaction OA2C_CONFIG, select Create and, in the popup, select the transported profile you want use. (You will eventually use every listed profile.)
   2. Insira o Nome do perfil.
   3. Digite o Nome de usuário para o Nome do cliente.
   4. Pressione OK.
   5. Configure os campos e salve a configuração:
      1. Client Secret: Select the corresponding scope (server) for each client and hit Enter.
      2. Authorization Endpoint URL (check the Prerequisites section of this topic).
      3. Token Endpoint URL (check the Prerequisites section of this topic).
      4. Client Authentication: Select the Basic radio button.
      5. Selected Grant Type: Select the Client Credentials radio button.
      6. Refresh Token Validity: Enter -1 in textbox.
      7. Clock Skew Tolerance: Enter 5 in textbox.
   6. Check the Summary screen, which should look like the screenshots below.

Figure 6. OAuth summary page 1

Figure 7. OAuth summary page 2

5. Configure transaction SOAUTH2 OAuth2 Clients.

1. For transaction SOAUTH2, select Create and in the first screen, enter the following information:
   • **Client Type:**Confidential
   • **Client Id:**Enter the same Username as above (step 4.3
     • 4.c)
   • **Description:**Enter the service name or profile name.
   • **Token Lifetime:**3600 Seconds
2. Select Next and, in the second screen, enter the following information:
   • Client User Id and Password - Checked
   • SSL Certificate - Checked
   • Check Parameter: “Client Id” – Checked
3. Select Next and, in the third screen, enter the following information:
   • Grant Type Client Credentials Active – Checked
4. Select Next and, in the fourth screen, enter the following information:
   • Under OAuth2 Scope Id, find the first empty line and click on the drop-down list at the end of the blank row.
   • Selecione cada um dos escopos associados à UiPath até que todos sejam selecionados.
     • /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. Select Summary. The screen should look like the example below.

Figure 8. OAuth2 Client summary page

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

1. Execute transaction SE38 e insira o nome do programa '/UIPATH/TEST_OAUTH2_SERVICE' para sistemas S4 não compatíveis com RISE.
2. Hit Execute. A selection/parameter screen appears.
3. Atualize os parâmetros a seguir para corresponder ao seu sistema/usuário/senha.
   • Port – HTTPS Port
   • Client – The current Client should default into a variable.
   • Secret – Enter the password for Client_ID/User.
   • System Name – The current System Name should default into a variable.
   • Client ID – Enter the User ID for UiPath Services.
4. Hit Execute. The results appear on the next screen. Look for Service Status to be equal to ‘200’. Any other return code indicates an error.

Figure 9. Test Non-RISE compliant connection

7. Test the connection for RISE compliant systems.

1. Execute transaction SE38 e insira o nome do programa '/UIPATH/TEST_OAUTH2_SSV_rise' para sistemas S4 compatíveis com RISE.
2. Hit Execute. A selection/parameter screen appears.
3. Atualize os parâmetros a seguir para corresponder ao seu sistema/usuário/senha.
   • Port – HTTPS Port
   • Client – The current Client should default into a variable.
   • Secret – Enter the password for Client_ID/User.
   • System Name – The current System Name should default into a variable.
   • Client ID – Enter the User ID for UiPath Services.
4. Hit Execute. The results appear on the next screen. Look for Service Status to be equal to ‘200’. Any other return code indicates an error.