Broadcast Setup: Portal

Summary

This document provides a walk-through for configuring Kumo Broadcast with supported storage providers and LMS platforms. This process is necessary to enable Kumo Broadcast.

Canvas

This section describes how to add Broadcast to Canvas. Broadcast integrates with Canvas as an LTI application. This allows Canvas course owners to launch Broadcast as an application from within the course. When launched, Canvas will open the Broadcast web app in an iframe, keeping the user within the scope of their course.

Broadcast takes advantage of the Canvas API in order to query roster information for a class. This requires a Canvas API token, which can only be generated by a Canvas administrator at your institution.

1. Identify your Canvas administrator and request a Canvas Access Token.
2. Browse to the Admin > Broadcast section of the portal.
3. Under the Canvas Configuration section
   a. Set the Canvas Instance Domain as the domain name for your Canvas installation b. Set the Canvas Administrative Token as the token provided by your Canvas admin c. Click Save to confirm your changes.

Your canvas admin will now need to add the Broadcast LTI application. To do this they will need the following three pieces of information from you:

1. The LTI Consumer Key, found in the Canvas Configuration section
2. The LTI Shared Secret, also found in the Canvas Configuration section
3. A URL that provides the Broadcast LTI cartridge XML. This URL will be: https:///Broadcast/LTI

This completes the Canvas integration section for Broadcast. If you have any questions, please contact kumo@iu.edu.

OneDrive for Business

Prerequisites

Broadcast requires OneDrive for Business application permissions in order to copy files between users. You must first identify a staff member at your institution that has co-admin privileges for your OneDrive for Business/Office365. They may have these privileges with a user account or a group account. You must temporarily grant this account Kumo Admin privileges so that they can authorize the Broadcast access token to be used with OneDrive for Business.

Please note that this account will not need Kumo administrator privileges forever; we just need it to ‘bootstrap’ the Broadcast feature.

Grant Kumo Admin Permissions to the OneDrive for Business Co-admin Account

1. Browse to the Admin > Administrators section of the Kumo Portal.
2. Add the full UPN of the OneDrive for Business/Office365 co-admin account in the empty text field

Create an OneDrive for Business Application for Broadcast

Please Note: OneDrive for Business refers to Microsoft's enterprise storage service.

Register a OneDrive for Business Application

1. Browse to Azure App registrations page and log in.
2. Under the App registration click on New registration.
3. For Name enter Kumo Broadcast or Kumo Broadcast -.
4. Under Support account types select the Accounts in this organizational directory only (Your University only - Single tenant). Learn more about how to specify who can use the application.
5. Leave the Redirect URI blank, we don't need it for this setup.
6. Click Register to create the application.
7. Under Manage >> API Permissions,
   • Click on Add a permission
   • On Request API Permissions Select Microsoft Graph API under Microsoft APIs
   • Select Application Permissions type. (These permissions required Admin consent)
   • Search for Files and click on Files.ReadWrite.All
   • Search for User and click on User.Read.All
   • Click on Add Permissions
8. Under Manage >> Certificates & secrets, click on New client secret. Give Your Domain Name in the Description and choose Expires time Never.
9. Copy the generated password Value to a text editor -- you'll need it later along with the Tenant ID and *Client ID.
10. (Optional) Under Branding:
    • Upload a new Logo to your school’s logo.
    • You can fill the remaining fields Home page URL, Terms of Services URL, Privacy Statement URL
    • Click Save to update your settings.

Integrate your OneDrive for Business Application with Kumo

11. In a separate tab, browse to the Admin section of Kumo.

12. Under Broadcast select Cloud

13. The credentials for a OneDrive for Business Configuration are composed of three GUIDs: a Tenant ID, a Client (App) ID, and a Client Secret.

14. These values can be retrieved from the app registration in Azure Active Directory.

15. The Configuration should be formatted as a semicolon-separated list of these three values, e.g.: TENANT ID; CLIENT ID; CLIENT SECRET.

16. Turn ON the Enabled.

17. Click Save to update your Kumo settings for Broadcast - Enterprise Cloud Configuration.

Remove Kumo Administrative Privileges from the OneDrive for Business/Office365 Co-admin

1. Browse to the Admin > Administrators section of the Portal.
2. Locate the UPN of the OneDrive for Business/Office365 co-admin account and click Remove.

This completes the OneDrive for Business integration section for Broadcast. If you have any questions, please contact kumo@iu.edu.

Box (obsolete)

Prerequisites

Broadcast requires Box enterprise management permissions in order to copy files between users. You must first identity a staff member at your institution that has co-admin privileges for your Box Enterprise. They may have these privileges with a user account or a group account. You must temporarily grant this account Kumo Admin privileges so that they can authorize the Broadcast access token to be used with Box.

Please note that this account will not need Kumo administrator privileges forever; we just need it to ‘bootstrap’ the Broadcast feature.

Grant Kumo Admin Permissions to the Box Co-admin Account

1. Browse to the Admin > Administrators section of the Kumo Portal.
2. Add the full UPN of the Box co-admin account in the empty text field and click Add.

Create a Box Application for Broadcast

1. Browse to https://box.com/developers/services/edit/
2. Select an application name. We suggest Kumo Broadcast or Kumo Broadcast -
3. Click Box Content and then Create Application to create the application.
4. Click Configure your application to continue.
5. Under General information enter a support email address and the address for Kumo at your school.
6. Under OAuth2 parameters:
   a. Set the redirect_uri to https://YOUR_KUMO_DOMAIN/OAuth2/Authorize/BoxBroadcast
   b. Ensure the following scopes are checked:
   • Read and write all files and folders
   • Manage an enterprise
7. Scroll to the bottom of the screen and click Save Application to finalize your settings.

Integrate your Application with Kumo

1. In a separate tab, browse to the Admin > Broadcast section of the Kumo Portal.
2. Copy the following parameters from the Box OAuth2 parameters to the Kumo Box Configuration:
   a. client_id to API Key
   b. client_secret to API Secret
3. Click Save to update your Kumo settings for Box.
4. You should see an Authorize button appear in the Box Configuration section.

Authorize Kumo with Box Enterprise Privileges

Note: The next four steps must be performed by the Box enterprise co-admin who was previously granted Kumo admin privileges.

1. Browse to the Admin > Broadcast section of the portal.
2. Under Box Configuration click the Authorize button. You will be redirected to Box’s site.
3. Log in to Box with your co-admin account and authorize the Broadcast application to manage enterprise data. You will be redirected back to the Kumo Admin portal.
4. Confirm that the green checkmark appears beside the Box Configuration section header.

Remove Kumo Administrative Privileges from the Box Co-admin

1. Browse to the Admin > Administrators section of the Portal.
2. Locate the UPN of the Box co-admin account and click Remove.

This completes the Box integration section for Broadcast. If you have any questions, please contact kumo@iu.edu.