Aplicativos públicos

Visão geral

Você pode usar o UiPath Apps para criar aplicativos que ficam disponíveis para usuários fora do Automation Cloud^TM.

Isso abre novas oportunidades para seu aplicativo, como:

• Criação de uma planilha de horas para fornecedores externos.
• Criando um formulário onde os usuários podem enviar seus relatórios de impostos e processá-los usando o Document Understanding.
• Criando um formulário para redefinir senhas ou alterar o endereço.
• Recupere dados de um sistema legado.
• Criando um formulário onde os usuários podem enviar feedback.

AVISO:

• Os aplicativos públicos operam de forma anônima, sem um fluxo de autenticação. Como tal, os aplicativos públicos não são compatíveis com funcionalidades relacionadas ao status ou dados do usuário atual.
• No caso de entidades, é recomendável que você remova o Grupo Todos para eliminar o acesso não intencional a dados para aplicativos públicos.

Os seguintes limites de taxa se aplicam a aplicativos públicos:

• Número de solicitações GET permitidas em um período de 5 minutos por IP: 1000
• Número de solicitações POST permitidas em um período de 5 minutos por IP: 1000
• Número de solicitações de GET permitidas em um período de cinco minutos por organização: 1000
• Número de solicitações de POST permitidas em um período de cinco minutos por organização: 15000

  Todos os outros métodos HTTP têm limites mais baixos, mas com impacto mínimo, pois são usados ocasionalmente.

Observação: como os aplicativos públicos podem ser acessados por qualquer pessoa com o URL, certifique-se de que seu aplicativo nunca colete ou recupere dados confidenciais, como CPF, informações de cobrança e assim por diante.

Pré-requisitos

Você precisa da função Administrador da organização para criar um aplicativo voltado ao público.

Observação:

• Os usuários em planos de licença Enterprise precisam de Apps Units para criar aplicativos públicos.
• Para que quaisquer alterações de licenciamento entrem em vigor, os usuários devem fazer logout e fazer o login novamente.

Etapas

Criação do aplicativo

Use as seguintes etapas em UiPath Apps para criar e publicar seu aplicativo externo:

1. Acesse a página inicial do UiPath Apps e crie um novo aplicativo.
2. Na caixa de diálogo de criação do aplicativo, marque a caixa de seleção Aplicativo público .
   
   

   

   
   
   Observação:

   Você também pode tornar um aplicativo existente público na guia Gerenciar acesso .

   

3. Crie o aplicativo desejado.

4. Publique o Aplicativo.

5. Implante o aplicativo em uma pasta do Orchestrator:

   1. Vá para Automações > Apps.

   2. No menu suspenso App, selecione o aplicativo a implantar.

   3. No menu suspenso Versão, selecione a versão do aplicativo específico que você deseja implantar.

   4. Se desejar, insira um Nome de exibição ou uma Descrição para seu aplicativo.

   5. Clique em Implantar.

   Mais detalhes aqui ...

Observação: um aplicativo público publicado contém public no URL de produção.

Observação:

Aplicativos públicos criados usando o UiPath Apps são exibidos como aplicativos externos na página Admin > Aplicativos externos > Aplicativos OAuth. Esses aplicativos são identificáveis pelo prefixo UiPath-Apps.

Setting up the external app

Para configurar o aplicativo público como um aplicativo externo:

1. Atribua as funções adequadas para seu aplicativo externo nos níveis de tenant e de pasta. Para identificar o aplicativo desejado, procure o prefixo UiPath-Apps e crie novas funções com as seguintes permissões:

   Recurso	Permissões para definir no nível de tenant	Permissões para definir no nível de pasta (*)
   Webhooks	Visualizar, Criar	X
   Trabalhos	X	Criar
   Armazenar Arquivos	X	Visualizar, Criar
   Armazenar buckets	X	Exibir
   Filas	X	Exibir
   Transações	X	Criar

   (*) As funções de pasta devem ser atribuídas na pasta na qual o aplicativo público foi implantado.

   
2. Se você tiver direitos de Read para o componente do Data Service, os aplicativos públicos funcionarão por padrão com o Data Service.

   Observação: para um controle de acesso mais granular, incluindo funções e permissões, consulte a página Gerenciamento de acesso do guia do Data Service .

   Ao usar entidades com aplicativos públicos, certifique-se de fornecer apenas as permissões relevantes no Data Service. Uma boa maneira de fazer isso é criar uma função específica e fornecer as permissões específicas necessárias. Evite usar permissões Read para entidades cujas informações não devem ser expostas externamente.

   Conceda permissões View e Edit para uma entidade apenas se você estiver confortável com todos os usuários desse aplicativo acessar os dados nessa entidade.

3. Adicione seu aplicativo externo a um locatário e a uma pasta.

Observação: se você quiser configurar o escopo para o aplicativo externo, verifique a página Acesso a recursos da UiPath usando aplicativos externos no guia do Automation Cloud^TM .

Para validar se seu aplicativo externo tem as funções adequadas:

1. Acesse Orchestrator > Tenant > Gerenciar acesso.

2. Identifique seu aplicativo na lista atentando-se ao prefixo UiPath-Apps.

3. Para o aplicativo desejado, clique em Mais ações e selecione Verificar funções e permissões.

4. Expanda as funções para ver e validar as permissões atribuídas.

   

Aplicativos públicos em soluções

Você pode empacotar e implantar aplicativos públicos como parte das soluções de Compilação Unificada.

Habilitação de aplicativos públicos

