|
|
| Line 3: |
Line 3: |
|
| |
|
| <!-- include the TOC as a template in the first column --> | | <!-- include the TOC as a template in the first column --> |
| | style="width:250px; vertical-align:top; padding:2px 15px 2px 2px;" | {{TechDocsTOC}} | | | style="width:300px; vertical-align:top; padding:2px 15px 2px 2px;" | {{ReportsGuideRegTOC}} |
|
| |
|
| <!-- here is the second column of the full wiki page - will contain content --> | | <!-- here is the second column of the full wiki page - will contain content --> |
| Line 10: |
Line 10: |
| <!-- here is a table for the content of the page --> | | <!-- here is a table for the content of the page --> |
| {| style="width:100%; vertical-align:top; " | | {| style="width:100%; vertical-align:top; " |
| | | | style="vertical-align:top; font-size:160%; color:#7c1911; " | '''Progress Report Detail by Student''' <HR> |
| | style="vertical-align:top; font-size:160%; color:#7c1911; " | '''Authentication Options''' <HR> | |
| | |
| |-
| |
| | style="vertical-align:top; font-size:120%; " | <br />To use campus credentials (Single Sign-on or SSO) to sign into your Trac System, there are a few choices. Our preferred authentication method is SAML, but you may also use CAS, LDAP or Microsoft Azure. Shibboleth may be used, but only when it has a SAML or CAS front end. Please see below for more detailed technical information.
| |
| |-
| |
| | |
| | style="vertical-align:top; font-size:140%; color:#7c1911; padding:30px 0px 0px 0px;" | SAML Authentication <HR>
| |
| | |
| |- | | |- |
| | style="vertical-align:top; font-size:100%; " | Redrock tech support and your campus IT contact will need to work together to set up SAML Authentication. | | | style="vertical-align:top; font-size:120%; " | <BR />The Progress Report Detail by Student allows for a detailed review of the progress reports for each student. The report details are organized in alphabetical order of the student’s last name and contain the student ID, course, instructor, report date, grade received, term ID, and notes. The report may be generated for an individual student, instructor, course or grade. |
|
| | |
| SAML requires some communication between your campus authentication server and the Redrock SAML Proxy server.
| |
| | |
| '''1)''' Your AdvisorTrac/TutorTrac software must be updated to the Feb 2019 version or later.
| |
| | |
| '''2)''' Please provide Redrock with your campus metadata (or the HTTP-POST URL).
| |
| | |
| '''3)''' Here is the Redrock Metadata link:
| |
| <nowiki>https://saml2.go-redrock.com/simplesaml/module.php/saml/sp/metadata.php/trac4-saml</nowiki>
| |
| *download and install our metadata into your SSO software.
| |
|
| |
|
| '''4)''' We will need a test student account. | | '''GENERATE THE REPORT''' |
| | |
|
| |
|
| '''5)''' SAML Attribute:
| | To generate the Progress Report Detail by Student, click on Reports from the TutorTrac Main Menu. On the Reports Chooser, select Registrations from the pull down list of available categories. After selecting Registrations, choose Progress Report Detail by Student. Then enter a date range for the time period that you would like to review in the report. Then click on the Generate Report button. |
| *Send username, email address, or student ID as an attribute.
| | |
| *The name of the attribute can be whatever your system uses. (examples: username, student id, email, sAMAccountName, personprincipal, name id, PersonID)
| |
| *The attribute needs to be a unique identifier for the student account (preferably the username).
| |
| *The attribute must be a value that we can match with the TutorTrac student or instructor account.
| |
|
| |
|
| '''6)''' SAML Response to Redrock:
| |
| *can be signed
| |
| *can be encrypted
| |
| **can be transient or persistent
| |
| **Our SAML setup is for SP (Service Provider) initiated with Redrock as the SP.
| |
| - We have plans to support IdP (Identity Provider) initiated in the future, rollout date is TBD.
| |
|
| |
|
| '''7)''' Your TutorTrac/AdvisorTrac URL must be reachable (without VPN credentials). Redrock IP must be whitelisted.
| | [[File:PRDetailStud.png|border|700px]] |
| *Redrock SAML Proxy IP: saml2.go-redrock.com (63.224.138.136), ports 80 and 443
| |
|
| |
|
| *Redrock Tech Support IP: go-redrock.com (63.224.138.155), ports 80 and 443
| |
|
| |
|
| '''8)''' Your TutorTrac/AdvisorTrac URL must use SSL <nowiki>(https://TracSystem.campus.edu)</nowiki>
| | [[File:PRDetailStud1.png|border|700px]] |
|
| |
|
| '''9)''' After the end user is finished using AdvisorTrac/TutorTrac, we can re-direct to a webpage that you specify. Please provide the exact link address (for example <nowiki>https://mycampus.edu).</nowiki>
| |
|
| |
|
| '''10)''' Please schedule a time to test SAML configuration.
| |
|
| |
|
|
| |
|
| |- | | |- |
| | style="vertical-align:top; font-size:140%; color:#7c1911; padding:30px 0px 0px 0px;" | LDAP Authentication <HR> | | | style="width:100%;" | |
| | |
| |-
| |
| | style="vertical-align:top; font-size:100%; " | '''1)''' The Trac system provides an LDAP test page that can be accessed from your main menu. Simply click on the Trac Man icon, then on Utilities and Prefs. There you will find a tab labeled “LDAP Tool”. Fill out the form with values provided to you by your system administrator and click test. A green response is good, a red is bad.
| |
| | |
| This is an example of a single bind LDAP test:
| |
| | |
| '''2)''' For your system to use LDAP, Redrock will require some information about your system that will be used to generate an LDAP binding script that runs when a user attempts to log in. Please send an email to helpdesk@go-redrock.com with the following information:
| |
| | |
| *LDAP Server address
| |
| *Base DN
| |
| *Format of username
| |
| *Username of lookup account (for double-bind setups)
| |
| *Port Number (typically 389 or 636)
| |
| *Encrypted (true or false)
| |
| *Search Criteria (Leave as cn=NOTAUSER unless doing a double bind)
| |
| | |
| Once you send Redrock the necessary information, a team member will implement a binding script on your server and contact you once completed.
| |
| | |
| | |
| | |
| |-
| |
| | style="vertical-align:top; font-size:140%; color:#7c1911; padding:30px 0px 0px 0px;" | CAS Authentication<HR>
| |
| | |
| |-
| |
| | style="vertical-align:top; font-size:100%; " |
| |
| '''1)''' You will create your own weblink to the CAS portal page.
| |
| | |
| '''2)''' Redrock will need a test student account to test with.
| |
| | |
| '''3)''' Redrock needs your CAS service links:
| |
| :*Login URL (example: <nowiki>https://mycampus.school.edu/cas/login </nowiki>)
| |
| :*Logout URL (example: <nowiki>https://mycampus.school.edu/cas/logout </nowiki>)
| |
| :*Validate URL (example: <nowiki>https://mycampus.school.edu/cas/serviceValidate </nowiki>)
| |
| | |
| '''4)''' Redrock needs the CAS XML Attribute containing username (it is usually cas:user).
| |
| | |
| '''5)''' Redrock will need to put a few settings in place.
| |
| | |
| '''6)''' Schedule a time to test with us.
| |
| | |
|
| |
|
| |- | | <!-- this table appears at the bottom of the manual page and contains a previous page and next page link --> |
| | style="width:100%;" | | | {| style="width:70%; vertical-align:top; " |
| | | style="width:50%; text-align:left;" | [[Reports:Progress Report Visit Info by Subj|← Previous Page]] |
| | | style="width:50%; text-align:right;" | [[Reports:Visits by Instructor/Subj|Next Page →]] |
|
| |
|
| <!-- this table appears at the bottom of the manual page and contains a previous page and next page link -->
| |
| {| style="width:70%; vertical-align:top; "
| |
|
| |
|
| | style="width:50%; text-align:left;" | [[TechEmailTool|← Previous Page]]
| |
| | style="width:50%; text-align:right;" | [[TechImport|Next Page →]]
| |
| <!-- here is the end of the previous / next page table --> | | <!-- here is the end of the previous / next page table --> |
|
| |
| |} | | |} |
|
| |
|
| Line 119: |
Line 47: |
| <!-- this line is the end of the table for the entire page --> | | <!-- this line is the end of the table for the entire page --> |
| |} | | |} |
|
| |
| __NOTOC__ | | __NOTOC__ |
| [[Category:Trac 4]] | | [[Category:Trac 4]] |
