Page Comparison

...

Introduction

This guide provides colleges with an overview of the Canvas DW Direct Connect implementation process and the preparatory steps required for colleges to successfully access their Canvas API data in the CCC Data Warehouse.

About the CCC Data Warehouse

CCC Data has been developed by the CCC Technology Center in coordination with, and at the direction of, the CCC Chancellor's Office.  

A part of the Data Services Program initiative from the California Community Colleges Chancellor's Office, CCC Data provides the necessary infrastructure to the California Community College System to aggregate data across disparate systems to an enterprise data warehouse (CCC Data Warehouse).

Canvas

...

Data in the CCC Data Warehouse

The CCC Data Warehouse can optionally support the inclusion of Canvas data. When a college (or district) elects to have their Canvas data added to the CCC Data Warehouse, these data can then be accessed through a direct connection (secured through the use of a site-to-site VPN). Colleges must “opt-in” or request access separately, even if they are As Canvas data is managed at a district level, each college in a multi-college district .may need to opt-in for their data to be supported in the DW. Colleges may request to implement this exclusive service (opt-in) by email. Please contact Enabling Services at the CCC Technology Center.

College Participation

The CCC Technology Center (CCCTC) Enabling Services group will support the connection of Canvas data to the Data Warehouse, to be made available through a Direct (ODBC/JDBC) Connection.  Support for Canvas data will require that the administrator for the Canvas system generate a data API key, to be securely passed to the Enabling Services Integration Engineer.by contacting their College Experience Manager (CEM) through CCCTC Enabling Services.

...

College Participation

California Community Colleges that have adopted Canvas CMS may requestto implement the Canvas DW Direct Connect service inclusion of their Canvas data in the CCC Data Warehousethrough Enabling Services at the CCC Technology Center.

Support for Canvas data will require an authorized college Canvas Administrator to generate the Canvas Data API credentials for your account and securely pass them to the Enabling Services Implementation Engineer working with your college.

To get started, colleges must meet the following prerequisites and complete the instructions below.

...

• College has adopted Canvas through the CCC Technology Center (Live).

• College has implemented, or is implementing, DW Direct (ODBVC/JDBC) Connect (Live).

• College has a Canvas Admin user that can generate and provide the required Canvas Data API Key and other required account-related information.

Getting Started

• College must request (opt-in) to participate in having their Canvas data in the Canvas DW Direct Connect serviceCCC Data Warehouse.

• College will participate in the Enabling Services Implementation process, through successful setup and confirmed data access.

...

Implementation Process Overview

1. College requests to participate

...

1. through their College Experience Manager.

2. College generates and submits the required Canvas Data API key values to CCCTC Enabling Services

3. College works with the Enabling Services implementation team to confirm successful access to their Canvas Data using their established direct access connection.

Step 1: Email a Request to Participate

...

As the Canvas Data API key is generated at the root account level, implementation will require each college in a multi-college district to consent to have their Canvas data made available in the CCC Data Warehouse.

1. To participate

...

1. , send an email to Enabling Serviceswith the following subject line: Request for

...

1. their Canvas data be added to the CCC Data Warehouse.

2. The College

...

1. Experience Manager (

...

1. CEM) will process your request and pass your interest to the Enabling Services Implementation team who will work with your college to facilitate the Canvas to Data Warehouse setup process.

Note
Data Security: For security reasons, access to the CCC Data Warehouse must be requested and managed by the Institutional Research, Planning, and Effectiveness (IRPE) lead at each college and district (as authorized by the department VP, when the IRPE lead is not the VP). IRPE requests should be submitted to your CRM CEM at Enabling Services at the CCC Technology Center.

Next Step: Upon receipt of your request, an Implementation Project Manager from Enabling Services will support your Canvas Admin to generate and submit your Canvas API information.

Step 2: Generate Your Canvas API Credentials

In order to access your Canvas data in the CCC Data Warehouse, the Canvas Data 2 API will be used to add your college’s Canvas data to the DW pipeline. This process requires your unique Canvas Data API credentials (API key and secret) in the format that works with the structure of your Canvas account.

To generate your college’s Canvas Data API credentials, follow the steps below. Once the credentials are generated, a copy of the credentials should be captured for security purposes, and safely passed to the CCC Technology Center in a secure manner.

College Canvas Administrator

From the Admin section of your Canvas application:

1. Open Your Account: Click the Admin link in your Canvas application, then click on the name of your account or sub-account.

2. Open Canvas Data Portal: In Account Navigation, click the Canvas Data Portal link.

3. Create API Credentials: Click the Create Credentials button.

...

1. A success notification with your API credentials will display.

...

(Above 4. Copy API Credentials: Once you’ve created your API credentials , a ‘success’ notification box will display your are created, copy the API Key and API Secret values.) and prepare to pass to the Implementation Engineer at the CCC Technology Center.

