Canvas Admin Setup Guide

How to enable StudentHub for your institution

Time Required: ~10 minutes

Prerequisites

Canvas Admin access (Account Admin role)
Access to Admin > Developer Keys

Step 1: Create a Developer Key

1. Log in to Canvas as an Admin
2. Navigate to Admin > Developer Keys
3. Click + Developer Key > API Key

Fill in the following fields:

Field	Value
Key Name	`StudentHub`
Owner Email	Your admin email
Redirect URIs	`https://app.student-hub.net/api/lms/canvas/oauth/callback`
Redirect URI (Legacy)	Leave blank
Enforce Scopes	See Step 2
Notes	Optional: "Student assignment tracking dashboard"

For Local/Staging Testing

If you need to test with a local or staging environment, add additional redirect URIs:

https://app.student-hub.net/api/lms/canvas/oauth/callback
http://localhost:3001/api/lms/canvas/oauth/callback

Step 2: Configure Scopes (Recommended)

For production deployments, we recommend enabling Enforce Scopes with minimal permissions.

Required Scopes

Click Enforce Scopes and enable these scopes:

Scope	Purpose
`url:GET\|/api/v1/users/:user_id/profile`	Verify user identity
`url:GET\|/api/v1/courses`	List enrolled courses
`url:GET\|/api/v1/courses/:course_id/assignments`	List course assignments

Alternative: Disable Scope Enforcement

If you prefer not to manage individual scopes, you can leave Enforce Scopes OFF. StudentHub only calls the read-only endpoints listed above regardless of what's permitted.

Step 3: Enable the Developer Key

1. After saving, find your new Developer Key in the list
2. Click the State toggle to change from "Off" to "On"
3. Note the Client ID (a long number like 10000000000001)

Note: The Client Secret is shown only once when you create the key. If you didn't copy it, you'll need to regenerate it.

Step 4: Share Credentials with StudentHub

For institutional deployments, contact StudentHub to configure your instance:

Email: contact@student-hub.net
Include:
- - Your Canvas URL (e.g., https://canvas.yourschool.edu)
- - Developer Key Client ID
- - Developer Key Client Secret (send securely)

For self-service student use, no additional configuration is needed. Students will use the global StudentHub developer key.

Step 5: Test the Connection

As a Student:

1. Go to StudentHub and log in
2. Navigate to Settings > LMS Integration
3. Enter your Canvas URL (e.g., canvas.yourschool.edu)
4. Click Connect Canvas
5. Authorize on the Canvas consent screen
6. Verify assignments appear in the dashboard

As an Admin:

You can view active integrations in Canvas under Admin > Settings > Apps.

Troubleshooting

"Your school needs to approve StudentHub first"

Cause: Developer Key is not enabled (State = Off)

Fix: Enable the Developer Key in Admin > Developer Keys

"redirect_uri does not match client settings"

Cause: Redirect URI mismatch

Fix: Ensure the redirect URI exactly matches:https://app.student-hub.net/api/lms/canvas/oauth/callback

"Invalid Canvas URL"

Cause: URL blocked by security checks

Fix: Ensure the URL is your public Canvas hostname (not localhost or internal IP)

"Session expired"

Cause: OAuth state expired (10-minute timeout) or session lost

Fix: Have the user try connecting again

Students can't see the authorization screen

Cause: Canvas may auto-approve if the user previously authorized

Fix: This is normal behavior. The connection should still complete.

Security Notes

What StudentHub Can Access

- User profile (ID, name)
- Course list (names, codes)
- Assignment metadata (titles, due dates, submission status)

What StudentHub Cannot Access

- Student grades
- File submissions
- Quiz answers
- Discussion posts
- Messages

Token Security

- All OAuth tokens are encrypted at rest (AES-256-GCM)
- Tokens are revoked when students disconnect
- StudentHub never stores tokens in plain text or logs

Removing StudentHub

For Students:

1. In StudentHub: Settings > LMS Integration > Disconnect
2. In Canvas: Account > Settings > Approved Integrations > Remove StudentHub

For Admins (Institution-wide):

1. Navigate to Admin > Developer Keys
2. Find the StudentHub key
3. Click the State toggle to "Off" or delete the key
4. Existing student connections will stop working

Contact & Support

Contact: contact@student-hub.net

Last updated: February 2026

Assignments

Loading assignments…

This may take a moment.