--- 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}