Articles in this section

See more

Customizing Applications

   Product: LaunchPad   

Audience: ClassLink Administrator

 

There are several options for adding applications, such as creating simple weblinks, adding from our global library, or creating custom apps.  

 

Overview

 

 

Adding Apps from the App Library

The App Library has different apps in various categories. You can search through categories or by typing the app name in the Search box if you would like to add an application that has not already been custom built by our Helpdesk.

 

Note: Apps added from the global App Library in the ClassLink Management Console will be generic Password Locker applications.  Third-party applications listed as OAuth2 will be functional only if configured with that vendor with your district-specific ClassLink Tenant ID.

 

1. ClassLink Management Console -> Applications -> Add & Assign Apps -> App Library.

 

 

2. Search for the desired app and then click on the Add button to add the app.  The type of app will show in the tile as well.  A Remove button will appear if the app has already been added to the library.

 

 

3. You will be able to see it added in Add & Assign Applications. If you can't find an app, then you can search for it in the Search box on the right.

 

 

Note: You can assign the app to a Profile, Group or User. Apps can also be assigned to a specific App Library.

 

 

 

Adding a Weblink

  1. To add a weblink, or shortcut, (Non-SSO Weblink) for websites that do not require a login, go to Applications -> Add & Assign Apps -> Add.
  2. Fill in the blank fields for the application.
  3. Click Save.

 

Note: If you select "Education" for Category, a subcategory called Subject will be prompted.

 

 

 

Customizing SSO Apps from the App Library 

 

 

 1. To customize an existing SSO app, you will need to add an app from the App Library.

2. Click on the 3 dots under the Other Actions menu.

3. Copy Application (it will make a copy of both app and connector).

 

 

Note: You cannot edit an application from the App Library. You will need to first make a copy, then make edits to that copy app(1). 

 

4. Since this is a Form Post with Extension app, the connector would be an Extension Connector (located under Single Sign-on).

5. Search for the copy application.

6. Click Edit.

 

 

Customizing SSO: You can add a custom AD pass-thru or any other supported SSO variables.

 

Supported SSO value variables

mceclip5.png

 

mceclip0.png
 
 

Note: You can also edit the app's name, description, and icon to make it your own.

 

 

Creating a Single Sign-On (SSO) App

You can create the SSO connector first or create it while creating the app.

1. Open Extension Connectors listed underneath the Single Sign-On section

2. Click Add. 

 

 

3. To inspect a website, right click on the login, password, and submit boxes.

 

51cf1bc-inspect_site.png

 

Note: For ID= use # followed by the ID value. Example: #login_email

 

4. Once you've obtained those, go to the Extension Connector.

5. Add the id fields to the Selector field.

6. Name the label accordingly.

7. Scroll down and click the green save button.

 

afda229-Adding_extension_connector.png

 

8. To create an SSO, click on the green Add button under the Add & Assign Apps sections of Applications. From there a form will pop up asking you for information such as Application Name, Description, Icon, Category, whether it is Single Sign-On or not, Type, and Web Address.

 

 

Note:  Icon Requests - If you create an SSO that does not have an icon in our Icon Library, click Browse Icon -> Request Custom Icon -> Fill out custom icon form.

 

c904e4f-Custom_Icon_Request.png

 

9. Under Single Sign-On App -> Switch the button to Yes.

10. Choose Form Post with Extension from the Type drop-down menu.

11. Click the blue Select button.

12. Search for the Extension Connector you just made.

13. Select -> Save.

 

 

 

 

App Two-Factor Authentication

Individual applications can be configured to require Two-Factor Authentication. 

 

Note:  App Two-Factor Authentication can only be set for non-global apps.

 

Note:  Two-Factor Authentication must be enabled for LaunchPad authentication in order for App Two-Factor Authentication to function.  

 

 

1.  To enable App Two-Factor Authentication, go to the CMC->Applications->Add & Assign Apps

2.  Go to the Other Actions menu for the app your wish to configure and toggle the TwoFactor switch.

 

2F1.png

 

3.  Users who launch an application with App Two-Factor turned on will be required to enable Two-Factor Authentication in Profile Settings->Security in order to use the app.  This will also enable Two-Factor authentication upon login.  If they have not turned this on, they will be presented with this screen:

 

app2fa.jpg

 

 

Note:  Please be sure you have Two-Factor Authentication toggled ON in Security - ClassLink Management Console -> Settings -> Security -> toggle ON Two-Factor Authentication -> click on blue gear icon ->  Assign to Profile. 

 



 

 

Single Sign-On app with Advanced SSO

 You will notice in your Extension Connectors a new field at the bottom called Advanced SSO that allows input of JSON, which is a lightweight, understandable setup for structuring data. 

 

 

mceclip0__1_.png

 

Note: By default, the Advanced SSO switch is turned off.

 

Note: To have a better understanding of how JSON works in the Advanced SSO Extension Connector, Click Here.

 

 

Creating a SAML SSO App

Note: Before you can create a SAML SSO app, please make sure your SAML connector has been set up in the SAML Console. To check, please go to the ClassLink Management Console -> Single Sign-On -> SAML Console.

 

To add a SAML SSO app, you either have to use the IDP Initiate Login URL provided from the SAML console or custom URLs that initiate the Single Sign-On process from a vendor. The process to create a SAML app is similar to creating a Weblink app.

1. ClassLink Management Console -> Applications -> Add & Assign Apps.

2. Click Add.

3. Enter the Custom URL from a vendor (Exampled: HMH). 

 

 

 

Creating an ADFS SSO App

 

Note: Before you can create an ADFS-type app, your organization should have established an ADFS trust with ClassLink and the vendor product. In order for the ADFS SSO app to work, organization users need to login to ClassLink with ADFS.

 

To add an ADFS SSO app, locate the ADFS SP initiated URL from ADFS or contact your vendor for assistance.

1. ClassLink Management Console ->Applications -> Add & Assign Apps.

2. Click Add.

3. Complete form.

4. Enable Single Sign-On -> Select ADFS.

5. Paste the ADFS SP initiated URL in the web address field.

6. Click Save.

7. Assign to your users.

 

 

 

Customized App Library

To make apps accessible in the App Library throughout your organization, you can create custom libraries to which to assign relevant apps.

1.  CMC -> Applications -> Add & Assign Apps -> App Library -> Add to name the

library-> Save.

2. Choose the Profiles of users to whom the library should be visible.

 

 

3.  Click Applications -> Click Add for each application that should be included in the library.

 

 

 

4. Applications can also be assigned to the custom library options by choosing the apps from the app list under Add & Assign Apps and selecting the appropriate checkboxes.

 

 

 

 5.  Users will now have access to the assigned apps in the libraries accessible to them.

 

 

 

Updated: March 2019

Related articles