Etapa 2: configuração de seu sistema SAP

Configure seu sistema SAP para o Test Manager criando um usuário de comunicação, ativando os serviços da UiPath e, opcionalmente, configurando o OAuth 2.0.

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

Crie um usuário de comunicação em seu sistema do SAP e ative os serviços da UiPath necessários para permitir que o Test Manager recupere os dados do Mapa de Calor e da Análise de Impacto de Alterações por meio de uma autenticação básica ou conexão RFC de serviço da web.

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/DetailsSet

Para 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 .
3. 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

4. Selecione Executar para finalizar a execução da transação SICF . Uma tela de seleção é exibida, exibindo vários serviços disponíveis em seu sistema SAP.

Figura 2. A tela de seleção exibindo todos os serviços disponíveis no SAP

5. Em Hosts/Serviços virtuais, expanda o seguinte caminho de menu: default_host > sap > opu > odata > uipath. Se esta for sua primeira ativação, os serviços da UiPath provavelmente estarão acinzentados, indicando que eles estão instalados, mas não ativos. Após a ativação, eles serão exibidos em negrito.
6. Abra o menu de contexto para cada entrada de serviço da UiPath em uipath e selecione Ativar serviço.

Figura 3. Ativação de serviços da UiPath

7. Na janela pop-up Ativação de serviços IIF , selecione Sim para confirmar a ativação do serviço. Quando um serviço é ativado, ele é exibido em negrito.

Details about SAP services

The following table describes the Heatmap services and their purpose.

Serviço	Description
/sap/opu/odata/UIPATH/HEATMAP_AGGREGATES_SRV/AllAggregatesSet	Retrieves all aggregated records (data rolled up into fewer, summarized entries). This service is called first to determine the start and end dates of the available data periods, which are then passed to FinalHeatmapSet.
/sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet	Retrieves all transports within a specified date range, together with their details.
/sap/opu/odata/UIPATH/TRANSPORT_LOOKBACK_SRV/TransportLookbackSet	Returns the number of transports per month for the period between two specified dates.
/sap/opu/odata/UIPATH/S4_CHECK_SRV/S4Info	Checks whether the connected SAP system is SAP S/4HANA.
/sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet	Retrieves the actual transaction counts for the date periods returned by AllAggregatesSet, used to populate the heatmap.

The following table describes the Change Impact Analysis services and their purpose. These services support the analysis and lookup of SAP transports affected by changes.

Serviço	Description
/sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet	Retrieves analysis data from UiPath's custom tables. This service is part of the backend Change Impact Analysis logic.
/sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportStatusSet	Returns the analysis status (analyzed or not yet analyzed) of transports within a specified date range.
/sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis	Analyzes transports within a specified date range and stores the results in UiPath's custom tables.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/TransportAnalysisSet	Returns the complete analysis for a specified transport, including the list of impacted users. If the transport has not yet been analyzed, it is analyzed first and the results are saved.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet	Returns the complete analysis for a specified transport. If the transport has not yet been analyzed, it is analyzed first and the results are saved.

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

Lógica

O transporte fornecido inclui todos os objetos utilizáveis (perfis do OAuth, personalização de entradas) necessários para os serviços da UiPath. No entanto, a SAP não permite que a configuração completa do OAuth seja carregada por motivos de segurança e específicos do sistema. Por esse motivo, após importar o transporte fornecido, você deve concluir a configuração do OAuth manualmente em seu ambiente.

Context

A configuração completa do OAuth não pode ser transportado para proteger dados confidenciais e manter a integridade do sistema.

• Os segredos dos clientes são específicos do sistema – Os segredos não podem ser exportados ou importados para conformidade com a segurança.
• As URLs do Servidor de Autorização diferem de acordo com o ambiente - Cada cenário (DEV, QA, PROD) usa pontos de extremidade exclusivos.
• Certificados e entradas STRUST são locais - a confiança SSL/TLS deve ser configurada manualmente em cada sistema.
• As atribuições e funções de usuário são dependentes do cliente - Usuários técnicos e autorizações variam entre os sistemas.
• Proteção de dados confidenciais - As credenciais e tokens do OAuth não podem ser transportados para evitar a exposição.

Pré-requisitos

Cada ambiente (DEV, QA, PROD) requer uma configuração manual separada. Certifique-se de executar os seguintes pré-requisitos.

1. Mantenha em segurança a documentação dos pontos de extremidade e das credenciais. Você precisará fornecer o ponto de extremidade de autorização e o ponto de extremidade do token na etapa 5.
2. Ensure the Authorization Endpoint check is running. Go to transaction SICF and execute it. Navigate to :/sap/bc/sec/oauth2. Check that the following node is active: authorize (Authorization Endpoint). If the node is inactive, open the context menu for the node, and select Activate Service.

Figura 4. Verificação de ponto de extremidade de autorização

