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.

Detalhes sobre os Serviços SAP

A tabela a seguir descreve os serviços de mapa de calor e sua finalidade.

Serviço	Description
/sap/opu/odata/UIPATH/HEATMAP_AGGREGATES_SRV/AllAggregatesSet	Recupera todos os registros agregados (dados agrupados em menos entradas resumidas). Chama-se esse serviço primeiro para determinar as datas de início e término dos períodos de dados disponíveis, que se passam para FinalHeatmapSet.
/sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet	Recupera todos os transportes dentro de um intervalo de datas especificado, junto com seus detalhes.
/sap/opu/odata/UIPATH/TRANSPORT_LOOKBACK_SRV/TransportLookbackSet	Retorna o número de transportes por mês para o período entre duas datas especificadas.
/sap/opu/odata/UIPATH/S4_CHECK_SRV/S4Info	Verifica se o sistema SAP conectado é o SAP S/4HANA.
/sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet	Recupera as contagens reais de transações para os períodos que AllAggregatesSet retorna, usados para preencher o mapa de calor.

A tabela a seguir descreve os serviços de Análise de Impacto de Alterações e sua finalidade. Esses serviços oferecem suporte à análise e à pesquisa de transportes SAP que as alterações afetam.

Serviço	Description
/sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet	Recupera dados de análise de tabelas personalizadas da UiPath. Esse serviço faz parte da lógica de Análise de Impacto de Alterações do back-end.
/sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportStatusSet	Retorna o status de análise (analisado ou ainda não analisado) de transportes dentro de um intervalo de datas especificado.
/sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis	Analisa transportes dentro de um intervalo de datas especificado e armazena os resultados em tabelas personalizadas da UiPath.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/TransportAnalysisSet	Retorna a análise completa para um transporte especificado, incluindo a lista de usuários impactados. Se você ainda não analisou o transporte, analise-o primeiro e salve os resultados.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet	Retorna a análise completa de um transporte que você especificar.Se você ainda não analisou o transporte, analise-o primeiro e salve os resultados.

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. Certifique-se de que a verificação do ponto de extremidade de autorização esteja em execução. Acesse a transação SICF e execute-a. Navegue até :/sap/bc/sec/oauth2. Verifique se o seguinte nó está ativo: authorize (ponto de extremidade de autorização). Se o nó estiver inativo, abra o menu de contexto para o nó e selecione Ativar serviço.

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

3. Certifique-se de que a verificação do ponto de extremidade do token esteja em execução. Ir para transação SICF. Navegue até :/sap/bc/sec/oauth2. Verifique se o seguinte nó está ativo: token (ponto de extremidade do token). Se o nó estiver inativo, abra o menu de contexto para o nó e selecione Ativar serviço.

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

   • A Parte 1 é o Nome de Domínio - https://vhclashci.dummy.nodomain- Executar transação RZ11 e pesquisar a entrada ‘icm/host_name_full’ – esse valor será o nome de domínio para sua entrada no Ponto de extremidade.
   • A Parte 2 é o Número da Porta - 44301 - Executar transação SMICM e Selecionar o Caminho do Menu “Goto->Services”, Localizar o Protocolo HTTPS e usar o número associado ao 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. Verifique se os perfis do OAuth estão disponíveis. Usar transação SE80 para garantir que os Perfis do Cliente do OAuth 2.0 estejam disponíveis.

   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. Para a transação SUO1, entre em contato com sua Equipe de Segurança para a criação de 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. Gerar uma senha de acordo com os padrões de nomenclatura da sua empresa. A senha se tornará seu "segredo" na configuração do OAuth2 mais tarde.

3. Configure o SSL/TLS Trust. Para transação STRUST, entre em contato com sua equipe do Basis para verificação de certificado.

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

   1. Para transação OA2C_CONFIG, selecione Criar e, no pop-up, selecione o perfil de transporte que você deseja usar. (Você acabará usando todos os perfis listados.)

   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. Para a transação SOAUTH2, selecione Criar e, na primeira tela, insira as seguintes informações:

      • Tipo de cliente: confidencial
      • ID do Cliente: insira o mesmo Nome de Usuário que o acima (etapa 3)
      • Descrição: insira o nome do serviço ou nome do perfil.
      • Vida útil do token: 3600 segundos

   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_ANALYSIS_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/TRANS_CIA_LOOKBACK_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. Execute a transação SE38 e insira o nome do programa "/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.