Connect Microsoft services to your OneCampus instance.
Using the Connector tool, OneCampus Administrators can seamlessly connect Microsoft to their OneCampus instance. Once the connection is authorized by the individual end users, their recently modified OneDrive files will get pulled, their Calendar events for the current day and next day, and their latest emails from Outlook.
IMPORTANT: Prior to following the configuration steps below, you will need to register an application in Microsoft Azure, in order to obtain the required values for the configuration. You also need to specify this URL https://{your onecampus domain}/connectors/oauthConnectorCallback as the Redirect URI.
Use the Microsoft Connector
- Begin by clicking the Advanced menu, then click Connectors
- On the Connectors page, click the Configure button next to Microsoft Connector.
- From the Configure Microsoft Connector page, you can determine the status of the Microsoft Connector by switching it on or off. For example, you may leave it off while you are finalizing your configurations and then turn it on when you are ready to go live with your end users. The default status is off.
- Next, begin your configurations by entering your Microsoft Tenant ID, Microsoft Client ID and Microsoft Secret [Required]
- The Microsoft Tenant ID, Microsoft Client ID and Microsoft Secret come from your application within Azure Active Directory. Talk to your Microsoft admin to obtain these. - Indicate what you want the Sections Labels to say. [Required]
- This step controls the text that is displayed in the title of each section that informs the individual end users which section is being viewed
- The default labels are “OneDrive”, “Calendar”, and “Outlook”. - Indicate what you want the Oauth Redirect Modal Title to say. [Required]
- This step controls the text that is displayed in the title of the modal window that informs the individual end users that they need to authorize the Microsoft connection.
- The default oauth redirect modal title is “Authorize OneCampus to Access Microsoft”. - Indicate what you want the Oauth Message to say. [Required]
- This step controls the text that is displayed within the modal window that informs the individual end users that they need to authorize the Microsoft connection.
- The default oauth message is “Microsoft and OneCampus are now connected but you need to authorize the connection. Do you want to authorize the connection?”
Indicate what you want the Oauth Deauthorization Message to say. [Required]
- This step controls the text that is displayed within the deauthorization modal window that informs the individual end users of what they are about to do should they click the deauthorize button located within their options button.
- The default oauth deauthorization message is “Do you want deauthorize the connection? This will remove the Microsoft Connector from the store page but you can re-authorize in the Preferences panel if you change your mind.”- Configure an ACL Expression/s. [Optional]
- Leaving the ACL section empty will allow everyone access to the connector.
- Administrators can add ACL expressions to restrict this connector to specific users. Only those identified users will see the connector authorization modal windows as well as see their data pull through onto the OneCampus main page.
* Select Or from ACL Expression drop down
* Click the green [+] sign
* Select Condition from Expression Type
* Select a unique identifier from the Value dropdown
* In the Is Equal To box, enter the data that matches the Value selected
* Click Add - Click Save. (Once the configurations have been saved, and if the status switch described in step three is turned on, your end users will be presented with the Microsoft Authorization modal window upon their next login)
- You also have options to Cancel or Delete the configurations at this point.
* Clicking cancel before clicking save will discard anything you entered, however, if an existing configuration had been saved previously, that saved configuration will NOT be changed OR discarded.
* Clicking Delete will remove the configurations you have set up and disable the Microsoft Connection.
Notes:
- Once an end user confirms that they want to authorize the Microsoft Connection, they will be presented with a Microsoft login page and an authorization prompt.
* Consenting to the required permissions on this prompt is the final step and will cause their Microsoft data to be pulled on the main OneCampus page, in the Widgets area.
- If an end user inadvertently dismisses the Microsoft Authorization modal window, they can authorize the Microsoft connection by clicking the “Authorize” button that is located within their Preferences section beneath the sign in drop down.
- If an end user clicks the gear icon next to the connector title, they will be presented with options to “Deauthorize” their Microsoft connection, order the sections that are being displayed, and enable/disable sections by clicking on them.
- Only one of the Widgets connectors can be enabled at a time.
- Please refer to the Quick Start Guide for the Connectors Error Log for additional information in regards to connector related errors that your end users might be receiving.
- Please refer to the Quick Start Guide for the Users Report for additional information in regards to how a OneCampus Administrator can deauthorize the Microsoft Connector for a specific user.
Related to
Updated