Before using the Canvas integration, you need to set it up in both, eBECAS and Canvas.


Canvas Configuration

Log into your Canvas instance with a user with administrator permissions.

  1. From the navigation menu, click on ‘Admin’ and select the account that you want to integrate with eBECAS.
  2. Click on ‘Developer Keys‘.
  3. Click on the button ‘+ Developer Key‘ and select ‘+ API Key‘. The ‘Key settings’ window will show.

Enter the following details in the ‘Key settings‘ form:

  • Key Name: Enter a meaningful name to identify this integration. E.g. eBECAS
  • Owner Email: Enter your work email.
  • Redirect URIs: This value will be provided by eBECAS. You can also get this value from the Canvas integration view in eBECAS (refer to the section below ‘eBECAS Setup’).

Leave the rest of the fields as in the image below:

Great! You have created the developer key. Let’s finalise the setup:

  1. Enable the key that you just created.
  2. Copy the client id (you will need this value when setting up the integration in eBECAS).
  3. Click on ‘Show key‘  and copy the key (you will need this value when setting up the integration in eBECAS).

At this point, you have created and enabled the developer key that eBECAS will use to connect to your Canvas instance. Now you need to set up the connection on the eBECAS side.


eBECAS Configuration

Permissions Required: Canvas Admin

Follow these steps to set up eBECAS:

  1. From the Main menu, click on Utilities>Set up Configuration. The Setup Configuration window will display.
  2. From the side menu, on the Setup Configuration window, click on Setup >Canvas LMS Integration
  3. On the authentication section, enter the following details:
    • Canvas URL: The url to your Canvas instance (usually in the form https://{school name}.instructure.com)
    • Client Id: The ‘Client Id’ for the developer key that you created in Canvas.
    • Client Secret: The value for the developer key that you created in Canvas.
    • Redirect URL: This field is pre-populated for you and it must match the ‘Redirect Urls’ in the Canvas Developer Key.


  4. Click on ‘Save‘.
  5. Click on the button ‘Authorise in Canvas LMS’. A new tab will open on your web browser and it will redirect you to the Canvas site to authorise the access to your Canvas instance.
  6. If you are not logged into Canvas, log in with a user with administrator permissions.
  7. Click on ‘Authorise‘ to authorise eBECAS to connect to your Canvas instance.
  8. A new page with the result of the authorisation process will show in the browser. If it was successful, you can get back to eBECAS to finalise the setup.
  9. If the connection was successful, click on the button ‘Refresh Auth’ and you should see some values populated in the fields ‘Access Token’ and ‘Refresh Token’. These values are used by eBECAS to connect to your Canvas instance.
  10. To confirm the connection between eBECAS and Canvas is now established, click on the button  ‘Refresh Token‘. You should get a message that the token was refreshed successfully which confirms the connection is now working.
  11. From the same screen, on the ‘Accounts’ section, click on ‘Get Accounts‘ and select the Canvas account that you want eBECAS to connect to.
  12. Click on ‘Save‘.
  13. Now you need to syncronise All Canvas elements for the first time. To do so, click on ‘Sync All’ form the Canvas elements page. Click here for more details.

Well done! The integration with Canvas is ready!