From 595003693f5645e9463fa9979cbc1d9b4e450e21 Mon Sep 17 00:00:00 2001 From: Andreas Hefti Date: Fri, 13 Nov 2020 20:05:07 +0100 Subject: [PATCH 1/9] Update lmssetup.rst --- docs/lmssetup.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index ea07cbe5..33cd27f4 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -20,7 +20,8 @@ Usually this API comes as a REST or SOAP API with the core LMS implementation. SEB Server supports this course API's so far: - Open edX: The standard system `Open edX REST API `_. The SEB Server uses the "courses" endpoints to get course data. - - Moodle: The standard system `Moodle REST API `_. The SEB Server uses the "core_course" endpoints to get course data. + - Moodle (experimental): The standard system `Moodle REST API `_. The SEB Server uses the "core_course" endpoints to get course data. Note that Moodle binding is experimental in the current SEB Server version and there is no garantee to work correctly or to work + with an upcoming full Moodle integration in newer version. **SEB restriction API** @@ -57,9 +58,10 @@ SEB Server internally. Use the "Type" selector to specify the type of the LMS to - **Open edX**: This type is to bind an existing `Open edX `_ LMS system that is available on the Internet or intranet. The SEB Server tries to make use of the described API's of the Open edX system and if the automated SEB restriction feature wanted to be used the :ref:`lms-setup-edx-plugin-label` must be installed properly within the LMS. -- **Moodle**: This type is to bind an existing `Moodle `_ LMS system that is available on the Internet or intranet. The SEB +- **: Moodle**: This type is to bind an existing `Moodle `_ LMS system that is available on the Internet or intranet. The SEB Server tries to make use of the described API's of the Moodle system but there is currently no SEB restriction plugin available that works - with SEB Server. + with SEB Server. Note that Moodle binding is experimental in the current SEB Server version and there is no garantee to work correctly or to work + with an upcoming full Moodle integration in newer version. The "LMS Server Address" is the root URL to connect to the LMS server with HTTP over the Internet or intranet. This is usually the the URL that is also used with the Browser to connect to the main page of the LMS system. And additionally the credentials that has been created with the creation of the :ref:`lms-api-account-label` has to be set in the LMS Setup the make the SEB Server From dacda89bb995617b7163d04bc5112b48fb3b7b05 Mon Sep 17 00:00:00 2001 From: Andreas Hefti Date: Fri, 13 Nov 2020 20:05:47 +0100 Subject: [PATCH 2/9] Update lmssetup.rst --- docs/lmssetup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index 33cd27f4..aa62317b 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -21,7 +21,7 @@ Usually this API comes as a REST or SOAP API with the core LMS implementation. SEB Server supports this course API's so far: - Open edX: The standard system `Open edX REST API `_. The SEB Server uses the "courses" endpoints to get course data. - Moodle (experimental): The standard system `Moodle REST API `_. The SEB Server uses the "core_course" endpoints to get course data. Note that Moodle binding is experimental in the current SEB Server version and there is no garantee to work correctly or to work - with an upcoming full Moodle integration in newer version. +with an upcoming full Moodle integration in newer version. **SEB restriction API** From e24e3798b9e620add4897342787f3896912f4569 Mon Sep 17 00:00:00 2001 From: Andreas Hefti Date: Fri, 13 Nov 2020 20:11:13 +0100 Subject: [PATCH 3/9] Update lmssetup.rst --- docs/lmssetup.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index aa62317b..ab118a15 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -20,8 +20,7 @@ Usually this API comes as a REST or SOAP API with the core LMS implementation. SEB Server supports this course API's so far: - Open edX: The standard system `Open edX REST API `_. The SEB Server uses the "courses" endpoints to get course data. - - Moodle (experimental): The standard system `Moodle REST API `_. The SEB Server uses the "core_course" endpoints to get course data. Note that Moodle binding is experimental in the current SEB Server version and there is no garantee to work correctly or to work -with an upcoming full Moodle integration in newer version. + - Moodle (experimental): The standard system `Moodle REST API `_. The SEB Server uses the "core_course" endpoints to get course data. Note that Moodle binding is experimental in the current SEB Server version and there is no garantee to work correctly or to work with an upcoming full Moodle integration in newer version. **SEB restriction API** From 7845de0bb4be0a721b4f9e72183182dec0eae198 Mon Sep 17 00:00:00 2001 From: anhefti Date: Mon, 16 Nov 2020 12:02:50 +0100 Subject: [PATCH 4/9] update docu lmsSetup --- docs/lmssetup.rst | 29 +++++++++++++++++++---------- 1 file changed, 19 insertions(+), 10 deletions(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index ab118a15..ac805d64 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -8,15 +8,16 @@ Overview To be able to connect to a learning management system (LMS), to view and manage the courses provided by a LMS is an essential feature of the SEB Server. To setup an exam or e-assessment for SEB on SEB Server that is based on a course from a LMS, we have to make a binding to the course on the LMS. -This allows as to always get the actual course data from LMS like, start- end-time, name and others. If we furthermore want to be able to automatically -restrict the course for SEB access only we also need to have proper integration API's in place on both sides, the LMS and the SEB Server. -This integration is separated into two main features so far. This are: +This is also used to always get the actual course data from LMS like start- end-time, name and others. +Another feature of SEB Server that needs a LMS communication is the SEB restriction. A SEB restriction will restrict course access on the LMS only +for connection with Safe Exam Browser and will also check if a Safe Exam Browser of trust is used and the right configuration is used by the +Safe Exam Browser that was defines for the exam on the SEB Server. **Course API** This API, provided by the LMS, is used by the SEB Server to query the available courses and the needed data for each course. This API -is essential to be able to import a course from the LMS as an exam into SEB Server and configure the course as an e-assessment with SEB. -Usually this API comes as a REST or SOAP API with the core LMS implementation. +is needed to be able to import a course from the LMS as an exam into SEB Server and configure the course as an e-assessment with SEB. +Usually this API comes as a REST or SOAP API with the core LMS implementation or a plugin. SEB Server supports this course API's so far: - Open edX: The standard system `Open edX REST API `_. The SEB Server uses the "courses" endpoints to get course data. @@ -123,7 +124,7 @@ that has to be set on the existing LMS Setup on the SEB Server. - Use the Filter above the list to find the specified LMS Setup. - Select the LMS Setup from the list and use the "Edit LMS Setup" action from the right action pane to open the LMS Setup in edit mode. - Set the new credentials and make sure, the LMS Setup is still active. -- Use the "Save LMS Setup" action form the right action pane to save the changes and test the conneciton. +- Use the "Save LMS Setup" action form the right action pane to save the changes and test the connection. .. note:: If some form attributes are missing or not correct, the SEB Server system will respond with the usual form validation errors. @@ -146,14 +147,20 @@ the setup and exams on the SEB Server for this LMS. - Navigate also to "Exam" and make sure that all previously imported exams from the deactivated LMS Setup are not available anymore. .. _lms-api-account-label: + API Access Account on LMS -------------------------- .. _lms-api-account-edx-label: -**Open edX API Access Account** + +**Create Open edX API Access Account** + + To be able to create an API access-account on Open edX you need a user-account with staff and administration privileges. Following the steps below: +For Open edX Hawthorn and Ironwood versions: + - Login to Open edX LMS Administration with an appropriate user-account that has administration rights. And find the Users section: .. image:: images/lmssetup/openEdxAPIAccess1.bmp @@ -181,13 +188,15 @@ Once the client registration was successful the client id and client secret can .. _lms-setup-rest-plugin-label: + Install SEB restriction API plugin ---------------------------------- .. _lms-setup-edx-plugin-label: + **Open edX SEB Plugin** -There is a SEB integration plugin developed and supported by `eduNEXT `_. - - `Documentation `_ - - `Repository `_ + There is a SEB integration plugin developed and supported by `eduNEXT `_. + - `Documentation `_ + - `Repository `_ From 7a0ee155371abecdea869dfae7b7f7c27c0165c3 Mon Sep 17 00:00:00 2001 From: anhefti Date: Mon, 16 Nov 2020 12:32:32 +0100 Subject: [PATCH 5/9] fix docu refs? --- docs/lmssetup.rst | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index ac805d64..781317c5 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -39,7 +39,7 @@ Regardless if a supported LMS is missing the SEB integration plugin installation setup will be possible but without automated SEB restriction feature. To be able connect to an LMS from SEB Server, we need to create an API access-acount on the LMS side that can be used by the SEB Server to -access the API of the LMS. How to do this for the different supported types of LMS see ref:`lms-api-account-label` +access the API of the LMS. How to do this for the different supported types of LMS see :ref:`lms-api-account-label` After such an account was created the account credentials, username and password, can be used by the SEB Server to connect to the LMS. Therefore we need to create a LMS Setup on the SEB Server. @@ -56,8 +56,7 @@ SEB Server internally. Use the "Type" selector to specify the type of the LMS to as exams like they would exist. But note the a SEB client that is trying to connect to such a course would not be able to connect to the LMS since it is not existing. But a SEB client is able to download the defined exam configuration for testing. - **Open edX**: This type is to bind an existing `Open edX `_ LMS system that is available on the Internet or intranet. The SEB - Server tries to make use of the described API's of the Open edX system and if the automated SEB restriction feature wanted to be used the - :ref:`lms-setup-edx-plugin-label` must be installed properly within the LMS. + Server tries to make use of the described API's of the Open edX system and if the automated SEB restriction feature wanted to be used the :ref:`lms-setup-edx-plugin-label` must be installed properly within the LMS. - **: Moodle**: This type is to bind an existing `Moodle `_ LMS system that is available on the Internet or intranet. The SEB Server tries to make use of the described API's of the Moodle system but there is currently no SEB restriction plugin available that works with SEB Server. Note that Moodle binding is experimental in the current SEB Server version and there is no garantee to work correctly or to work @@ -94,14 +93,14 @@ Use Cases A new Open edX system has been installed within your institution and to be able to use the system also for e-assessments with SEB and SEB Server, you have to bind the LMS to the SEB Server. -- If not already done, install the :ref:`lms-setup-edx-plugin-label` on the Open edX system first. -- On the Open edX system create an :ref:`lms-api-account-edx-label`. +- If not already done, install the :ref:`lms-setup-edx-plugin-label` on the Open edX system first. +- On the Open edX system create an :ref:`lms-api-account-edx-label` . - Sign into SEB Server with your institutional administrator role account. - Navigate to "Exam Administration" / "LMS Setup" within the navigation on the left hand side. - Use the "Add LMS Setup" action from the right action pane to open a LMS Setup creation form. - Give a unique name to the new LMS Setup for internally identification. - Set the main URL that points to the new LMS system. This is usually the the URL that is also used with the Browser to connect to the main page of the LMS system -- Set the API credentials that has been creates within step two. +- Set the API credentials that has been creates within step two (client-id, secret). - Use the "Activate LMS Setup" action on the right action pane to test, save and activate the new LMS Setup within one step. .. note:: From c9bdb4c23e5b8a23aae9a981fe60ec5e3da17191 Mon Sep 17 00:00:00 2001 From: anhefti Date: Mon, 16 Nov 2020 12:42:21 +0100 Subject: [PATCH 6/9] fixed lmssetup refs? --- docs/lmssetup.rst | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index 781317c5..9c2807c3 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -56,7 +56,11 @@ SEB Server internally. Use the "Type" selector to specify the type of the LMS to as exams like they would exist. But note the a SEB client that is trying to connect to such a course would not be able to connect to the LMS since it is not existing. But a SEB client is able to download the defined exam configuration for testing. - **Open edX**: This type is to bind an existing `Open edX `_ LMS system that is available on the Internet or intranet. The SEB - Server tries to make use of the described API's of the Open edX system and if the automated SEB restriction feature wanted to be used the :ref:`lms-setup-edx-plugin-label` must be installed properly within the LMS. + Server tries to make use of the above described API's of the Open edX system. + + .. note:: + if you want to use the automated SEB restriction feature, the :ref:`lms-setup-edx-plugin-label` must be installed properly within the LMS. + - **: Moodle**: This type is to bind an existing `Moodle `_ LMS system that is available on the Internet or intranet. The SEB Server tries to make use of the described API's of the Moodle system but there is currently no SEB restriction plugin available that works with SEB Server. Note that Moodle binding is experimental in the current SEB Server version and there is no garantee to work correctly or to work @@ -93,8 +97,12 @@ Use Cases A new Open edX system has been installed within your institution and to be able to use the system also for e-assessments with SEB and SEB Server, you have to bind the LMS to the SEB Server. -- If not already done, install the :ref:`lms-setup-edx-plugin-label` on the Open edX system first. -- On the Open edX system create an :ref:`lms-api-account-edx-label` . +.. note:: + If not already done, install the :ref:`lms-setup-edx-plugin-label` on the Open edX system first. + +.. note:: + If you don't already have an API access account on Open edX side, create an :ref:`lms-api-account-edx-label` . + - Sign into SEB Server with your institutional administrator role account. - Navigate to "Exam Administration" / "LMS Setup" within the navigation on the left hand side. - Use the "Add LMS Setup" action from the right action pane to open a LMS Setup creation form. @@ -154,11 +162,9 @@ API Access Account on LMS **Create Open edX API Access Account** +To be able to create an API access-account on Open edX you need a user-account with staff and administration privileges. - -To be able to create an API access-account on Open edX you need a user-account with staff and administration privileges. Following the steps below: - -For Open edX Hawthorn and Ironwood versions: +**For Open edX Hawthorn and Ironwood versions following the steps below::** - Login to Open edX LMS Administration with an appropriate user-account that has administration rights. And find the Users section: From 8d98ee2100a1c0156068331fd20db08301bbd252 Mon Sep 17 00:00:00 2001 From: anhefti Date: Mon, 16 Nov 2020 12:49:27 +0100 Subject: [PATCH 7/9] fixed? --- docs/lmssetup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index 9c2807c3..fd38e545 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -59,7 +59,7 @@ SEB Server internally. Use the "Type" selector to specify the type of the LMS to Server tries to make use of the above described API's of the Open edX system. .. note:: - if you want to use the automated SEB restriction feature, the :ref:`lms-setup-edx-plugin-label` must be installed properly within the LMS. + if you want to use the automated SEB restriction feature, the :ref:`` must be installed properly within the LMS. - **: Moodle**: This type is to bind an existing `Moodle `_ LMS system that is available on the Internet or intranet. The SEB Server tries to make use of the described API's of the Moodle system but there is currently no SEB restriction plugin available that works From 26e9f6d3944ad1da309d8139cf1a88081309db91 Mon Sep 17 00:00:00 2001 From: anhefti Date: Mon, 16 Nov 2020 13:20:12 +0100 Subject: [PATCH 8/9] fixed docu? --- docs/lmssetup.rst | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index fd38e545..453c8417 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -52,18 +52,18 @@ is only able to see and create LMS Setup for its own institution. The name of th SEB Server internally. Use the "Type" selector to specify the type of the LMS to bind to the SEB Server within the LMS Setup. Currently supported are: - **Testing**: This is for testing purposes only and can be used to mock a LMS to test exam settings. This type provides some mock-up courses within the - LMS API of the SEB Server that can be seen in the LMS Exam Lookup once the LMS text setup is active. This mock-up courses can be imported and configuraed + LMS API of the SEB Server that can be seen in the LMS Exam Lookup once the LMS text setup is active. This mock-up courses can be imported and configured as exams like they would exist. But note the a SEB client that is trying to connect to such a course would not be able to connect to the LMS since it is not existing. But a SEB client is able to download the defined exam configuration for testing. - **Open edX**: This type is to bind an existing `Open edX `_ LMS system that is available on the Internet or intranet. The SEB Server tries to make use of the above described API's of the Open edX system. .. note:: - if you want to use the automated SEB restriction feature, the :ref:`` must be installed properly within the LMS. + if you want to use the automated SEB restriction feature, the `Open edX SEB Plugin `_ must be installed properly on the LMS. - **: Moodle**: This type is to bind an existing `Moodle `_ LMS system that is available on the Internet or intranet. The SEB Server tries to make use of the described API's of the Moodle system but there is currently no SEB restriction plugin available that works - with SEB Server. Note that Moodle binding is experimental in the current SEB Server version and there is no garantee to work correctly or to work + with SEB Server. Note that Moodle binding is experimental in the current SEB Server version and there is no guarantee to work correctly or to work with an upcoming full Moodle integration in newer version. The "LMS Server Address" is the root URL to connect to the LMS server with HTTP over the Internet or intranet. This is usually the the URL that is @@ -97,12 +97,8 @@ Use Cases A new Open edX system has been installed within your institution and to be able to use the system also for e-assessments with SEB and SEB Server, you have to bind the LMS to the SEB Server. -.. note:: - If not already done, install the :ref:`lms-setup-edx-plugin-label` on the Open edX system first. - -.. note:: - If you don't already have an API access account on Open edX side, create an :ref:`lms-api-account-edx-label` . - +- If not already done, install the `Open edX SEB Plugin `_ on the Open edX system first. +- If you don't already have an API access account on Open edX side, ``_ - Sign into SEB Server with your institutional administrator role account. - Navigate to "Exam Administration" / "LMS Setup" within the navigation on the left hand side. - Use the "Add LMS Setup" action from the right action pane to open a LMS Setup creation form. From 8c8d0b97c7aa1805d7712ef4a04cfecf3d6e9065 Mon Sep 17 00:00:00 2001 From: anhefti Date: Mon, 16 Nov 2020 13:24:09 +0100 Subject: [PATCH 9/9] last docu fixes --- docs/lmssetup.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index 453c8417..7e492cce 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -59,7 +59,7 @@ SEB Server internally. Use the "Type" selector to specify the type of the LMS to Server tries to make use of the above described API's of the Open edX system. .. note:: - if you want to use the automated SEB restriction feature, the `Open edX SEB Plugin `_ must be installed properly on the LMS. + If you want to use the automated SEB restriction feature too, the `Open edX SEB Plugin `_ must be installed properly on the LMS. - **: Moodle**: This type is to bind an existing `Moodle `_ LMS system that is available on the Internet or intranet. The SEB Server tries to make use of the described API's of the Moodle system but there is currently no SEB restriction plugin available that works @@ -98,7 +98,7 @@ A new Open edX system has been installed within your institution and to be able you have to bind the LMS to the SEB Server. - If not already done, install the `Open edX SEB Plugin `_ on the Open edX system first. -- If you don't already have an API access account on Open edX side, ``_ +- If you don't already have an API access account on Open edX side, `create one `_ - Sign into SEB Server with your institutional administrator role account. - Navigate to "Exam Administration" / "LMS Setup" within the navigation on the left hand side. - Use the "Add LMS Setup" action from the right action pane to open a LMS Setup creation form.