SharePoint News Widget

The first part of the configuration will be done within SharePoint Online.
Make sure that you are logged in with an admin account so the correct permissions can be granted.

Login to SharePoint Online

• Login to https://www.office.com/?auth=2 and navigate to SharePoint Online
• Make sure you are logged in with your admin account

Create a client ID and Secret

To connect with SharePoint Online we need to register the application.

• Go to the following url using your SharePoint domain:
  https://[NAME].sharepoint.com/_layouts/15/AppRegNew.aspx
  For example: https://gobright.sharepoint.com/_layouts/15/AppRegNew.aspx
• Generate the Client ID and Secret using the ‘Generate‘ button
  
• Fill in the other details:
  
  • Title: GoBright View
  • App Domain: www.gobright.com
  • Redirect URI: https://www.gobright.com/default.aspx
• Save the Client ID & Client Secret

Grant App Permissions

Permission must be granted so the app can get information from SharePoint.

1. Open PowerShell as administrator
2. Copy and paste the code below in a text editor such as Notepad
3. Fill in the $adminUPN and $orgName variables (between the quotation marks)
   The adminUPN is the admin email address
   The orgName is your SharePoint domain, for example: contoso.sharepoint.com (then fill in contoso as the orgName)
4. Copy and paste the code in the PowerShell prompt
5. Run the script

When asked to install the NuGet provider, follow the on screen steps to install the NuGet provider.
When asked to install or update the PowerShell module, follow the on screen steps.

# Install the PowerShell module (this can be skipped when this module is already installed)
Install-Module -Name Microsoft.Online.SharePoint.PowerShell 
# Fill in the organisation name below between the quotation marks
$orgName= ""

# Then run this command to connect to SharePoint, log in as a SharePoint administrator
Connect-SPOService -Url https://$orgName-admin.sharepoint.com

# Then run this command to set the right permission
set-spotenant -DisableCustomAppAuthentication $false

Set permission for the specific site

We’ll need to allow GoBright View to access one or more sites. Note that this process must be repeated for each site that needs to be displayed.

• Go to the following URL using your SharePoint Domain within the [DOMAIN] brackets:
  https://[DOMAIN].sharepoint.com/_layouts/15/appinv.aspx
  For example: https://gobright.sharepoint.com/_layouts/15/appinv.aspx

• To set permissions to specific SITE use the following link:
  https://[DOMAIN].sharepoint.com/sites/[SITE]/_layouts/15/appinv.aspx
  For example: https://gobright.sharepoint.com/sites/news/_layouts/15/appinv.aspx

• Fill in the Client ID that just has been generated within the App ID field
  
  
• Press Search and the created registration should be visible
• Next underneath Permission Request XML copy the following part:
  

  <AppPermissionRequests AllowAppOnlyPolicy="true">
   <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" />
  </AppPermissionRequests>
  

• The app now has the correct permissions. Press the Create button to continue:
  
• Press the Trust it button to finish setting up the permissions
• Repeat these steps for each SITE.
  Fore example: https://gobright.sharepoint.com/sites/news or https://gobright.sharepoint.com/sites/showcase

Get the Tenant ID

The Tenant ID can be found in the Azure portal.

1. Go to https://portal.azure.com/ and log in
2. In the menu on the left, click on Azure Active Directory
   The overview page opens
3. Under Basic information the Tanant ID is displayed and can be copied

That’s all the information we need from SharePoint, now let’s head over to GoBright View.

Add the widget to a template or a slide and fill in all the information that we’ve gathered above in the widget parameters.

If Site Name is left blank it will show information from the main SharePoint page.

After this information is added you should see the information from SharePoint.

If the SharePoint widget suddenly stopped working and/or this error shows up:

It’s very likely that the Client Secret token has expired. This happens every year due to Microsofts policy. We recommend to set a reminder in your calendar to create a new Client ID / Client Secret a month prior, to prevent down time.

How to get a new Client ID and Secret

Because renewing an existing Client is not possible you will have to create a new one and then use those credentials within GoBright View. You just have to update the credentials in the existing slide(s) that contain the SharePoint widget.

This can be done by performing the steps above.