Community

In some cases an institution using Canvas may have users who authenticate to Canvas using more than one authentication mechanism each using a different page for the collection of authentication credentials (usernames and passwords usually). For example an institution may have a SAML IdP configured for the bulk of their users (ex: students and teachers), but are using Canvas authentication for another type of users (ex: Parents of K-12 students or guest lecturers). Another example may be users from different institutions who login to the same Canvas instance using two different SAML IdPs. When situations like this occur it is necessary for users to be given a special login URL to login to Canvas, so that Canvas can present or redirect the user to the appropriate login page. This can be confusing to users because if they go directly to a Canvas URL and they are not logged in to Canvas they will be presented with the login page for the first authentication provider in your Authentication settings configuration list which may not be the correct login page for that user. The solution to this challenge is to add a "Discovery URL" to your Authentication settings page in Canvas. Once configured, users who are not already logged in to Canvas will be redirected to the URL in the "Discovery URL" field unless the Canvas web address they are attempting to visit is a specific login URL. This allows a Canvas admin to provide a location that displays links to the appropriate Canvas login URLs for various types of users. PRO-TIP: The links to the specific Canvas login URLs are the only important component of this web page and they must be in a specific format (keep reading for more). As such, a best practice is to make the links very prominent on the page. How do I know how to craft a Canvas Login URL? I'm glad you asked!  There are two ways the URLs may need to be formatted. If you have only one authentication provider of a specific type (SAML,LDAP, etc) then the URL will be in the following format: https://[canvas_URL]/login/[type] [canvas_URL] = Your Canvas address. Example: school.instructure.com [type] = The type of authentication. This information is available within the "Authentication Settings" page after you add the authentication provider in Canvas. Here are some examples of how this information appears in Canvas: Single SAML Configuration in Canvas (/login/SAML): Canvas authentication example in Canvas (/login/canvas): If you have more than one of the same authentication type (ex: 2 different SAML IdP configurations): https://[canvas_URL]/login/[type]/[id] [canvas_URL] = Your Canvas address. Example: school.instructure.com [type] = The type of authentication. This information is available within the "Authentication Settings" page after you add the authentication provider in Canvas. [id] = The ID number for the specific authentication provider configuration. The URL described in the first scenario above would only work for the first authentication of that type in the list (example: multiple SAML IdPs). As a result the Authentication settings page will display a new, more specific, login URL after the second authentication provider of the same type has been added. An example when multiple SAML IdP configurations are in Canvas (/login/saml/#): Ok...So what do I do with these URLs? Now that you have the special Canvas login URLs you are ready to build a web page. Sorry, I'm not going to tell you how to do that, but if you work with your web designer or specialist they should be able to help you build a simple web page that contains the links you need for a discovery page. You will also need some place to host the web page that is accessible to the entire Internet. Once you have this page built and have placed it on the web you should place the web address (URL) to that web page in the Discovery URL field of your Authentication settings page and save the settings. Here is a brief summary of the steps: Create a web page that contains links to the Canvas URLs for the desired Canvas login URLs Put the web page in a publicly accessible web location (for read only of course) Enter the URL to the page in the Discovery URL field of your Authentication settings page in Canvas Save the settings Give it a try in an incognito or private window I think I get it, but do you have an example? Sure thing! There is an example of a very basic Discovery Page in our community source and unsupported GitHub repository. This example uses a Canvas URL of "canvas.instructure.com". So...if you want to use a copy of this page to use for your Discovery Page then you will need to change the links to point at your Canvas URL at a minimum. Oh...I should also mention that the links on the example page are unlikely to work, so don't click them. It is just an example. Example Page ... View more

We are frequently asked how various institutions choose to nest their sections inside of courses. In other words, what are the most popular nesting methods used to populate enrollments into sections, and place those sections into courses within Canvas. This is a very interesting question! Let's consider what a section and course in your SIS might be compared to the same concept in Canvas. Sections: Sections are easy to envision, but it is worth a second for you to consider what a section might be called in your SIS. For the purposes of this article a SIS "section" is a collection of student enrollments in a division of a course that meets at the same time (or is online) and is taught by the same person. In many SISes, this division may be referred  to as a section, class or course offering. If you are not certain of the division of enrollments that represents a section in this context, please reach our to your SIS admin or your SIS support team for clarification. Your Canvas IC or CSM may also be able to provide some guidance. In almost every case, your sections in Canvas should mirror the enrollments in the same section in your SIS. In some SISes, IDs for sections in Canvas may need to be different than IDs for the same section in your SIS due to SIS ID's being reused over time in the SIS. Careful consideration needs to be used to ensure unique SIS IDs are used in Canvas event between terms and academic years.  Courses: Courses are a little more fluid. In general a "course" in your SIS is more like a catalog of courses you offer and are not linked back to a specific time period or teacher. As a result, the concept of a course in your SIS is most likely very different than the concept of a "course" in Canvas. In many cases, a course in Canvas is more closely related to a section in your SIS. This brings us to the two most common Canvas section -> course setups we see used in Canvas. We call these two layouts 1:1 and 1:Many. The diagrams below provides a high-level overview of the two different formats, but please read on for more details. One-to-One Relationship: An individual course would be created for each section from your SIS. For example, if a teacher has three sections of English 101, the course list for the teacher would list three separate courses.  Example: English 101 – Johnson – Section 1 English 101 – Johnson – Section 2 English 101 – Johnson – Section 3 Each of the courses will have a single section of enrollments. This method allows for individual management of content, assignments, groups, etc. This means that teachers would need to update each course with new content and assignments. If desired, teachers can group their courses together through a process called cross-listing.   One-to-Many Relationship: A single course will be created and all sections will be added to the course per teacher, course, term association. For example, if a teacher has three sections of English 101 and two sections of English 102, the course drop-down would list a single course for each SIS course. Example: English 101 – Johnson English 102 – Johnson The one-to-many relationship allows for a single location for managing course content, assignments, and due dates. This means that teacher can update an assignment in one location and have those changes applied to all sections associated to the course. Due dates and graded item availability can be different per section within the course using differentiated due dates. ... View more