Before you can use ClassCube with Canvas you need to tell Canvas how to talk with ClassCube.
Key and Secret
First step is to create a key and secret inside ClassCube that you’ll use to allow Canvas and ClassCube to communicate securely. It’s a fairly easy process, but one that’s used for more than just Canvas so we’ve got a separate document on how to create keys in ClassCube. Before we go any farther, go ahead and follow the instructions there to create a domain key for you to use with Canvas.
Adding the App
Canvas calls LTI providers Apps. And it’s likely that you already have other apps setup for Canvas. There are tons of apps out there to make Canvas a better tool for you and your students.
To add ClassCube as an app to your course click on the Settings menu. It’s typically at the bottom of the course menu. Once there you should see an Apps tab. Click that and the screen should look like the following.
You may have other apps listed here. But we’re going to add a new one, so click on the blue Add App button with the plus on the top right of the screen. This will pop up a dialog that looks like the following.
When it comes up the choice under Configuration Type will probably be Manual Entry. Go ahead and change it to By URL. That’ll make it much easier to get everything setup.
You’ll have to fill out each of the form fields for ClassCube and Canvas to be able to talk.
|Configuration Type||Leave this at By URL. It lets you enter a URL on our site to pull configuration information instead of having to enter it manually.|
|Name||This is the name that’s going to be used for the external tool when you create assignments. We’d suggest ClassCube, although you can really type in pretty much whatever you want here.|
|Consumder Key & Secret||This is where you paste in the user key and secret that you created on our site for the first step above. It’s important that you get these correct. If not, Canvas and ClassCube won’t be able to talk.|
|Config URL||This is the URL of an XML file on our server that contains all of the configuration settings. Enter
Go ahead and press Submit. Your Canvas server will contact our server and get the rest of the information it needs.
Once that’s done you should see the same settings page as before but with the app you just added on the list.
We’ve got one more thing to check. When Canvas sends your student to ClassCube a bit of data goes with them, and that optionally can include their name and email address.
We suggest at least sending their name, although both name and email would be better.
The reason for this is because for ClassCube to work it has to create an account that’s linked to the student’s Canvas account. When that account is created ClassCube will use the name and email address information from Canvas if it’s available. If not, a random email address and name are used instead so that there’s something there. The problem for you is that if this random name is created that’s also what you’ll see when you view submissions. If you let Canvas send your students’ names then the accounts will be created with their names and that’s what you see in reports.
To check the privacy settings, click on the small gear icon on the right of the app you just created and then click on Edit.
Most of the settings are either ones that you’ve already entered or came from our server. About halfway down on the right is a Privacy drop down.
|Public||Name and email are sent. This is our recommendation.|
|Name Only||Only the name is sent.|
|Email Only||Only the email address is sent.|
|Anonymous||Neither name nor email is sent. This will cause ClassCube to create a user with totally random information. It’ll still work. It will just be more difficult for you to look at your students’ work.|
Click Submit and you’re done. You’re all ready to use ClassCube and Canvas together.