1. PLEASE READ FIRST: Please submit a ticket with the D2L (Brightspace) server's hostname (must be public) you need to register. We will then provide you with the consumer key and shared secret that is registered to your domain (these credentials are required for step 10).


  2. Click the gear icon in the top-left corner and select Manage Extensibility (see screenshot below)

  3. Select the OAuth 2.0 tag and click the Register an app button (see screenshot below)

  4. Enter the information below:
    • Application Name: The MIT Press | eTextbooks
    • Redirect URI: https://mitpress.ublish.com
    • Scope: content:modules:delete,read,write content:topics:delete,read,write core:*:* grades:gradeobjects:delete,read,write grades:gradevalues:delete,read,write
    • Access Token Lifetime (seconds): 3600

  5. Make sure both Prompt for user consent and Enable refresh tokens are enabled (see screenshot below).

  6. Accept the Non-Commercial Developer Agreement and then click the Register button (see screenshot below).

  7. Provide us with the Application credentials (Client ID and Client Secret) (see screenshot below).

  8. Click the gear icon in the top-left corner and select External Learning Tools (see screenshot below).

  9. Select the Manage Tool Providers tab and click the New Tool Provider button (see screenshot below).

  10. Enter the information below:
    • Launch Point: mitpress.ublish.com
    • Version: Inherit Global (1.1)
    • Secret: CONTACT SUPPORT TO OBTAIN SECRET
    • Check the box for Use custom tool consumer information instead of default
    • Key: CONTACT SUPPORT TO OBTAIN KEY
    • Name: The MIT Press | eTextbooks

  11. Check the box labeled Allow users to use this tool provider under Visibility

  12. Check the following under Security Settings:
    • Send tool consumer information to tool provider
    • Send context information to tool provider
    • Send course information to tool provider
    • Send LTI user ID and LTI role list to tool provider
    • Send user name to tool provider
    • Send user email to tool provider
    • Send system Org Defined ID to tool provider
    • Send system role to tool provider
    • Send link title to tool provider
    • Send link description to tool provider

  13. Make tool provider available to the appropriate Org Units (Any org units that will have courses using the tool).

  14. Click the Save and Close button (see screenshot below).

  15. Select the Manage External Learning Tool Links tab and click the New Link button (see screenshot below).

  16. Enter the information below:

  17. Add the following Custom Parameter
    • Name: d2l_api_domain
    • Value: DOMAIN GOES HERE (example.com)

  18. Check the following under Security Settings:
    • Use tool provider security settings
    • Tool consumer key/secret

  19. Make tool provider available to the appropriate Org Units (Any org units that will have courses using the tool).

  20. Click the Save and Close button (see screenshot below).