Gerenciando aplicativos externos

Esta página contém instruções para administradores de tenant que desejam exibir, adicionar ou editar aplicativos externos que podem acessar recursos da UiPath para o tenant usando o OAuth.

Registered external applications can access your UiPath resources for the current tenant over API, using the OAuth 2.0 flow.

Esta página contém instruções para administradores de tenant que desejam exibir, adicionar ou editar aplicativos externos que podem acessar recursos da UiPath para o tenant usando o OAuth.

Observação:

Você deve ser um Administrador do tenant para realizar as tarefas descritas nesta página.

Adição de um aplicativo externo

Para registrar um aplicativo externo, de forma que ele possa acessar seus recursos da UiPath usando o OAuth:

1. Faça logon no tenant como um Administrador.

2. Go to Tenant > Manage access > Assign roles and select Manage Accounts & Groups.

   The tenant-level Management portal opens.

3. À esquerda, selecione Aplicativos externos.

   A página Aplicativos externos é aberta, listando todos os aplicativos externos existentes registrados para o tenant atual:

   

4. Selecione Adicionar aplicativo.

5. Preencha o campo Application Name.

6. Selecione uma opção para o Tipo de aplicativo.

   Se você selecionar Aplicativo confidencial, receberá um segredo do aplicativo no final, portanto, certifique-se de que seu aplicativo pode armazená-lo com segurança. Se não for possível, selecione Aplicativo não confidencial.

7. Em Recursos, selecione Adicionar escopos.

   O painel Editar recurso será aberto à direita, no qual você pode selecionar os recursos que o aplicativo deve ter acesso.

8. Na lista suspensa Recurso, selecione a API do UiPath que o aplicativo pode usar.

   Observação:

   Você só pode adicionar escopo para um recurso por vez. Se você quiser permitir acesso a vários recursos, repita esse processo para adicionar escopo para cada recurso.

9. Na guia Escopo(s) do usuário, marque as caixas de seleção para as permissões de API lógica que você deseja conceder, conforme necessário.

   A concessão de permissões no escopo do usuário significa que o aplicativo externo pode acessar esses recursos dentro de um contexto de usuário e um usuário com as permissões adequadas deve estar logado.

10. Se esse for um aplicativo confidencial, você pode alternar para a guia Escopo(s) do aplicativo para também conceder permissões de nível de aplicativos para o recurso selecionado, conforme necessário.

    Com permissões sob o escopo do aplicativo, o aplicativo externo tem acesso aos dados de nível de aplicativo dos escopos selecionados sem a necessidade de interação do usuário.

    Os aplicativos não confidenciais não podem acessar o escopo do aplicativo.

11. Selecione Salvar.

    O painel será fechado e o recurso e os escopos selecionados serão adicionados à tabela Recursos no formulário.

12. Se o aplicativo externo puder aceitá-lo, você pode adicionar uma URL no campo Redirecionar URL e a resposta de autorização será enviada para ela. O aplicativo pode usá-la para acessar recursos da UiPath.

13. Selecione Adicionar para criar o registro.

    A confirmation message opens. For confidential applications, the confirmation message includes the app secret that the registered external application can use to request authorization. Make sure you save it in a secure location because you cannot revisit it.

Alteração do escopo de um aplicativo existente

Escopos são as permissões do aplicativo externo em relação a um recurso da UiPath.

1. Faça logon no tenant como um Administrador.

2. Acesse Tenant > Gerenciar acesso > Atribuir funções e clique em Gerenciar contas e grupos.

   The tenant-level Management portal opens.

3. À esquerda, selecione Aplicativos externos.

   A página Aplicativos externos é aberta, listando todos os aplicativos externos existentes registrados para o tenant atual:

4. Clique em à direita da linha do aplicativo.

5. Altere o escopo para o qual o aplicativo tem acesso:

6. Use os ícones à direita de uma linha de recurso para editar o escopo existente ou para excluir o recurso.

7. Clique em Adicionar escopos para adicionar um recurso adicional e selecione escopos para ele.

8. Clique em Salvar.

Geração de um novo segredo do aplicativo

Se você não souber o segredo do aplicativo que foi gerado para um aplicativo externo confidencial, você não poderá recuperá-lo. Mas você pode gerar um novo.

Observação:

Se você gerar um novo segredo do aplicativo, certifique-se de compartilhá-lo com o desenvolvedor que está mantendo a integração com o aplicativo externo. Eles devem atualizar o mecanismo de autenticação; caso contrário, a integração existente não funcionará mais.

Para gerar um novo segredo do aplicativo:

1. Faça logon no tenant como um Administrador.

2. Acesse Tenant > Gerenciar acesso > Atribuir funções e clique em Gerenciar contas e grupos.

   The tenant-level Management portal opens.

3. À esquerda, selecione Aplicativos externos.

   A página Aplicativos externos é aberta, listando todos os aplicativos externos existentes registrados para o tenant atual:

4. Click Edit the right of the application row.

5. Em Segredo do aplicativo, clique em Gerar novo.

   Um novo segredo do aplicativo será gerado e exibido acima do botão. Ele permanecerá visível até você clicar em Cancelar para fechar a página.

6. Copie o segredo do aplicativo e certifique-se de armazená-lo em um local seguro.

Fornecimento de detalhes aos desenvolvedores

Após você registrar um aplicativo externo, um desenvolvedor também deve configurar o aplicativo externo para que ele autentique devidamente, solicite a autorização do UiPath Identity Server e acesse os recursos permitidos da UiPath.

Instructions for the developers maintaining the integration with the external application are available in Accessing UiPath Resources Using External Applications.

Para que os desenvolvedores possam executar essas tarefas, você deve compartilhar as seguintes informações com eles:

• o Tipo de aplicativo e o ID do aplicativo, ambos os quais estão visíveis na página Aplicativos externos

• os escopos adicionados para cada tipo de escopo; para alguns recursos, o mesmo nome é usado sob os escopos de usuário e aplicativo e, por isso, o tipo também é importante

• Se esse for um aplicativo confidencial, o segredo do aplicativo é gerado ao registrar o aplicativo externo.

  Observação:

  If you don't have the secret anymore, generate a new one, as described above on this page.