# Brightspace

## Step 1: Send info to EXAMIND

In order for EXAMIND's iframe to load within your Brightspace instance, EXAMIND must white-list your Brightspace domain by adding it to its *content-security-policy* HTTP header. Please send us your production Brightspace Instance URL (example: <https://devcop.brightspace.com>).

Information can be emailed to [**support@examind.io**](mailto:support@examind.io).

***

## Step 2: Register LTI Tool

From the **Admin Tools** menu, click **Manage Extensibility**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FxGt3wPtMyrG1iYvtCuQC%2Fimage.png?alt=media&#x26;token=969ae39d-fb4d-4a91-b96c-32ac6d398328" alt=""><figcaption></figcaption></figure>

From the **LTI Advantage** tab, click **Register Tool**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2F4l97tmva6UVV3LlBrZMC%2Fimage.png?alt=media&#x26;token=5bd9b36d-fd7f-4311-87ac-881f692f97cb" alt=""><figcaption></figcaption></figure>

Choose **Dynamic**, and add one of the following **Tool initiation registration endpoints**:

* For US data center users: <https://lti.examind.io/register>
* For Canadian data center users: <https://lti-ca.examind.io/register>

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2F4E0RT7NGyBLwEfi8qTtG%2Fimage.png?alt=media&#x26;token=932542e4-bc53-4d3d-ae02-e42ddb1efc8d" alt=""><figcaption></figcaption></figure>

Click **Register** and a new tab will open.

{% hint style="info" %}
When registering a tool in Brightspace, a new tab will open and perform several redirects before remaining blank - this is a known issue that doesn't affect proper tool registration. Despite the blank page, your tool will be correctly registered in the system; simply close this tab and return to the `Register a Tool` page to continue.
{% endhint %}

From the **Admin Tools** menu, click **Manage Extensibility**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FDdvZSPO1bZkz49OqNY41%2Fimage.png?alt=media&#x26;token=d7ec2c8a-2389-4996-af6c-42ed34728429" alt=""><figcaption></figcaption></figure>

From the **LTI Advantage** tab, click **All**, filter, find, and click **EXAMIND**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FJ1vpGEv7ileCOs15w948%2Fimage.png?alt=media&#x26;token=875a584a-9053-48ca-8aa5-93cbaee0a583" alt=""><figcaption></figcaption></figure>

Enable **EXAMIND**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FfF8gZfI2cOZULLDVBpt0%2Fimage.png?alt=media&#x26;token=0a103395-0550-456e-825f-6ec6f9e7ff4f" alt=""><figcaption></figcaption></figure>

Ensure that the following 3 extensions are enabled:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FVVWXNh6PutLYznFWrzgQ%2Fimage.png?alt=media&#x26;token=39a916c2-330b-47c2-86b6-99352656903f" alt=""><figcaption></figcaption></figure>

Add the following **Substitution Parameters**:

| Name                                                      | Value                                 |
| --------------------------------------------------------- | ------------------------------------- |
| brightspace\_context\_id\_history                         | $Context.id.history                   |
| brightspace\_course\_offering\_label                      | $CourseOffering.label                 |
| brightspace\_course\_offering\_sourced\_id                | $CourseOffering.sourcedId             |
| brightspace\_course\_offering\_title                      | $CourseOffering.title                 |
| brightspace\_course\_section\_dept                        | $CourseSection.dept                   |
| brightspace\_course\_section\_label                       | $CourseSection.label                  |
| brightspace\_course\_section\_sourced\_id                 | $CourseSection.sourcedId              |
| brightspace\_course\_section\_time\_frame\_begin          | $CourseSection.timeFrame.begin        |
| brightspace\_course\_section\_time\_frame\_end            | $CourseSection.timeFrame.end          |
| brightspace\_course\_section\_title                       | $CourseSection.title                  |
| brightspace\_person\_sourced\_id                          | $Person.sourcedId                     |
| brightspace\_resource\_link\_available\_end\_date\_time   | $ResourceLink.available.endDateTime   |
| brightspace\_resource\_link\_available\_start\_date\_time | $ResourceLink.available.startDateTime |
| brightspace\_resource\_link\_id\_history                  | $ResourceLink.id.history              |
| brightspace\_resource\_link\_submission\_end\_date\_time  | $ResourceLink.submission.endDateTime  |
| brightspace\_resource\_link\_title                        | $ResourceLink.title                   |
| brightspace\_user\_id                                     | $User.id                              |
| brightspace\_user\_username                               | $User.username                        |

