Adding, Removing & Updating User Permissions

Role Permissions

A user can use the definitions through the Orkestra Revit Addin and view its properties but won't be able to download/open the definition or edit its properties. An admin can edit all Hub and/or Workspace settings and download, open, and edit definitions and their properties.

Getting into the Hub/Workspace Settings

Method 1:

1. Select the Hub in the "Online Workspaces" window

2. Click on . This button will only be enabled if you are the Hub owner/administrator.

Method #2 Right Click

Once in the Hub's settings, you can add and remove which user(s) or Azure Active Directory groups get access to the contents. The list of users and groups and their roles will be displayed here:

Adding users to the Hub or Workspace

1. Click on

2. Please enter the user's email you wish to add (they must have an Orkestra Online account) and specify their role.

Add multiple users to the Hub or Workspace from a .csv file

1. Click on

2. Select the CSV you wish to use. Below is an example of the structure of the coma-delimited CSV.

Adding an Azure Active Directory Group to a Hub or Workspace

Since Orkestra 1.7.2, companies using SSO in Orkestra can leverage their AAD groups. To grant access to a group:

1. Click on

2. Click on :

If you have set up SSO with "Application API Permissions," you can directly pick AAD groups from a list. The level of access is set similarly to regular users (Admin/User access):

If you have set up SSO with "Delegated API Permissions", you'll have to enter the groupID or group Email manually. The level of access is set similarly to regular users (Admin/User access):

The group will appear in the list with a logo that differs from regular Orkestra users:

Remove users from the Hub

1. Select the user in the list in the hub/workspace settings.

2. Click on

By default, the User Settings at the Hub level are inherited by the Workspaces inside the Hub.
However, those settings can be overridden at the Workspace level.

Updating User Permissions

As an admin to a Hub and/or Workspace, you can update the role to a user or AAD group to either an admin or a user.

1. Select the Hub or Workspace.

2. Highlight the user or AAD group.

3. Select the drop-down for the role.

4. Pick the role you wish to apply to the user or AAD group.

Package Settings

In order to synchronize a set of packages with your Hub, you need to : 1. Press the button on the bottom right of the Hub settings window 2. Browse to a folder containing the packages you wish to sync with the Hub

The content of that folder is the Dynamo package folders and must look something like this:

Once the sync if finished, you can see the list of packages and their versions displayed in the Orkestra Hub Settings window:

By default, the Package Settings at Hub level are inherited by the Workspaces 
located inside the Hub. But those settings can be overriden at Workspace level.