3. Ensure the Token Endpoint check is running. Go to transaction SICF. Navigate to :/sap/bc/sec/oauth2. Check that the following node is active: token (Token Endpoint). If the node is inactive, open the context menu for the node, and select Activate Service.

4. Observe a convenção de nomenclatura para o Ponto de Extremidade de Autorização. Aqui está um exemplo do ponto de extremidade de autorização: https://vhclashci.dridge.nodomain:44301/sap/bc/sec/oauth2/authorization?sap-client=100

   • Part 1 is the Domain Name - https://vhclashci.dummy.nodomain - Run transaction RZ11 and search for entry ‘icm/host_name_full’ – this value will be the domain name for your entry in the endpoint.
   • Part 2 is the Port Number - 44301 - Run transaction SMICM and select the menu path “Goto->Services”, find the HTTPS protocol and use the number associated with HTTPS.
   • A Parte 3 é a string estática - /sap/bc/sec/oauth2/authorization - Codifique o valor "/sap/bc/sec/oauth2/authorization".
   • A Parte 4 é o cliente do SAP - 100- Insira o cliente do SAP que você está usando no momento.

Etapas

1. Verifique os detalhes e a disponibilidade de sua importação de transporte.

   1. Check that OAuth profiles are available. Use transaction SE80 to ensure OAuth 2.0 Client Profiles are available.

   2. No menu suspenso, selecione Pacote.

   3. Digite "/UIPATH/HEATMAP" na caixa de texto. Os perfis de clientes do OAuth 2.0 devem aparecer no menu suspenso. Se os perfis não estiverem disponíveis, entre em contato com o suporte da UiPath.

Figura 5. Verificar importação de transporte

2. Configurar ID do Cliente/ID do Usuário/Usuário do Sistema e Segredo do Cliente.

   1. For transaction SUO1, contact your Security Team for user creation.

   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. Generate a password according to your company naming standards. The password will become your ‘secret’ in OAuth2 configuration later.

3. Configure SSL/TLS Trust. For transaction STRUST, contact your Basis Team for certificate verification.

4. Crie a configuração do OAuth 2.0.

   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. Select OK.

   5. Configure os campos e salve a configuração:

      • Segredo do cliente: selecione o escopo correspondente (servidor) para cada cliente.
      • URL do endpoint de autorização (consulte a seção Pré-requisitos deste tópico).
      • URL do ponto de extremidade do token (consulte a seção Pré-requisitos deste tópico).
      • Autenticação do cliente: selecione o botão de rádio Básico .
      • Tipo de Concessão selecionado: selecione o botão de opção Credenciais do cliente .
      • Atualizar validade do token: insira -1 na caixa de texto.
      • Tolerância de desalinhamento do relógio: insira 5 na caixa de texto.

   6. Verifique a tela Resumo , que deve parecer com as capturas de tela abaixo.

Figura 6. Página de resumo do OAuth 1

Figura 7. Página de resumo do OAuth 2

5. Configurar Clientes OAuth2 da transação SOAUTH2.

   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 3)
      • Description: Enter the service name or profile name.
      • Token Lifetime: 3600 Seconds

   2. Selecione Avançar e, na segunda tela, insira as seguintes informações:

      • ID e senha do usuário do cliente — verificado
      • Certificado SSL — Verificado
      • Verificar parâmetro: "Client ID" - Verificado

   3. Selecione Avançar e, na terceira tela, insira as seguintes informações:

      • Conceder Credenciais do Cliente Ativas – Verificado

   4. Selecione Avançar e, na quarta tela, insira as seguintes informações:

      • Em OAuth2 Scope Id, localize a primeira linha vazia e selecione na lista suspensa no final da linha em branco.
      • 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. Selecione Resumo. A tela deve ser semelhante ao exemplo abaixo.

Figura 8. Página de resumo do cliente OAuth2

6. Teste a conexão.
   1. Run transaction SE38 and enter the program name ‘/UIPATH/TEST_OAUTH2_SERVICE’.
   2. Selecionar Executar. Uma tela de seleção/parâmetro aparece.
   3. Atualize os parâmetros a seguir para corresponder ao seu sistema/usuário/senha.
      • Porta – Porta HTTPS
      • Cliente - O cliente atual deve ser padrão como uma variável.
      • Segredo – Insira a senha para ID_Cliente/Usuário.
      • Nome do sistema – O Nome do sistema atual deve ser padrão em uma variável.
      • ID do Cliente – Insira o ID do Usuário para os Serviços da UiPath.
   4. Selecionar Executar. Os resultados aparecem na próxima tela. Verifique se o status do serviço é igual a "200".Qualquer outro código de retorno indica um erro.

Figura 9. Teste de conexão

Resultado

O sistema do SAP está configurado com o usuário de comunicação necessário, os serviços ativados e as configurações do OAuth 2.0. O sistema está pronto para estabelecer uma conexão com o Test Manager para o Mapa de Calor e a Análise de Impacto de Alterações.