Applies To: SharePoint Online
Pre-requisites:
User Permissions
- User doing the installation requires tenant admin rights on the SharePoint online tenancy where NITRO Studio is being installed
- Note: If NITRO Studio is already installed in any other site collection in your tenancy then user with site collection administrator permissions can perform the installation. In this case tenant admin permissions are not required
Permissions Required for different API’s:
| Crow Canyon Authentication API | Basic permissions only – User.Read, OpenId profile |
| Normal user can grant for himself | |
| Admin can grant for organization | |
| This is required to login to new NITRO entry page – crowcanyonnitro.azurewebsites.net | |
| Azure AD API (Read) | Directory/Group/Group Member/User – Read permissions |
| If not granted, NITRO will not be able to read AD and AD groups related functionality is not supported. | |
| Azure AD API | Directory/Group/Group Member/User – Read and Write permissions |
| Optional if any AD write operations are required, otherwise use Read API | |
| Crow Canyon Advanced Approval / NITRO API / NITRO Workflows / Product App | Full control on all SharePoint site collections – Using Graph and CSOM |
| Term store and user read permissions | |
| Crow Canyon Email API | Mail read/write/send permissions on all mailboxes. This is restricted to specific mailboxes with an additional step using PowerShell. |
| Crow Canyon Calendar API | Calendar read/write/send permissions on all mailboxes. This is restricted to specific mailboxes with an additional step using PowerShell. |
| Optional: Required for workflow action to create meetings | |
| Crow Canyon Teams API | Group read/write. |
| Optional: Required for workflow action to create Teams/Channels |
Site Collection
- To install NITRO Studio in a new site collection, tenant administrator can create a new site collection
- Or installation can be done in an existing site collection
Note:
1. Enable custom script in app catalog site collection and the site collection in which NITRO is being installed.
2. Use the powershell to set tenant level flag to not disable custom script (see last step in below article)
please refer this article How to enable scripting capabilities with PowerShell – Crow Canyon Software Support to enable custom script.
Access Control
- If “Allow access from specific IP Address locations” is enabled in Access Control for the tenancy, please refer this article https://www.crowcanyon.help/article/397/#Symptom2 and allow the IP Addresses.
Description:
This article describes the steps to install Modern NITRO Studio in a Site Collection.
Detailed Steps to Install Modern NITRO Studio:
Step 1: Open the link below in the tenant you want to install Modern NITRO Studio.
https://crowcanyonnitro.azurewebsites.net
It will ask for login details, use your 0365 account to log in.
Note: The user needs admin rights to Grant permissions and install Modern NITRO Studio.
The below page will open. Here, you can grant permissions by clicking the ‘Grant Permissions’ button.
After clicking ‘Grant Permissions’ below window will pop up
Click ‘Accept’ to grant permissions.
Step 2: After granting all permissions, Install Modern NITRO Studio in required site collection.
Note: All site collections of tenant will be shown here.
After clicking ‘Install’, click ‘Ok’ to start the installation.
Once the Installation is completed, ‘Manage’ link will be shown beside Site Collection.
Clicking ‘Manage’ will navigate you to the NITRO Studio page of that Site Collection as shown below
‘Crow Canyon NITRO Studio’ link will be available in the ‘Site Settings’ of Site Collection:
‘Crow Canyon NITRO Studio’ link will also be available in the ‘gear’ icon as shown below:
Click the ‘Activate’ button to activate NITRO apps.
Select ‘License Type’ and click ‘Ok’ in opened window.
After NITRO Apps activation, the “Crow Canyon NITRO Apps’ and “Crow Canyon Branding’ links will be available in ‘Quick launch’ and also under ‘Site Administration’ of ‘Site Settings’.
Site Settings:
Crow Canyon NITRO Apps page:
Note: In Modern NITRO Studio, ‘ID Column’ app will not be available. You can configure the ‘ID Column’ functionality using NITRO Workflows. The rest of the app’s functionality will be the same as the Classic NITRO Studio.
- In Classic, NITRO Studio pages are hosted in an Azure site outside of the SharePoint tenancy. In modern, it is hosted within the SharePoint site collection as SPFx components.
observe the difference between Classic and Modern Nitro Studio URL as shown below
Classic NITRO Studio URL:
Modern NITRO Studio URL:
Detailed Steps to Upgrade Classic NITRO Studio to Modern NITRO Studio
Step 1: Open the link below in the tenant you want to upgrade Classic NITRO Studio to Modern NITRO Studio.
https://crowcanyonnitro.azurewebsites.net
Step 2: To upgrade Classic NITRO Studio to Modern NITRO Studio, Click the ‘Upgrade’ button as shown in the below image. This upgrade button will navigate you to the page where all the site collection that needs upgrades will be shown.
After clicking the ‘Upgrade’ button below page will open. Here, grant permission for the ‘Product app’. Select Site Collection where Classic NITRO Studio is installed, and click upgrade button to switch to Modern NITRO Studio
Note:
- User needs admin rights to grant permissions.
- Grant ‘Product App’ permissions if you are using the Crow Canyon Helpdesk / Request management application.
- Product app Permissions are showing on the Upgrade page and also on the NITRO Application page
‘Site contents’ page of Classic NITRO Studio will show below highlighted links
After clicking ‘Upgrade’ below shown window will pop up. Click ‘Ok’ to upgrade.
Note: After the successful upgrade, the above highlighted links in ‘Site contents’ will not be shown except ‘Crow Canyon NITRO Studio’ and ‘Crow Canyon NITRO Portal’. The user needs to manually remove these links from ‘Site Contents’.
Steps to remove ‘Crow Canyon NITRO Studio’ and ‘Crow Canyon NITRO Portal’ from Site contents:
Step 1: Go to Site contents -> Click ‘Return to Classic SharePoint’ on the left side bottom
Step 2: Select the app that you want to remove, click three dots on the selected app then click ‘Remove’ as shown below
Step 3: A pop-up window will display the message for app removal confirmation, click ‘Ok’ to remove the app.
Similarly, follow the above steps to remove ‘Crow Canyon NITRO Studio’ from ‘Site Contents’.
