feat!: decouple LTI 1.3 launch from LtiConsumerXBlock
Purpose ------- The purpose of these changes is to decouple the LTI 1.3 launch from the LtiConsumerXBlock. It is in accordance with the ADR "0007 Decouple LTI 1.3 Launch from XBlock and edX Platform", which is currently under review. The pull request for the ADR is here: https://github.com/openedx/xblock-lti-consumer/pull/281. The general premise of these changes is to shift the responsibility of defining key launch claims to users of the library. Such claims include user ID, user role, resource link ID, etc. Prior to this change, this context was defined directly in the launch view by referencing XBlock fields and functions, thereby tying the LTI 1.3 launch to the XBlock. By shifting the responsibility out of the view, we will be able to genericize the launch and make it functional in more contexts than just the XBlock and the XBlock runtime. In short, the key launch claims are encoded in an instance of a data class Lti1p3LaunchData. Users of the library will instantiate this class with necessary launch data to it and pass the instance to various methods of the Python API to communicate the data to the library. Please see the aforementioned ADR for more details about this decoupling strategy. Note that the majority of these changes affect only the basic LTI 1.3 launch. There have largely been no changes to LTI 1.3 Advantage Services. The one exception is the Deep Linking content launch endpoint. This is because this launch is implemented in the basic LTI 1.3 launch, and it was necessary to make the same changes to the deep linking content launch to ensure that it works properly. Otherwise, LTI 1.3 Advantage Services are out of scope of these changes. Change Summary for Developers ----------------------------- Below is a summary of changes contained in this pull request. * added an Lti1p3LaunchData data class * added caching for Lti1p3LaunchData to limit data sent in request query or form parameters * BREAKING CHANGE: modified Python API methods to take Lti1p3LaunchData as a required argument ** get_lti_1p3_launch_info ** get_lti_1p3_launch_start_url ** get_lti_1p3_content_url * replaced references to LtiConsumerXBlock.location with Lti1p3LaunchData.config_id * removed definition of key LTI 1.3 claims from the launch_gate_endpoint and instantiated Lti1p3LaunchData from within the LtiConsumerXBlock instead * added a required launch_data_key request query parameter to the deep_linking_content_endpoint and refactored associated templates and template tags to pass this parameter in the request to the view Change Summary for Course Staff and Instructors ----------------------------------------------- The only changes relevant for course staff and instructors is that the access token and keyset URLs displayed in Studio have changed in format. The old format was: Access Token URL: https://courses.edx.org/api/lti_consumer/v1/token/block-v1:edX+999+2022Q3+type@lti_consumer+block@714c10a5e4df452da9d058788acb56be Keyset URL: https://courses.edx.org/api/lti_consumer/v1/public_keysets/block-v1:edX+999+2022Q3+type@lti_consumer+block@714c10a5e4df452da9d058788acb56be The new format is: Access Token URL: https://courses.edx.org/api/lti_consumer/v1/token/c3f6af60-dbf2-4f85-8974-4ff870068d43 Keyset URL: https://courses.edx.org/api/lti_consumer/v1/public_keysets/c3f6af60-dbf2-4f85-8974-4ff870068d43 The difference is in the slug at the end of the URL. In the old format, the slug was the UsageKey of the XBlock associated with the LTI integration. In the new format, the slug is the config_id of the LtiConfiguration associated with the LTI integration. This is an iterative step toward decoupling the access_token_endpoint and the public_keyset_endpoint views from the XBlock location field. The XBlock location field appears as the usage_key parameter to both views. We cannot simply remove the usage_key parameter from the views, because existing LTI 1.3 integrations may have been created using the old format, and we need to maintain backwards compatibility. This change, however, prevents new integrations from being created that are coupled to the XBlock. In the future, we may address integrations that use the old format to fully decouple the XBlock from the views. Testing ------- Unit tests were added for all changes. In addition, manual testing was performed using the instructions in the documents listed below. * https://github.com/openedx/xblock-lti-consumer#lti-13 * https://openedx.atlassian.net/wiki/spaces/COMM/pages/1858601008/How+to+run+the+LTI+Validation+test Resources --------- JIRA: MST-1603: https://2u-internal.atlassian.net/browse/MST-1603 BREAKING CHANGE
Showing
- CHANGELOG.rst 21 additions, 0 deletionsCHANGELOG.rst
- lti_consumer/__init__.py 1 addition, 1 deletionlti_consumer/__init__.py
- lti_consumer/api.py 72 additions, 23 deletionslti_consumer/api.py
- lti_consumer/data.py 46 additions, 0 deletionslti_consumer/data.py
- lti_consumer/lti_1p1/tests/test_consumer.py 1 addition, 1 deletionlti_consumer/lti_1p1/tests/test_consumer.py
- lti_consumer/lti_1p1/tests/test_oauth.py 1 addition, 1 deletionlti_consumer/lti_1p1/tests/test_oauth.py
- lti_consumer/lti_1p3/consumer.py 67 additions, 22 deletionslti_consumer/lti_1p3/consumer.py
- lti_consumer/lti_1p3/exceptions.py 4 additions, 0 deletionslti_consumer/lti_1p3/exceptions.py
- lti_consumer/lti_1p3/tests/test_consumer.py 110 additions, 24 deletionslti_consumer/lti_1p3/tests/test_consumer.py
- lti_consumer/lti_xblock.py 61 additions, 9 deletionslti_consumer/lti_xblock.py
- lti_consumer/plugin/compat.py 0 additions, 19 deletionslti_consumer/plugin/compat.py
- lti_consumer/plugin/views.py 96 additions, 66 deletionslti_consumer/plugin/views.py
- lti_consumer/templates/html/lti-dl/render_dl_content.html 1 addition, 1 deletionlti_consumer/templates/html/lti-dl/render_dl_content.html
- lti_consumer/templates/html/lti-dl/render_lti_resource_link.html 3 additions, 1 deletion...sumer/templates/html/lti-dl/render_lti_resource_link.html
- lti_consumer/templatetags/get_dl_lti_launch_url.py 8 additions, 9 deletionslti_consumer/templatetags/get_dl_lti_launch_url.py
- lti_consumer/tests/test_utils.py 96 additions, 0 deletionslti_consumer/tests/test_utils.py
- lti_consumer/tests/unit/plugin/test_views.py 106 additions, 27 deletionslti_consumer/tests/unit/plugin/test_views.py
- lti_consumer/tests/unit/plugin/test_views_lti_ags.py 11 additions, 14 deletionslti_consumer/tests/unit/plugin/test_views_lti_ags.py
- lti_consumer/tests/unit/plugin/test_views_lti_deep_linking.py 56 additions, 12 deletions...consumer/tests/unit/plugin/test_views_lti_deep_linking.py
- lti_consumer/tests/unit/plugin/test_views_lti_nrps.py 2 additions, 5 deletionslti_consumer/tests/unit/plugin/test_views_lti_nrps.py
Loading
Please register or sign in to comment