Para habilitar aplicativos públicos, prossiga da seguinte maneira:

1. Abra a solução no Studio Web.
2. No explorador de soluções, clique com o botão direito do mouse no nó do aplicativo que você deseja tornar público.
3. Selecione Propriedades no menu de contexto.
4. No painel Propriedades , marque a caixa de seleção Aplicativo público para marcar o aplicativo como público.
5. Publique e implante a solução.
   
   
   
   

Atribuição de permissões de aplicativos públicos após a implantação da solução

Para atribuir permissões a um aplicativo público depois de implantar sua solução, proceda da seguinte forma:

1. Navegue até a pasta da solução.
2. Atribua as permissões necessárias ao aplicativo público com base nos recursos que ele usa. Por exemplo, se o aplicativo usar um bucket de armazenamento, você deve conceder as permissões do Bucket de armazenamento e do Arquivo de armazenamento .

Para obter mais detalhes sobre como atribuir permissões a um aplicativo público, consulte Aplicativos públicos.

Observação: você pode acessar as credenciais de aplicativos externos no menu de reticências ⋮ do aplicativo público implantado. Essas credenciais são necessárias quando você atribui permissões ao aplicativo externo. Use os IDs do cliente de aplicativos externos para pesquisar e identificá-los.

Verificação do aplicativo público

Para verificar o aplicativo público, execute o aplicativo após atribuir as permissões. O aplicativo deve ser executado conforme o esperado.

O URL de produção incluirá /public/, indicando que o aplicativo está acessível publicamente.

Observação: se você encontrar erros ao executar o aplicativo, certifique-se de que o aplicativo público tenha a permissão Jobs.Create configurada. Embora essa permissão seja atribuída automaticamente por padrão, a atribuição pode falhar ocasionalmente.

Práticas recomendadas para usar aplicativos públicos

Public Apps é um poderoso recurso do UiPath que permite que os clientes exponham suas automações para usuários fora de sua organização. Para garantir a segurança, privacidade e desempenho ideal desses aplicativos, é essencial seguir as práticas recomendadas descritas abaixo:

O que fazer

• Revise permissões e controles de acesso: inspecione cuidadosamente as permissões e os controles de acesso de todas as dependências das quais seu Aplicativo Público depende.

• Siga o princípio do menor privilégio (PoLP): conceda o conjunto mínimo de permissões necessárias para que seu aplicativo público funcione corretamente. Isso reduz o risco de acesso não autorizado e violações de dados.

• Validar a entrada do usuário: implemente a validação de entrada adequada para proteger seu aplicativo de dados maliciosos e garantir que ele processe as informações com segurança.

• Realize auditorias de segurança regularmente: audite e atualize periodicamente os controles de acesso e permissões de seu Aplicativo Público para mantê-los em conformidade com as políticas de segurança e privacidade de sua organização.

• Forneça instruções claras: faça da experiência do usuário uma prioridade, oferecendo instruções claras, concisas e úteis sobre como usar seu Aplicativo Público de forma eficaz.

• Implementar gerenciamento de erros: crie seu Aplicativo Público para lidar corretamente com os erros e proteger dados confidenciais em caso de problemas inesperados.

• Monitorar atividade: revise regularmente a atividade de usuários anônimos e o desempenho do aplicativo para identificar possíveis ameaças de segurança e facilitar a resposta a incidentes.

• Seguir práticas de codificação seguras: siga os padrões de codificação e as melhores práticas estabelecidas para minimizar o risco de vulnerabilidades de segurança em seu aplicativo público.

O que não fazer

• Não armazene dados confidenciais: não armazene informações confidenciais do usuário, como números de CPF, detalhes de cobrança ou quaisquer outros dados confidenciais no Data Service.

• Não conceda acesso excessivo: não forneça uma permissão de Leitura de Aplicativo Público a uma entidade, a menos que você queira que todos os usuários do aplicativo acessem todos os dados contidos nela.

• Não dependa só de filtros de consulta: o uso de filtros de consulta com o Data Service não garante a segurança ou a privacidade do nível de registro.

  Observação: para um controle de acesso mais granular, incluindo funções e permissões, consulte a página Gerenciamento de acesso do guia do Data Service .

• Não exponha informações confidenciais em mensagens de erro: certifique-se de que as mensagens de erro nunca revelem dados confidenciais ou forneçam dicas que possam ser exploradas por invasores em potencial. Mantenha as mensagens de erro seguras e genéricas.

• Não use credenciais codificadas: evite incorporar credenciais confidenciais ou chaves de API diretamente no código do aplicativo. Em vez disso, opte por métodos seguros de armazenamento e recuperação desses valores.

• Não se esqueça dos testes: antes da implantação, teste minuciosamente seu Aplicativo Público quanto a vulnerabilidades de segurança, funcionalidade e desempenho. Certifique-se de que ele atenda aos mais altos padrões de segurança para proteger seus usuários e seu aplicativo.

Ignorando restrições de IP para aplicativos públicos

Os administradores podem adicionar aplicativos públicos específicos à lista Aplicativos públicos confiáveis na Automation Cloud para ignorar restrições de IP.

Quando os administradores adicionam um aplicativo público à lista confiável, os usuários podem acessá-lo mesmo que estejam fora dos intervalos de IPs confiáveis.

Para obter mais detalhes sobre como inserir aplicativos públicos na lista de permissões, consulte Aplicativos públicos confiáveis.

Observação: ainda não há suporte para ignorar a restrição de IP para aplicativos públicos com URL personalizado.