It should look like this:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2Ff8uU0iLirTx00BHYA4T6%2Fimage.png?alt=media&#x26;token=0d8278d5-8ab4-4d7d-ae77-d500f52d1546" alt=""><figcaption></figcaption></figure>

**Save** you changes without closing, as we will need to configure deployments next.

## Step 3: Add Deployment

From the **EXAMIND** LTI Tool page, click **View Deployments**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2F7wExafzsICnMb05Q3Fe7%2Fimage.png?alt=media&#x26;token=548192f1-df56-4fa9-9f7c-130bf768e83d" alt=""><figcaption></figcaption></figure>

Click **New Deployment**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2F6EAV4HP4yUysHgQVrmT2%2Fimage.png?alt=media&#x26;token=3c67dfca-07f7-4d6f-b802-6917525ffff0" alt=""><figcaption></figcaption></figure>

Select the **EXAMIND** tool and give it a name:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FQUJKwa5aFgfwyy7MDQSm%2Fimage.png?alt=media&#x26;token=655d392d-efeb-445f-ab55-a4bf4ad68ac1" alt=""><figcaption></figcaption></figure>

Ensure the the following extensions are enabled:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FmNkFCyJy89eUPnkv9OwB%2Fimage.png?alt=media&#x26;token=bcf2fc80-fd7d-40aa-85fb-3a94a6a666c1" alt=""><figcaption></figcaption></figure>

Enable the following **Security Settings**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FNq8qMXP4zxnQZyYtGSgi%2Fimage.png?alt=media&#x26;token=b2c70499-7c9f-403e-a68d-07ca1a3b3f9d" alt=""><figcaption></figcaption></figure>

Enable the following **Configuration Settings**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FyGxgth2J0lPWKKpu6YVB%2Fimage.png?alt=media&#x26;token=2b568e7e-6d39-4fad-9b33-febaac3a143c" alt=""><figcaption></figcaption></figure>

Click Add Org Units and in the popup, select which organizations or courses should have access to EXAMIND:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FDkxZC1fl6KgVyhGkbcBW%2Fimage.png?alt=media&#x26;token=10467305-19c9-413f-9994-86db67485e08" alt=""><figcaption></figcaption></figure>

Create Deployment.

***

## Step 3: Add Link

From the deployment page, click **View Links**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FwGMnnFL5e4qEx9uG5Nee%2Fimage.png?alt=media&#x26;token=8004678a-aa27-4a49-98fd-c2f3ff67e5eb" alt=""><figcaption></figcaption></figure>

Click **New Link**:

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FGKI9yUUV50n2msjAOq2l%2Fimage.png?alt=media&#x26;token=141c7fb9-7dea-407a-aef9-6c5b2adb773d" alt=""><figcaption></figcaption></figure>

Name the new link and set the URL to one of the following

* For US data center users: <https://lti.examind.io/>
* For Canadian data center users: <https://lti-ca.examind.io/>

For **Type**, select **Deep Linking Quicklink:**

<figure><img src="https://211323355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDfKsc0R4AcYm9kZgIT2X%2Fuploads%2FDJnLacgt8Wlb84HlTtG9%2Fimage.png?alt=media&#x26;token=b4686914-edff-419f-96b1-89235adfc91d" alt=""><figcaption></figcaption></figure>

Click **Save and Close**.

***

## Step 4: Assessment Deeplink

Refer to [Assessment Deeplink](https://examind.gitbook.io/v1/get-started/lms-integrated/assessment-deeplink#brightspace) for instructions on how to link a Brightspace activity to an EXAMIND assessment.
