Configuring fine-grained access for external apps

Overview

Organization-level app scopes give access to resources across all tenants and folders in the organizaton.

As an administrator, you can configure fine-grained tenant or folder permissions for confidential apps, by assigning them to folders or tenants in Orchestrator. An external app gets the permissions required to perform particular operations in a folder or tenant through one or more roles.

An app gets the union of all organization and tenant scopes defined for it.

For example, Finance and HR are the two tenants in your organization. Your external app has the OR.Machines.Read scope at the organization level, and View permissions on Folders in the Finance tenant, and nothing defined for the HR tenant in Orchestrator. Here's an overview of your app's scope and what it can access:

Tenant	Scope
HR	OR.Machines.Read
Finance	OR.Machines.Read OR.Folders.Read

Deleting either of these scopes leaves the app with access levels according to the remaining scope.

You can use groups to simplify external app management, as groups allow you to manage objects with similar needs together.

Note:

External apps need to be assigned directly to a specific tenant and folder, instead of using group assignments.

Adding External Apps to a Tenant

To grant access to a tenant for an external app or a group of external apps, follow these steps in Orchestrator:

1. Go to Tenant > Manage Access. The Manage Access page is displayed.
2. Click Assign roles > External app. The Assign roles to an external app window is displayed.
   
   

   

   
   
3. In the Search for an external app drop-down, search for the object you want to add.
4. Under Roles, select the role(s) for this object.
5. Click Assign.

Assigning External Apps to a Folder

To grant access to a folder for an external app or a group of external apps, follow these steps in Orchestrator:

1. Go to Tenant > Folders. The Folders page is displayed.
2. From the Folders page, in the Manage Folders pane, click the folder you want to manage. The folder and its contents are displayed on the right-hand dashboard.
3. Click Assign Accounts/Group. The Assign Account/Group window is displayed.
   
   

   

   
   
4. In the Account, group, or external app drop-down, search for the object you want to add.
5. Under The Roles for the account/group selected above, select the role(s) for this object.
6. Click Assign. The selected object is now in the folder and can access it according to its role.

Removing Assignments

Removing External Apps From a Tenant

To remove tenant access for an external app or a group of external apps, follow these steps in Orchestrator:

1. Go to Tenant > Manage Access. The Manage Access page is displayed.
2. Click More Actions > Remove for the object you want to remove from the tenant and any other folders where it's been explicitly assigned. A confirmation window is displayed.
   
   

   

   
   
3. Click Yes to confirm. The removed app is removed from the tenant.

Unassigning External Apps From a Folder

To remove folder access for an external app or a group of external apps, follow these steps in Orchestrator:

1. Go to Tenant > Folders. The Folders page is displayed.
2. From the Folders page, in the Manage Folders pane, click the folder you want to manage. The folder and its external apps are displayed on the right-hand dashboard.
   
   

   

   
   
3. Click More Actions > Unassign for the object you want to remove from the folder. A confirmation window is displayed.
4. Click Yes to confirm. The object is unassigned from the folder.

Checking External Apps Assignments

To see all the assignments of an external app or external app group in a tenant, follow these steps in Orchestrator:

1. Go to Tenant > Manage Access in the tenant where you want to check the app assignments. The Manage Access page is displayed.
2. Click More Actions > Check roles and permissions for the object you want to check assignments for. The Check Roles window is displayed showing a list of all the folders and roles for the object, and whether the object has been granted any access to the tenant.