Public Apps

Overview

Warning: In case of entities, it is recommended that you remove the Everyone Group to eliminate unintentional data access for public apps.

You can use UiPath Apps to create apps that are available to users outside of Automation Cloud^TM.

This opens up new opportunities for your app, such as:

• Creating a timesheet for your employees.
• Creating a form where users can submit their taxes reports and process them using Document Understanding.
• Creating a form to reset a passwords or change the address.
• Retrieve data from a legacy system.
• Creating a form where users can submit feedback.

The following rate limits apply for public apps:

• Number of GET requests allowed in a 5 minute period per IP: 1000
• Number of POST requests allowed in a 5 minute period per IP: 1000
• Number of GET requests allowed in a 5 minute period per Organization: 1000
• Number of POST requests allowed in a 5 minute period per Organization: 15000

  All other HTTP methods have lower limits but with minimal impact as they are used occasionally.

Note: Because public apps are accessible to anyone with the URL, make sure that your app never collects or retrieves sensitive data such as Social Security Number, billing information, and so on.

Prerequisites

You need the Organization Admin role to create a public facing app.

Note:

Users on Enterprise license plans need Apps Units to create public apps.

Steps

Building the App

Use the following steps in UiPath Apps to create and publish your external app:

1. Go to the UiPath Apps homepage and create a new app.
2. In the app creation dialog, mark the Public App checkbox.
   
   

   

   
   
   Note:

   You can also make an existing app public from the Manage access tab.

   

3. Build your desired app.

4. Publish the app.

5. Deploy the app to an Orchestrator folder:

   1. Go to Automations > Apps.

   2. From the App dropdown, select the app to deploy.

   3. From the Version dropdown, select the specific app version you want to deploy.

   4. Optionally, enter a Display name or a Description for your app.

   5. Click Deploy.

   More details here ...

Note: A published public app contains public in the Production URL.

Note:

Public apps created using UiPath Apps are displayed as external applications in the Admin > External Applications > OAuth Apps page. Identify these apps by the UiPath-Apps prefix.

Setting up the external app

To configure the public app as an external app:

1. Assign the proper roles for your external app at both tenant and folder levels. To identify the desired app, look for the UiPath-Apps prefix, and create new roles with the following permissions:

   Resource	Permissions to set at tenant level	Permissions to set at folder level (*)
   Webhooks	View, Create	x
   Jobs	x	Create
   Storage files	x	View, Create
   Storage buckets	x	View
   Queues	x	View
   Transactions	x	Create

   (*) Folder roles must be assigned in the folder where the public app was deployed.

   
2. If you have Read rights for Data Service component, public apps works by default with Data Service. If you need Write permission, Data.Writer permission needs to be provided for the public app. For more information on Data Service components, check the Managing access page from the Data Service guide.

   Note: When using entities with public apps, make sure to provide only the relevant permissions in Data Service. A good way to do that is to create a specific role and provide specific permissions that are needed. Avoid using Read permissions for entities that have information that should not be exposed externally.

   Grant View and Edit permissions for an entity only if you are comfortable with all users of that app accessing the data in that entity.

3. Add your external app to both a tenant and a folder.

Note: If you want to configure the scope for the external app, check the Accessing UiPath resources using external applications page from the Automation Cloud guide

To validate that your external app has the proper roles:

1. Go to Orchestrator > Tenant > Manage Access.

2. Identify your app in the list by searching after the UiPath-Apps prefix.

3. For the desired app, click More Actions, then select Check roles & permissions.

4. Unfold the roles to see and validate the assigned permissions.