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 acumulados em menos entradas resumidas). Esse serviço é chamado primeiro para determinar as datas de início e término dos períodos de dados disponíveis, que são passados para FinalHeatmapSet.
/sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet	Recupera todos os transportes em 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 é SAP S/4HANA.
/sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet	Recupera as contagens de transações reais para os períodos de data retornados por AllAggregatesSet, usados para preencher o mapa de calor.

A tabela a seguir descreve os serviços da Análise de impacto de alterações e sua finalidade. Esses serviços oferecem suporte à análise e pesquisa de transportes SAP afetados por alterações.

Serviço	Description
/sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet	Recupera dados de análise das tabelas personalizadas da UiPath. Esse serviço faz parte da lógica da Análise de impacto de alterações do back-end.
/sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportStatusSet	Retorna o status da análise (analisado ou ainda não analisado) dos transportes dentro de um intervalo de datas especificado.
/sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis	Analisa os transportes dentro de um intervalo de datas especificado e armazena os resultados nas 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 o transporte ainda não tiver sido analisado, ele será analisado primeiro e os resultados serão salvos.
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet	Retorna a análise completa para um transporte especificado. Se o transporte ainda não tiver sido analisado, ele será analisado primeiro e os resultados serão salvos.

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 (Endpoint 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. Acesse a transação SICF. Navegue para:/sap/bc/sec/oauth2. Verifique se o seguinte nó está ativo: token (TokenEndpoint). 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 do Domínio - https://vhclashci.dummy.nodomain. Execute a transação RZ11 e procure 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 - Execute a transação SMICM e selecione o caminho do menu “Ir para->Serviços”, encontre o protocolo HTTPS e use 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. Use a transação SE80 para garantir que os perfis de 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 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. A senha se tornará seu "segredo" na configuração do OAuth2 posteriormente.

3. Configurar SSL/TLS Trust. Para a transação STRUST, entre em contato com sua equipe de base para verificação de certificados.

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

   1. Para a transação OA2C_CONFIG selecione Criar e, no pop-up, selecione o perfil transportado que você deseja usar. (Em algum momento, você usará 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 acima (etapa 3)
      • Descrição: insira o nome do serviço ou o nome do perfil.
      • Tempo de vida 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_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. 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.