Canvas Guides

How do I manage developer keys for an account?

As an admin, you can manage developer keys for root accounts. You can manage the status for individual developer keys and control direct access to specific API endpoints for third-party tools.

Newly-created developer keys default to off in an account.

Notes:

Developer Keys is an account permission. If you cannot view the Developer Keys link in Account Navigation, this permission has not been enabled for your user account.
Although new keys are disabled when created, keys created prior to July 14, 2018, have been turned on by default to ensure uninterrupted access.
Instructure does not review vendors prior to issuance of global developer keys, though specific vendor information is required. You should review your list of inherited keys to ensure that only institution-approved keys are active. To determine which developer keys are being used in your account, run the Developer Keys Report.
Consortium Admins can edit developer keys in parent accounts to sync changes to every associated tool installed in any child account.

Open Account

In Global Navigation, click the Admin link [1], then click the name of the account [2].

Open Developer Keys

In Account Navigation, click the Developer Keys link.

View Developer Keys

The Developer Keys page defaults to the Account tab, where you can view the Developer Keys for your account. Each key shows the name [1], owner's email [2], details [3], stats [4], type [5], and state [6].

If a key has been configured as an LTI key, the Type column will display the External Tool icon [7].

View Inherited Keys

To view inherited keys associated with your account, click the Inherited tab [1]. Inherited keys are keys created and managed at a global level by Canvas. You can manage the state of inherited keys for your account. However, if a key is grayed out [2], it has been enabled globally and cannot be modified on a specific account level.

Manage Developer Keys

To deactivate a key, click the toggle button to the Off position [1]. To edit a key, click the Edit icon [2]. To delete the key, click the Delete icon [3].

View Confirmation Message

When changes are made to a developer key, a confirmation message displays. To confirm the changes, click the OK button [1]. To cancel the changes, click the Cancel button [2].

View Deactivated Keys

When a key is deactivated, the key is inactive. Deactivated keys are indicated by the Off toggle button [1]. To reactivate an inactive key, click the toggle button to the On position [2].

Add Developer Key

To add a developer key, click the Add Developer Key button.

Edit LTI Key

To edit an LTI key, click the Edit icon.

Update Redirect URI

To update the Redirect URIs field after changing the JSON for an LTI key, click the Sync URIs button. If the Redirect URIs field is empty, it auto-populates from the pasted JSON.