How to: Install the Angel Nugget for Tegrity AAIRS

You will need:

  • Admin access to Tegrity
  • Admin access to Angel
  • Your Tegrity customer number
  • Your Tegrity shared secret
  • An Angel username and password for a user that can access the Angel APIs.  Typically any Angel admin user can access the Angel APIs.

1. Download and Install the Tegrity ANGEL Nugget for AAIRS

  • Unzip the downloaded archive – you should find these files on your local computer (you will upload them to the Angel server using the Angel UI):
    • default.asp
    • info.ini
    • md5.asp
    • sso.asp
    • logo.png
  • Login to your ANGEL server as an administrator and navigate to Administrator Console and then to Portal Components on the Application tab.

  • Navigate to File Manager and click the Add Content link

  • Use the Create a Folder control to create a ‘TegrityCampus’ folder

  • Upload all the files (default.asp, info.ini, md5.asp, sso.asp, tegritylogo.gif) to the TegrityCampus folder.

2.  Configure the Nugget with your Tegrity customer number and shared secret

  • Edit ‘sso.asp’ changing lines assigning sSharedSecret and sCustomerNumber with your actual values you received from Tegrity (typically in your welcome email).

Const sSharedSecret = “XXXXXX”
Const sCustomerNumber = “XXXX-XXXX-XXXX”

  • Register new components from the Registered Portal Components page

3.  Configure AAIRS to use Angel for Direct Login Authentication and/or Authorization

  • Login to your Tegrity instance as the admin
  • Navigate to the AAIRS interface (click ‘Manage AAIRS’ from the admin dashboard)

Use Angel for Direct Login Authentication

  • Edit the Authentication section and add a ‘Custom’ connector

  • Configure the Custom connector:

Service URL:
https://aairs-connectors.tegrity.com/angel-custom-agent.009/AuthenticationService.asmx

Extended Properties:
server=YOUR.ANGEL.SERVER.URL;app_user=XXXXXX;app_user_password=XXXXXX;id_type=external;protocol=https

Replace the ‘xxxxxxx’ and ‘YOUR.ANGEL.SERVER.URL’ above with your actual values.

Enter an Angel user who can access the Angel APIs as the app_user.  Typically any admin user in Angel can access the Angel APIs.

Possible id_type values:

  • internal Use when your Angel server is setup to return internal user IDs
  • external Use when your Angel server is setup to return external user IDs
  • login Use when your Angel server is setup to return login user IDs

Possible protocol values: https or http

  • Save the Authentication settings then Save & Continue

Use Angel for Authorization (Courses / Enrollments)

  • Edit the Authorization section and add a ‘Custom’ connector

  • Configure the Custom connector:

Service URL:
https://aairs-connectors.tegrity.com/angel-custom-agent.009/DatasetIntegrationService.asmx

Extended Properties:
server=YOUR.ANGEL.SERVER.URL;app_user=XXXXXX;app_user_password=XXXXXX;id_type=external;protocol=https

Note that the Service URL is different for Authentication and Authorization (the extended properties are the same).

Replace the ‘xxxxxxx’ and ‘YOUR.ANGEL.SERVER.URL’ above with your actual values.

Enter an Angel user who can access the Angel APIs as the app_user.  Typically any admin user in Angel can access the Angel APIs.

Possible id_type values:

  • internal Use when your Angel server is setup to return internal user IDs
  • external Use when your Angel server is setup to return external user IDs
  • login Use when your Angel server is setup to return login user IDs

Possible protocol values: https or http

  • Save the Authorization settings then Save & Continue

4.  Enable the interlinks to Tegrity in Angel by adding the Nugget to your home page and course templates

  • Edit the Portal Pages to add Tegrity to the allowed component filters for the Course Home Page and Angel Home Page

Add the Tegrity link to all courses and/or the Angel home page

  • Reconfigure the layout of Course Home Portal Page and modify the layout by dragging Tegrity nugget to a desired area of the page

Alternatively, add the Tegrity link to individual courses in Angel

Note – This is not needed if you have added the Tegrity link to the course template

  • Edit the course page for the course you want to have the Tegrity link

  • Select Add Component and place the Tegrity link on the page

Note that Tegrity must be in the allowed Component Filters list for the course page (or any other page you wish to place the Tegrity link).

Popular Articles

Let Tegrity Know!

We welcome your feedback on how we can improve the Tegrity lecture capture service. Please provide any comments and suggestions to your account management team.