--- loncom/html/adm/help/tex/Course_Prefs_Linkprotection.tex 2022/02/16 04:04:39 1.2 +++ loncom/html/adm/help/tex/Course_Prefs_Linkprotection.tex 2022/02/24 17:35:24 1.4 @@ -46,7 +46,7 @@ If the domain has been configured to all \item Action if username does not match enrolled student \end{itemize} -Deciding what to select as the source of the username requires knowing what the other learning system sends in the LTI Request. Ideally, the other system will provide a preview feature for instructors to use to display items included in a launch request, and values set for them (for the previewer). In LON-CAPA, selecting ``User ID'' for the username source indicates the username will be whatever was assigned to the ``lis_person_sourcedid'' parameter, whereas selecting ``Email address'' means the username will be whatever was assigned to the ``lis_person_contact_email_primary'' parameter by the launch system. If neither of those are appropriate then ``Other'' can be selected, and the appropriate parameter name in the LTI Request can be entered in the textbox. +Deciding what to select as the source of the username requires knowing what the other learning system sends in the LTI Request. Ideally, the other system will provide a preview feature for instructors to use to display items included in a launch request, and values set for them (for the previewer). In LON-CAPA, selecting ``User ID'' for the username source indicates the username will be whatever was assigned to the ``lis\_person\_sourcedid'' parameter, whereas selecting ``Email address'' means the username will be whatever was assigned to the ``lis\_person\_contact\_email\_primary'' parameter by the launch system. If neither of those are appropriate then ``Other'' can be selected, and the appropriate parameter name in the LTI Request can be entered in the textbox. A username will only be accepted from the launch data for session creation in LON-CAPA if the corresponding user has already been assigned a student role, and no privileged role(s) in the target course in LON-CAPA. What will happen if that condition is not met can either be to stop the launch, or to display the LON-CAPA login page, and allow a user to authenticate. The second of those is the same behavior as seen if ``No'' had originally been selected for ``Use identity?'. @@ -59,8 +59,13 @@ The endpoint LON-CAPA URL specified in t As the key and secret used for launch items (either in a course or a domain) will be unavailable to LON-CAPA nodes belonging to a different LON-CAPA domain, if LTI link protection is to be used for deep-linked items, it is requirement that the endpoint URL include the hostname of a LON-CAPA server in the course's domain. -Following the hostname, the remainder of the URL will have the format: /adm/launch/tiny/\$domain/uniqueID, where /tiny/\$domain/uniqueID is a shortened URL, -unique to the particular folder or resource in the specific course. +Following the hostname, the remainder of the URL will have the format: + +\begin{verbatim} +/adm/launch/tiny/$domain/uniqueID +\end{verbatim} + +where /tiny/\$domain/uniqueID is a shortened URL, unique to the particular folder or resource in the specific course. Course Coordinators can generate shortened URLs for items in a course by using: Course Editor $>$ Content Utilities $>$ ``Display/Set Shortened URLs for Deep-linking''; see: Short URLs section \ref{Docs_Short_URLs}