Note: If your integration was configured before June 2024, your tool title may use ‘LabSim’ or ‘TestOut’ instead of ‘CertMaster’
Step 1: Go to: Admin > Developer Keys > + Developer Key > + LTI Key
Step 2: Complete the following (see image below for details):
Step 3: Key Settings
-
- Key Name: CertMaster LTI Adv
- Owner Email: <your email here>
- Redirect URIs: https://partner.testout.com/openid/idtoken
- Notes: <your notes here>
Step 4: Configure
-
-
- Method: Manual Entry
- Title: CertMaster LTI Adv
- Description: LTI 1.3 tool to connect to CompTIA's CertMaster learning platform, which includes CertMaster Learn, Labs, and Perform products, as well as TestOut content released prior to 2024
- Target Link URI: https://cdn.testout.com/lms-gate/index.html
- OpenID Connect Initiation Url: https://partner.testout.com/openid/authorize
- JWK Method: Public JWK URL
- Public JWK URL: https://partner.testout.com/openid/keyset
- LTI Advantage Services:
- Check all boxes except for "Can update public jwk for LTI services"
- Additional Settings:
- Domain: partner.testout.com
- Skip: Tool ID, Icon Url , Text, Section Height, Section Width
- Custom Fields:
- course_end_date=$Canvas.term.endAt
- course_start_date=$Canvas.term.startAt
- submission_end_date=$ResourceLink.submission.endDateTime
- submission_start_date=$ResourceLink.submission.startDateTime
- resource_available_end_date=$ResourceLink.available.endDateTime
- resource_available_start_date=$ResourceLink.available.startDateTime
- Privacy Level: Public
- Placements: Module Menu Modal
- Module Menu Modal
- Target Link URI: https://cdn.testout.com/lms-gate/index.html
- Select Message type: LtiDeepLinkingRequest
- Icon URI: https://cdn.testout.com/labsimsaas/images_v2/comptia-c-logo.png
- If the red icon disappears into your LMS' background, you can also select from the two icon URLs below:
- White: https://cdn.testout.com/labsimsaas/images_v2/c-logo-white.png
- Dark Gray: https://cdn.testout.com/labsimsaas/images_v2/c-logo-gray-darkest.png
- Text: CertMaster LTI Adv
- Section Height: 800
- Section Width: 1000
- Module Menu Modal
-
Step 5: Select Save
Step 6: Toggle the Developer Key to On
Step 7: Copy the Developer ID
Step 8: Paste the Developer ID (from the Developer Key you created earlier) into the Registration from provided by your CompTIA Representative (via the sent URL). Also add your name and email if needed. Don't Send yet.
Step 9: Return to Canvas.
Please take care in step 10 to choose the correct point in your Canvas hierarchy to finish configuration, particularly if your school or institution shares a Canvas instance with other organizations. Proceeding incorrectly can cause students or classes to be associated with the wrong organization in the CompTIA platform, which can be challenging to resolve once it's been done. Please reach out to your CompTIA integration rep for guidance if you have any questions or concerns.
Note: If your integration was configured before June 2024, your tool title may use ‘LabSim’ or ‘TestOut’ instead of ‘CertMaster.’
Step 10: Navigate to the Canvas account or sub-account where you'd like to make the App available by navigating to Admin tab -> Select Account, then Sub-accounts -> Select your org's sub-account.
Step 11: Go to Settings > Apps > View App Configuration > + App
Step 12: Configuration Type: By Client ID
Step 13: Client ID: paste the same Developer ID copied in step 7
Step 14: Select Submit
Step 15: Select Install (if prompted to do so)
Step 16: After installing, click on the gear cog for the plugin just installed and select Deployment ID.
Step 17: Copy the whole deployment ID
Step 18: Return to the registration URL from your CompTIA Representative and provide the following:
-
- Paste the Canvas Developer ID into the Canvas Developer ID field.
- Paste the Deployment ID into the Canvas Deployment ID Field
- Canvas Access Token Endpoint
- For production environments, paste: https://sso.canvaslms.com/login/oauth2/token
- For beta environments, paste: https://sso.beta.canvaslms.com/login/oauth2/token
- For test environments, paste: https://sso.test.canvaslms.com/login/oauth2/token
- Canvas Authorization Endpoint
- For production environments, paste: https://sso.canvaslms.com/api/lti/authorize_redirect
- For beta environments, paste: https://sso.beta.canvaslms.com/api/lti/authorize_redirect
- For test environments, paste: https://sso.test.canvaslms.com/api/lti/authorize_redirect
- JWKs Endpoint
- For production environments, paste: https://sso.canvaslms.com/api/lti/security/jwks
- For beta environments, paste: https://sso.beta.canvaslms.com/api/lti/security/jwks
- For test environments, paste: https://sso.test.canvaslms.com/api/lti/security/jwks
- Click Save to complete the install
Step 19: To test, go into a course with the subaccount you installed the App in to. Go to modules you intend to make the link and in the upper right hand corner, you should see three dots. Click on the three dots and the plug should be labeled "CertMaster LTI Adv" (based on a previous naming in this guide).
-
- Note: You will need to publish your module(s) before you can access the CertMaster LTI Adv from the modal (three vertical dots) menu.
Step 20: See our other guides to add content to your Canvas Assignments.
Important Information:
Automatically Creating a class and Enrolling students
AS THE INSTRUCTOR:
Click one of the CertMaster assignment links in your LMS course. When you click on the link, a like-named class is automatically created in CertMaster. You can view this class on your home (MY School) page within your CertMaster account. As applicable, make sure to click a link from each of your LMS courses. When you do, again, a class matching your LMS course's name will be automatically created in your CertMaster account. As a best practice, don't rename, archive, or manually create a duplicate of this class in CertMaster. However, you may archive the class after your semester ends.
DO NOT create your class manually in CertMaster.
Note: It is critical that at least one initial assignment be clicked to establish integration between your LMS and your CertMaster account, which involves the creation of the automatic class within your CertMaster account, as well as its associated start/end dates. See below for additional information around class dates.
INSTRUCT YOUR STUDENTS:
Click one of the CertMaster assignment links inside your LMS course. Upon clicking, a student account will automatically be created for the student in CertMaster, and the student will be enrolled in the corresponding class in CertMaster. It is critical that at least one initial assignment be clicked to establish integration between your LMS and the CertMaster student and instructor accounts. This is how the CertMaster platform knows that your student exists, and is also important for multiple aspects of integration functionality, such as score return from CertMaster to your LMS.
Licenses: If your agreement with CompTIA involves pre-purchased licenses or usage-based billing, a courseware license is also automatically activated and applied to the billing method in question.
Access Keys: If your students will be gaining access through Access Keys (usually purchased by the student ahead of time via a bookstore or https://shop.testout.com/), they will be prompted to enter their access key when they click their first CertMaster link. If purchasing from https://shop.testout.com/ a student purchase price code can be obtained from your school's CompTIA Customer Success Manager.
- For students who already have CertMaster accounts, make sure that the email address associated with their CertMaster account is the same as the email address of their LMS account. This way, the integration will be able to find and connect to the existing student CertMaster account.
- DO NOT create your students' accounts inside CertMaster through CSV, individually, or through email.
- Students DO NOT need to create their accounts through testout.com.
Regarding Start and End Dates of your CertMaster class
-
If the LMS course start date is known via the integration, this date will be used as the start date for the CertMaster class.
-
If the LMS course end date is known via the integration, this date will be used as the end date for the CertMaster class. The end date shouldn’t exceed 18 months from when a course is first created in CertMaster.
-
If the LMS course start date is NOT known via the integration, the date when the first initial TestOut assignment link is clicked will be used as the start date for the CertMaster class.
-
If the LMS course end date is NOT known via the integration, the CertMaster end date will be 12 months from the start date (the start date is based on the standards set above).
-
If the LMS course end date is set to continuous, the CertMaster end date will be 12 months from the start date (the start date is based on the standards set above).