Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

DRAFT: The following is an example using the configuration values that were filled in for CCSF's integration with Canvas. And this document currently illustrates configuring your Canvas site to go straight to your college/district IdP. We'll be updating this document to instead illustrate going to your college/district IdP throught through the CCC IdP Proxy instead. That will change  theThe following values will need to be updated:

  •  IdP IdP entityID:  this will become change to the Proxy IdP entityID, not the college one
  • Log On URL: this will become change to a URL that goes to the IdP Proxy SSO endpoint, and with a ?source= query argument identifying the college/district IdP to then go to
  • Certificate fingerprint: this will become the certificate fingerprint of the IdP Proxy signing certificate (we will give you the specific value to fill in, it will be he same for everyone)
  • Note: the Logout URL, if you want the user logged out of your IdP after logging out of Canvas, will be same as below. The IdP Proxy will not keep a session, so you just have Canvas send the user to your IdP's Logout endpoint.

...

Each college using Canvas has one or two people who have been established as "Canvas Administrators" for that college. The person(s) in that role have has access to their Canvas site with "administrative privileges", including being able to configure how authentication is done for their Canvas site. That is the person who has access to "turn on" SAML authentication for the college site, and fill in the needed info for that to work.Note that Canvas recommends you do this first This individual will need to make the changes outlined in this document. 

Canvas recommends that you first implement the changes on your Test/Beta site , get and ensure it is working correctly there , and only then configure prior to configuring it on your Production site. But Please be aware thta that every couple of few weeks, Instructure repalces replaces your Test/Beta site config with your Production config, so you might have to repeat configuring the below multiple times if it takes you too long longer to complete your verification testing.

This document tells you how to navigate to the page that has the SAM config options on it:

      https://community.canvaslms.com/docs/DOC-4284

But the basic thing is to click Step 1- Click on "Authentication" in the left-hand pane of this screen: 

 

   

And then  

Then click on SAML in the right-hand side of the subsequent screen: 

 

That will bring you to the main "SAML configuration form", and here is a guide to what to fill in for each of the form fields.. The following information should be placed in the fields: 

 

    NotesNote: this is the value of the 'idp.entityID=' property in the IdP's conf/idp.properties file . And and in your IdP's metadata.

* Log On URL: https://idp.ccsf.edu/idp/profile/SAML2/Redirect/SSO
   Notes Note: this is the Location value from the following entry in your IdP's metadata:
        <SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://idp.ccsf.edu/idp/profile/SAML2/Redirect/SSO"/>  

* Log Out URL:  https://idp.ccsf.edu/idp/profile/Logout   
   Notes Note: Only enter this if you want the user logged out of your IdP after logging out of Canvas.

...

  There is a dropdown with multiple choices, You want to choose 'eduPersonPrincipalName'. That has to match what you fill into the LOGIN_ID in the Canvas provisioning feed.
 
* Identifier Format:  urn:oasis:names:tc:SAML:2.0:nameid-format:transient

(choose the above value from the drop-down and Save your changes. The drop-down should have the following set of choices:


* You can leave the rest of the fields empty /whatever is or populated with the default value, except maybe for Position. That . The exception is the Position field which applies if you are going to allow multiple ways of logging in, which you won't be available once you convert. If you only have one form of Authn configured, then Position doesn't matterthe Position does not apply. Otherwise, you probably want SAML listed first, so you 'd should set Position to '1' in the drop-down:

These are all the fields you'll see that the above applies to:

...