5. Create New API Credentials: You can create new credentials by clicking the Create Credentials button.

...

Step 3: Configure the Format of Your Canvas API Credentials & Send Them to CCC Technology Center

1. To facilitate the process of adding your Canvas data into the Data Warehouse, provide your API Key and Secret values to your ES Implementation Engineer in the format shown below. These values should be passed using a secure method such as Privnote.
   

   1. Canvas Data API Key: [canvas-datawarehouse-<misCode>-apikey]
      ^{(Replace <misCode> with your college MIS code, and replace “apikey” with your Canvas API key value generated for your specific Instructure account.)}

   2. Canvas Data API Secret: [canvas-datawarehouse-<misCode>-apisecret]
      

...

1. 1. ^{(Replace <misCode> with your college}

...

Once generated, the Canvas Administrator will be provided a screen with their API Key and Secret, as shown below.

Step 3: Copy, Store, and Safely Pass Canvas API Credentials in a Secure Manner

1. Once your Canvas API credentials are generated, store a copy of these credentials in a secure manner for future reference.

2. Provide your API key and secret values to your ES Implementation engineer in the format below. These values should only be passed using a secure method such as Privnote.

   1. Canvas Data API Key: [canvas-datawarehouse-<misCode>-apikey]

   2. Canvas Data API Secret: [canvas-datawarehouse-<misCode>-apisecret]
      

3. Once received, your ES Implementation engineer will initiate the configuration process of adding your Canvas data into the CCC Data Warehouse.

Step 4: Work with Implementation Team to Test Access

...

1. 1. ^{MIS code, and replace “apisecret” with your Canvas API secret value generated for your specific Instructure account.)}
      

2. Upon receipt of your API values, your ES Implementation Engineer will facilitate the process of adding your Canvas data into the CCC Data Warehouse with the CCCTC DevOps team.

Creating New API Credentials: You can create new credentials by clicking the Create Credentials button again.

Creating a New Canvas Admin User

To create a new Canvas Admin user, follow the directions below:

1. To add a user as an admin, you must assign the user to an account role. Before adding a user, ensure that you have created the necessary account-level role.

2. Open the Account: In Global Navigation, click the Admin link, then click the name of the account you want to add a user to.

3. In Account Settings, click the Settings link.  

4. In Settings, click the Admins tab. The Add Admins Account button will display.

5. Click the Add Account Admins button.

6. Add an Account Role and Email.

   1. In the Add More drop-down menu, set the admin role type. The default admin role in Canvas is Account Admin which has access to all account-level permissions. You can also create admin roles for your institution and manage their permissions.  

   2. In the text box, type the email address of the new user.

   3. Click the Continue... button.

   4. Add Account Admins.

      1. Verify the user you added is listed in the admin field.

      2. Select the OK Looks Good, Add this [#] User button to add the admin.

      3. Click the Go back and edit the list of users link to adjust any errors. A message will appear in your browser.

7. Verify the new user administrative user was added.

...

...

Step 4: Work with the ES Implementation Team to Test Access & Query Canvas Data Sets

1. After your Canvas data has been added to the CCC Data Warehouse, the ES Implementation Engineer will guide you to connect to the CCC Data Warehouse through your established DW Direct Connect (ODBC/JDBC) and access your Canvas Data

...

...

1. .

2. Once connected, test connection to your Canvas data to run at least one query against the Canvas Data set.

...

FAQ: Direct Access to Canvas Data in the CCC Data Warehouse

Q. What is the Canvas Data API?

...

Q. Who is authorized to access your Canvas Data API credentials?

A. Any The identified Canvas Data Admin user can generate API credentials for your Canvas account. However, once generated, the credentials are shared between all admin users for that account. If you would like to grant access to other users or third-party partners to download files via the API, you can generate credentials and securely pass them to those users.

...

A. Yes, however to revoke access for a user, the Canvas Admin user will need to regenerate the credentials and securely distribute the credentials again.  

Q. How do I obtain an [Canvas] API access token in the Canvas Data Portal?

...

From the Admin link in the Canvas Data Portal navigation bar:

1. Open Account: Click the Admin link, then click on the name of the Canvas account or sub-account.

2. Open Canvas Data Portal: In Account Navigation, click the Canvas Data Portal link.

3. Create API Credentials: Click the Create Credentials button.

4. Copy API Credentials: Copy the API Key and API Secret. If you return to the Credentials Portal, you will be able to see the API Key but not the API Secret.

5. Create New API Credentials: You can create new credentials by clicking the Create Credentials button.

Q. What Canvas data elements will be available in the CCC Data Warehouse following our college opt-in implementation?

A. The following documentation describes the data dictionary for the Canvas Data warehouse: https://portal.inshosteddata.com/docs