raeburn raeburn at source.lon-capa.org
Tue Feb 22 14:38:42 EST 2022

raeburn		Tue Feb 22 19:38:42 2022 EDT

Modified files:
Log:
- Escape underscores so domain manual can be built

@@ -46,7 +46,7 @@
\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?'.