Schoology Admin Guide

The admin will need to set up an external LTI tool, create an LTI app on Schoology, and launch the FluencyLink portal. Follow the below steps to complete the configuration.

Set up external LTI tool in Schoology.

Step 1

Review LTI Apps Developer Documentation at https://developers.schoology.com/app-platform/lti-apps 

 Step 2

You will need your OAuth key, secret key, and Client ID to build your app with Schoology Learning. To get these, you need to add an app by clicking 'App Center' and navigating to the 'My Developer Apps' section. Don't worry if you don't have all the details for the app creation form yet. Add the app to get this information and then you can update all the details later. To add your app...

1. Login to Schoology Learning and navigate to the Tools section as below:
2. Navigate to App Center > My Developer Apps
3. You'll see a screen like this if your company has never submitted an app before.
   Press Add App Button If you have submitted an app before, you'll want to add a NEW App. If your new app will be replacing your current one, you can tell us that when you publish it.
4. Add placeholders for the app details, or if you know the details, go ahead and fill them in as below:

1. Choose an App logo:

1. Select LTI 1.3 App for the Type of App
   
2. Select User, Courses, configuration, and privacy as below:
   
   
3. You will need to enter information for the app's JWKS URL, Domain URL, and the OIDC Login URL. This information can be found in FluencyLink (see below details).a. Go to the FluencyLink Portal, Navigate to Settings, and open the LTI 1.3 Tool as below:b. Click on the 'view' button of your specific LMS:

Save the 3 URLs provided to you in the Tool Details after you click view mode. This will assist you in filling out the info in the above URL's section on the Schoology app form:

1. The Keyset URL corresponds with the JWKS URL section in Schoology. Copy The Keyset URL from FluencyLink and Paste it into the JWKS URL section in Schoology. 
2. The Launch URL corresponds with the Domain/URL section in Schoology. Copy the Launch URL from FluencyLink and Paste it into the Domain/URL in Schoology. 3. The Login Initiation URL corresponds with the OIDC Login URL in Schoology. Copy the Login Initiation URL from FluencyLink and Paste it into the OIDC Login URL in Schoology. (Note: The Launch URL also corresponds with the Redirect URL in Schoology. Copy the Launch URL from FluencyLink and paste it into the Redirect URL in Schoology.)4. Users can add custom parameters for the product launch during the Schoology App's setup by using the Schoology Dashboard:

9. Click agree and press the submit button to generate a client ID: 

10. You will be redirected back to your app's integration page. From here, a message will be generated that confirms the app has been created and the consumer key and secret keys are listed below. These keys can be accessed at any point in time by using the gear dropdown from the application page. 

The Client ID details can also be found by clicking options and selecting API Info after the app has been installed. 

11. Click the 'I Agree' button. Afterward, click the continue button as shown below:

12. Click on 'Add To Organization' or 'Install For Me' as shown below. The application will be added for installation or removal. 

13. Once the app is added following screen will appear with an option to install/remove. Click on Install/remove to begin installation. 

13. Check the below boxes for All Users, all courses, and All groups and click submit.

14. Update the Client ID from Schoology as explained above. Then, you'll need to update the iteration as it is shown in FluencyLink:

a. Login to FluencyLink and click on the Edit Button

b. Replace the Client ID copied from Schoology in the 'Client ID' section on FluencyLink and click update.

15. When the user goes to the Schoology app one can navigate through the courses and launch the user from Schoology as below:

For a tutorial video on implementing the Schoology LTI 1.3 integration, please review the following from our development team. Note that our platform is called "FluencyLink" and not "MagicBox"

https://drive.google.com/file/d/1DnapFthlhdEBF0J6brUbk0DvwLg47BvX/view?usp=sharing