diff --git a/docs/certifications.rst b/docs/certifications.rst new file mode 100644 index 00000000..5cbe4d2c --- /dev/null +++ b/docs/certifications.rst @@ -0,0 +1,66 @@ +.. _certifications-label: + +Certifications +==================== + +Overview +-------- + +To be bale to upload and store certificates within SEB Server is a new feature since SEB Server version 1.2. This allows an institutional administrator +or an exam administrator to upload and store certificates for further use within SEB Server. + +.. note:: + Certificates uploaded to SEB Server are stored in a secured certificate-store that is stored within the data base rather then a + usual file. The certificated store is password secured and only the binary data of the certificate store is places into the + databease for securty reasons. + +Once a certificate has been uploaded to SEB Server it can be used for various other features of SEB Server where a certificate is needed. +One feature that also comes with the SEB Server version 1.2 is the ability to encrypt a connection configuration with a certificate +that has the right purpose (Identity) to do so. If you need this feature already, please have a look at: :ref:`connection-configuration-label` +Other planed features are the import of certificate encrypted exam configurations as well as to embed certificates within a exam configuration +to allow certificate pinning between SEB and LMS. + +There is currently certificate upload support for two version of certificates: + +**PEM** + +This are usually non password protected certificates in different file-formats. SEB Server currently supports the following PEM file-formats: + +- .pem +- .crt +- .cer + +**PKCS12** + +This are usually password protected certificates in different file-formats. SEB Server currently supports the following PKCS12 file-formats: + +- .p12 +- .pfx + +.. image:: images/certificates/cert_list.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/certificates/cert_list.png + + +Use Cases +--------- + +**Upload a certificate** + +- To upload and store a certificate of supported file type, please open the "SEB Configuration" section and select the "Certificates" page +- You will see the list of known certificates from the SEB Server like in the picture above. +- Choose "Import Certificate" from the right action pane and the upload dialog will open. +- Within the upload dialog, select the certificate file on your local machine that you want to upload. +- If the certificate is password protected, you will need to give the password to upload the certificate. +- Chlick on "OK" to start the import. +- If the import is successful the imported certificate will show up in the list. Otherwise SEB Server will display an error message with the reason of failure. + +**Remove / delete a certificate** + +- To permanently delete a stored certificate on SEB Server, please open the "SEB Configuration" section and select the "Certificates" page +- You will see the list of known certificates from the SEB Server like in the picture above. +- Please select the certificate you want to remove. +- Choose "Remove Selected Certificates" from the right action pane and a configuration dialog will appear. +- If you are sure to delete the selected certificate(s), click on "OK" to delete. +- The deleted certificates disappear form the certificates list. + diff --git a/docs/configurations.rst b/docs/configurations.rst index c43995bf..1f77d69e 100644 --- a/docs/configurations.rst +++ b/docs/configurations.rst @@ -19,10 +19,15 @@ with context defines default values and also to be able to only see change the a This feature is currently in an experimental state and may be changed and / or expanded within future releases of SEB Server. See :ref:`config-template-label` +An new feature since SEB Server version 1.2 is the integrated certificate store where an administator is able to upload and register +certificates. The certificates can then be used to encrypt and secure a connection configuration for example. Or as planed for another +SEB Server release, to embed into an exam configuration for SEB to allow certificate pinning on SEB - LMS communication. + .. toctree:: :maxdepth: 1 connection_config exam_config - config_template \ No newline at end of file + config_template + certifications \ No newline at end of file diff --git a/docs/connection_config.rst b/docs/connection_config.rst index f49919c7..05d5c6b2 100644 --- a/docs/connection_config.rst +++ b/docs/connection_config.rst @@ -55,6 +55,7 @@ Short description of all attributes of a connection configuration: **Starting an Exam**; Will cause SEB to use this connection configuration settings on startup but won't change local SEB settings. **Configuring a connection**; Will cause SEB to use this connection configuration settings and also save it as local SEB settings. - **Configuration Password**: Used to encrypt the connection configuration with a password. A SEB client will prompt this password while loading a password protected connection configuration. +- **Encrypt with Certificate**: Since version 1.2. Used to encrypt the connection configuration with a certificate. The same certificate must be known by a SEB client to be able to load the configuration. - **With Fallback**: Select this to see and define a fallback strategy for SEB clients using this connection configuration in case of SEB Server service unavailability. - **Fallback URL**: Defines a start URL that is loaded by the SEB client in a fallback case. - **Connection Attempts**: Defines the number of attempts a SEB client will try to unsuccessfully connect to the SEB Server service until it switches to the fallback case. @@ -89,7 +90,7 @@ configuration settings in the following ways: - Connection configuration with "Starting an Exam" setting and fallback strategy: Show warning with options "retry", "fallback" (load Fallback URL) and "quit". - + Use Cases --------- @@ -135,3 +136,21 @@ that connects with this connection configuration will then receive an HTTP 401 U - Now use the "Deactivate Connection Configuration" action from the right action pane to deactivate the connection configuration. - The connection configuration is now deactivated and SEB client using this connection configuration are not able to connect to SEB Server anymore. +**Encrypt the Connection Configuration by password or certificate** + +To secure the used connection configuration you want to encrypt it with either password or certificate encryption. If you encrypt a connection +configuration by password, SEB will promt the user for the password while loading the configuration whereas by using certificate encryption, +a SEB client must know the same certificate that is been used for encryption while loading the configuration. + +- Sign in as an Institutional Administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main-menu on the left. +- Create an new connection configuration or use the list filter and / or the list navigation to find the needed connection configuration. +- Fill in the settings as usual and for password encryption define a password in the "Configuration Password" field and confirm the password in the "Confirm Password" field. +- For a certificate based encryption select one of the given certificates within the "Encrypt with Certificate" setting. +- To upload new certificates that can be used for encryption, please refer to: :ref:`certifications-label` +- "Use asymmetric only encryption" if you have use SEB Clients with version before 2.2. For more details on this subject please see: `SEB Configuration `_ +- Save and activate the connection configuration. The connection configuration will then be encrypted by either password or certificate on export. + +.. image:: images/connection_config/encrypt.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/connection_config/encrypt.png + diff --git a/docs/files/webservice_seb-server.xml b/docs/files/webservice_seb-server.xml new file mode 100644 index 00000000..7c723a2d --- /dev/null +++ b/docs/files/webservice_seb-server.xml @@ -0,0 +1,2 @@ + +webservice_seb-serverwebservice_SEB-Serversystematto/h5p:addembedatto/recordrtc:recordaudioatto/recordrtc:recordvideoauth/oauth2:managelinkedloginsblock/activity_modules:addinstanceblock/activity_results:addinstanceblock/admin_bookmarks:addinstanceblock/admin_bookmarks:myaddinstanceblock/badges:addinstanceblock/badges:myaddinstanceblock/blog_menu:addinstanceblock/blog_recent:addinstanceblock/blog_tags:addinstanceblock/calendar_month:addinstanceblock/calendar_month:myaddinstanceblock/calendar_upcoming:addinstanceblock/calendar_upcoming:myaddinstanceblock/comments:addinstanceblock/comments:myaddinstanceblock/completionstatus:addinstanceblock/course_list:addinstanceblock/course_list:myaddinstanceblock/course_summary:addinstanceblock/feedback:addinstanceblock/globalsearch:addinstanceblock/globalsearch:myaddinstanceblock/glossary_random:addinstanceblock/glossary_random:myaddinstanceblock/html:addinstanceblock/html:myaddinstanceblock/login:addinstanceblock/lp:addinstanceblock/lp:myaddinstanceblock/mentees:addinstanceblock/mentees:myaddinstanceblock/mnet_hosts:addinstanceblock/mnet_hosts:myaddinstanceblock/myoverview:myaddinstanceblock/myprofile:addinstanceblock/myprofile:myaddinstanceblock/navigation:addinstanceblock/navigation:myaddinstanceblock/news_items:addinstanceblock/news_items:myaddinstanceblock/onlinesurvey:addinstanceblock/onlinesurvey:myaddinstanceblock/onlinesurvey:viewblock/onlinesurvey:view_debugdetailsblock/online_users:addinstanceblock/online_users:myaddinstanceblock/online_users:viewlistblock/opencast:addinstanceblock/opencast:addltiblock/opencast:addltiepisodeblock/opencast:addvideoblock/opencast:createseriesforcourseblock/opencast:defineseriesforcourseblock/opencast:deleteeventblock/opencast:myaddinstanceblock/opencast:unassigneventblock/opencast:viewunpublishedvideosblock/private_files:addinstanceblock/private_files:myaddinstanceblock/quiz_results:addinstanceblock/recent_activity:addinstanceblock/recent_activity:viewaddupdatemoduleblock/recent_activity:viewdeletemoduleblock/recentlyaccessedcourses:myaddinstanceblock/recentlyaccesseditems:myaddinstanceblock/rss_client:addinstanceblock/rss_client:manageanyfeedsblock/rss_client:manageownfeedsblock/rss_client:myaddinstanceblock/search_forums:addinstanceblock/section_links:addinstanceblock/selfcompletion:addinstanceblock/settings:addinstanceblock/settings:myaddinstanceblock/site_main_menu:addinstanceblock/social_activities:addinstanceblock/starredcourses:myaddinstanceblock/tag_flickr:addinstanceblock/tags:addinstanceblock/tags:myaddinstanceblock/tag_youtube:addinstanceblock/timeline:myaddinstancebooktool/exportimscp:exportbooktool/importhtml:importbooktool/print:printcontenttype/h5p:accesscontenttype/h5p:uploadcontenttype/h5p:useeditorenrol/category:configenrol/category:synchronisedenrol/cohort:configenrol/cohort:unenrolenrol/database:configenrol/database:unenrolenrol/flatfile:manageenrol/flatfile:unenrolenrol/guest:configenrol/imsenterprise:configenrol/ldap:manageenrol/lti:configenrol/lti:unenrolenrol/manual:configenrol/manual:enrolenrol/manual:manageenrol/manual:unenrolenrol/manual:unenrolselfenrol/meta:configenrol/meta:selectaslinkedenrol/meta:unenrolenrol/mnet:configenrol/paypal:configenrol/paypal:manageenrol/paypal:unenrolenrol/paypal:unenrolselfenrol/self:configenrol/self:holdkeyenrol/self:manageenrol/self:unenrolenrol/self:unenrolselfformat/columns:changecolumnsformat/grid:changeimagecontainersizeformat/grid:changeimagecontainerstyleformat/grid:changeimageresizemethodformat/topcoll:changecolourformat/topcoll:changelayoutformat/topcoll:changetogglealignmentformat/topcoll:changetoggleiconsetforumreport/summary:viewforumreport/summary:viewallgradeexport/ods:publishgradeexport/ods:viewgradeexport/txt:publishgradeexport/txt:viewgradeexport/xls:publishgradeexport/xls:viewgradeexport/xml:publishgradeexport/xml:viewgradeimport/csv:viewgradeimport/direct:viewgradeimport/xml:publishgradeimport/xml:viewgradereport/grader:viewgradereport/history:viewgradereport/outcomes:viewgradereport/overview:viewgradereport/singleview:viewgradereport/user:viewmessage/airnotifier:managedevicemod/assign:addinstancemod/assign:editothersubmissionmod/assign:exportownsubmissionmod/assign:grademod/assign:grantextensionmod/assign:manageallocationsmod/assign:managegradesmod/assign:manageoverridesmod/assignment:addinstancemod/assignment:exportownsubmissionmod/assignment:grademod/assignment:submitmod/assignment:viewmod/assign:receivegradernotificationsmod/assign:releasegradesmod/assign:revealidentitiesmod/assign:reviewgradesmod/assign:showhiddengradermod/assign:submitmod/assign:viewmod/assign:viewblinddetailsmod/assign:viewgradesmod/book:addinstancemod/book:editmod/book:readmod/book:viewhiddenchaptersmod/chat:addinstancemod/chat:chatmod/chat:deletelogmod/chat:exportparticipatedsessionmod/chat:exportsessionmod/chat:readlogmod/chat:viewmod/choice:addinstancemod/choice:choosemod/choice:deleteresponsesmod/choice:downloadresponsesmod/choice:readresponsesmod/choice:viewmod/data:addinstancemod/data:approvemod/data:commentmod/data:exportallentriesmod/data:exportentrymod/data:exportownentrymod/data:exportuserinfomod/data:managecommentsmod/data:manageentriesmod/data:managetemplatesmod/data:manageuserpresetsmod/data:ratemod/data:viewmod/data:viewallratingsmod/data:viewalluserpresetsmod/data:viewanyratingmod/data:viewentrymod/data:viewratingmod/data:writeentrymod/feedback:addinstancemod/feedback:completemod/feedback:createprivatetemplatemod/feedback:createpublictemplatemod/feedback:deletesubmissionsmod/feedback:deletetemplatemod/feedback:edititemsmod/feedback:mapcoursemod/feedback:receivemailmod/feedback:viewmod/feedback:viewanalysepagemod/feedback:viewreportsmod/folder:addinstancemod/folder:managefilesmod/folder:viewmod/forum:addinstancemod/forum:addnewsmod/forum:addquestionmod/forum:allowforcesubscribemod/forum:canoverridecutoffmod/forum:canoverridediscussionlockmod/forum:canposttomygroupsmod/forum:cantogglefavouritemod/forum:createattachmentmod/forum:deleteanypostmod/forum:deleteownpostmod/forum:editanypostmod/forum:exportdiscussionmod/forum:exportforummod/forum:exportownpostmod/forum:exportpostmod/forum:grademod/forum:managesubscriptionsmod/forum:movediscussionsmod/forum:pindiscussionsmod/forum:postprivatereplymod/forum:postwithoutthrottlingmod/forum:ratemod/forum:readprivaterepliesmod/forum:replynewsmod/forum:replypostmod/forum:splitdiscussionsmod/forum:startdiscussionmod/forum:viewallratingsmod/forum:viewanyratingmod/forum:viewdiscussionmod/forum:viewhiddentimedpostsmod/forum:viewqandawithoutpostingmod/forum:viewratingmod/forum:viewsubscribersmod/glossary:addinstancemod/glossary:approvemod/glossary:commentmod/glossary:exportmod/glossary:exportentrymod/glossary:exportownentrymod/glossary:importmod/glossary:managecategoriesmod/glossary:managecommentsmod/glossary:manageentriesmod/glossary:ratemod/glossary:viewmod/glossary:viewallratingsmod/glossary:viewanyratingmod/glossary:viewratingmod/glossary:writemod/h5pactivity:addinstancemod/h5pactivity:reviewattemptsmod/h5pactivity:submitmod/h5pactivity:viewmod/imscp:addinstancemod/imscp:viewmod/label:addinstancemod/label:viewmod/lesson:addinstancemod/lesson:editmod/lesson:grademod/lesson:managemod/lesson:manageoverridesmod/lesson:viewmod/lesson:viewreportsmod/lti:addcoursetoolmod/lti:addinstancemod/lti:addmanualinstancemod/lti:addpreconfiguredinstancemod/lti:adminmod/lti:managemod/lti:requesttooladdmod/lti:viewmod/page:addinstancemod/page:viewmod/quiz:addinstancemod/quiz:attemptmod/quiz:deleteattemptsmod/quiz:emailconfirmsubmissionmod/quiz:emailnotifysubmissionmod/quiz:emailwarnoverduemod/quiz:grademod/quiz:ignoretimelimitsmod/quiz:managemod/quiz:manageoverridesmod/quiz:previewmod/quiz:regrademod/quiz:reviewmyattemptsmod/resource:addinstancemod/resource:viewmod/scorm:addinstancemod/scorm:deleteownresponsesmod/scorm:deleteresponsesmod/scorm:savetrackmod/scorm:skipviewmod/scorm:viewreportmod/scorm:viewscoresmod/survey:addinstancemod/survey:downloadmod/survey:participatemod/survey:readresponsesmod/url:addinstancemod/url:viewmod/wiki:addinstancemod/wiki:createpagemod/wiki:editcommentmod/wiki:editpagemod/wiki:managecommentmod/wiki:managefilesmod/wiki:managewikimod/wiki:overridelockmod/wiki:viewcommentmod/wiki:viewpagemod/workshop:addinstancemod/workshop:allocatemod/workshop:deletesubmissionsmod/workshop:editdimensionsmod/workshop:exportsubmissionsmod/workshop:ignoredeadlinesmod/workshop:manageexamplesmod/workshop:overridegradesmod/workshop:peerassessmod/workshop:publishsubmissionsmod/workshop:submitmod/workshop:switchphasemod/workshop:viewmod/workshop:viewallassessmentsmod/workshop:viewallsubmissionsmod/workshop:viewauthornamesmod/workshop:viewauthorpublishedmod/workshop:viewpublishedsubmissionsmod/workshop:viewreviewernamesmoodle/analytics:listinsightsmoodle/analytics:listowninsightsmoodle/analytics:managemodelsmoodle/backup:anonymisemoodle/backup:backupactivitymoodle/backup:backupcoursemoodle/backup:backupsectionmoodle/backup:backuptargetimportmoodle/backup:configuremoodle/backup:downloadfilemoodle/backup:userinfomoodle/badges:awardbadgemoodle/badges:configurecriteriamoodle/badges:configuredetailsmoodle/badges:configuremessagesmoodle/badges:createbadgemoodle/badges:deletebadgemoodle/badges:earnbadgemoodle/badges:manageglobalsettingsmoodle/badges:manageownbadgesmoodle/badges:revokebadgemoodle/badges:viewawardedmoodle/badges:viewbadgesmoodle/badges:viewotherbadgesmoodle/block:editmoodle/block:viewmoodle/blog:createmoodle/blog:manageentriesmoodle/blog:manageexternalmoodle/blog:searchmoodle/blog:viewmoodle/blog:viewdraftsmoodle/calendar:manageentriesmoodle/calendar:managegroupentriesmoodle/calendar:manageownentriesmoodle/category:managemoodle/cohort:assignmoodle/cohort:managemoodle/cohort:viewmoodle/comment:deletemoodle/comment:postmoodle/comment:viewmoodle/competency:competencygrademoodle/competency:competencymanagemoodle/competency:competencyviewmoodle/competency:coursecompetencyconfiguremoodle/competency:coursecompetencygradablemoodle/competency:coursecompetencymanagemoodle/competency:coursecompetencyviewmoodle/competency:evidencedeletemoodle/competency:plancommentmoodle/competency:plancommentownmoodle/competency:planmanagemoodle/competency:planmanagedraftmoodle/competency:planmanageownmoodle/competency:planmanageowndraftmoodle/competency:planrequestreviewmoodle/competency:planrequestreviewownmoodle/competency:planreviewmoodle/competency:planviewmoodle/competency:planviewdraftmoodle/competency:planviewownmoodle/competency:planviewowndraftmoodle/competency:templatemanagemoodle/competency:templateviewmoodle/competency:usercompetencycommentmoodle/competency:usercompetencycommentownmoodle/competency:usercompetencyrequestreviewmoodle/competency:usercompetencyrequestreviewownmoodle/competency:usercompetencyreviewmoodle/competency:usercompetencyviewmoodle/competency:userevidencemanagemoodle/competency:userevidencemanageownmoodle/competency:userevidenceviewmoodle/contentbank:accessmoodle/contentbank:deleteanycontentmoodle/contentbank:deleteowncontentmoodle/contentbank:manageanycontentmoodle/contentbank:manageowncontentmoodle/contentbank:uploadmoodle/contentbank:useeditormoodle/course:activityvisibilitymoodle/course:bulkmessagingmoodle/course:changecategorymoodle/course:changefullnamemoodle/course:changeidnumbermoodle/course:changelockedcustomfieldsmoodle/course:changeshortnamemoodle/course:changesummarymoodle/course:configurecustomfieldsmoodle/course:createmoodle/course:creategroupconversationsmoodle/course:deletemoodle/course:enrolconfigmoodle/course:enrolreviewmoodle/course:ignoreavailabilityrestrictionsmoodle/course:ignorefilesizelimitsmoodle/course:isincompletionreportsmoodle/course:manageactivitiesmoodle/course:managefilesmoodle/course:managegroupsmoodle/course:managescalesmoodle/course:markcompletemoodle/course:movesectionsmoodle/course:overridecompletionmoodle/course:recommendactivitymoodle/course:renamerolesmoodle/course:requestmoodle/course:resetmoodle/course:reviewotherusersmoodle/course:sectionvisibilitymoodle/course:setcurrentsectionmoodle/course:setforcedlanguagemoodle/course:tagmoodle/course:togglecompletionmoodle/course:updatemoodle/course:useremailmoodle/course:viewhiddenactivitiesmoodle/course:viewscalesmoodle/course:viewsuspendedusersmoodle/course:visibilitymoodle/filter:managemoodle/grade:editmoodle/grade:exportmoodle/grade:hidemoodle/grade:importmoodle/grade:lockmoodle/grade:managemoodle/grade:managegradingformsmoodle/grade:managelettersmoodle/grade:manageoutcomesmoodle/grade:managesharedformsmoodle/grade:sharegradingformsmoodle/grade:unlockmoodle/grade:viewmoodle/grade:viewallmoodle/grade:viewhiddenmoodle/h5p:deploymoodle/h5p:setdisplayoptionsmoodle/h5p:updatelibrariesmoodle/my:configsyspagesmoodle/my:manageblocksmoodle/notes:managemoodle/notes:viewmoodle/portfolio:exportmoodle/question:addmoodle/question:configmoodle/question:editallmoodle/question:editminemoodle/question:flagmoodle/question:managecategorymoodle/question:moveallmoodle/question:moveminemoodle/question:tagallmoodle/question:tagminemoodle/question:useallmoodle/question:useminemoodle/question:viewallmoodle/question:viewminemoodle/rating:ratemoodle/rating:viewmoodle/rating:viewallmoodle/rating:viewanymoodle/restore:configuremoodle/restore:createusermoodle/restore:restoreactivitymoodle/restore:restorecoursemoodle/restore:restoresectionmoodle/restore:restoretargetimportmoodle/restore:rolldatesmoodle/restore:uploadfilemoodle/restore:userinfomoodle/restore:viewautomatedfileareamoodle/role:assignmoodle/role:managemoodle/role:overridemoodle/role:reviewmoodle/role:safeoverridemoodle/role:switchrolesmoodle/search:querymoodle/site:approvecoursemoodle/site:configmoodle/site:configviewmoodle/site:deleteanymessagemoodle/site:deleteownmessagemoodle/site:doclinksmoodle/site:forcelanguagemoodle/site:maintenanceaccessmoodle/site:manageallmessagingmoodle/site:manageblocksmoodle/site:managecontextlocksmoodle/site:messageanyusermoodle/site:mnetlogintoremotemoodle/site:readallmessagesmoodle/site:sendmessagemoodle/site:trustcontentmoodle/site:uploadusersmoodle/site:viewanonymouseventsmoodle/site:viewfullnamesmoodle/site:viewparticipantsmoodle/site:viewreportsmoodle/site:viewuseridentitymoodle/tag:editmoodle/tag:editblocksmoodle/tag:flagmoodle/tag:managemoodle/user:changeownpasswordmoodle/user:createmoodle/user:deletemoodle/user:editmessageprofilemoodle/user:editownmessageprofilemoodle/user:editownprofilemoodle/user:editprofilemoodle/user:ignoreuserquotamoodle/user:loginasmoodle/user:manageblocksmoodle/user:manageownblocksmoodle/user:manageownfilesmoodle/user:managesyspagesmoodle/user:readuserblogsmoodle/user:readuserpostsmoodle/user:updatemoodle/user:viewalldetailsmoodle/user:viewlastipmoodle/user:viewuseractivitiesreportmoodle/webservice:managealltokensqtype/lti:addcoursetoolqtype/lti:adddefaultinstanceqtype/lti:addgloballypreconfigedtoolinstanceqtype/lti:addinstanceqtype/lti:adminqtype/lti:backupcourseqtype/lti:manageqtype/lti:regradeltiqtype/lti:requesttooladdqtype/lti:viewquizaccess/seb:manage_filemanager_sebconfigfilequizaccess/seb:manage_seb_activateurlfilteringquizaccess/seb:manage_seb_allowedbrowserexamkeysquizaccess/seb:manage_seb_allowreloadinexamquizaccess/seb:manage_seb_allowspellcheckingquizaccess/seb:manage_seb_allowuserquitsebquizaccess/seb:manage_seb_enableaudiocontrolquizaccess/seb:manage_seb_expressionsallowedquizaccess/seb:manage_seb_expressionsblockedquizaccess/seb:manage_seb_filterembeddedcontentquizaccess/seb:manage_seb_linkquitsebquizaccess/seb:manage_seb_muteonstartupquizaccess/seb:manage_seb_quitpasswordquizaccess/seb:manage_seb_regexallowedquizaccess/seb:manage_seb_regexblockedquizaccess/seb:manage_seb_requiresafeexambrowserquizaccess/seb:manage_seb_showkeyboardlayoutquizaccess/seb:manage_seb_showreloadbuttonquizaccess/seb:manage_seb_showsebdownloadlinkquizaccess/seb:manage_seb_showsebtaskbarquizaccess/seb:manage_seb_showtimequizaccess/seb:manage_seb_showwificontrolquizaccess/seb:manage_seb_templateidquizaccess/seb:manage_seb_userconfirmquitquizaccess/seb:managetemplatesquizaccess/wifiresilience:adminmessagesquizaccess/wifiresilience:browserchecksquizaccess/wifiresilience:inspectresponsesquizaccess/wifiresilience:localresponsesquizaccess/wifiresilience:uploadresponsesquizaccess/wifiresilience:viewlivedevicesquizaccess/wifiresilience:viewtechchecksquiz/grading:viewidnumberquiz/grading:viewstudentnamesquiz/statistics:viewreport/completion:viewreport/customsql:definequeriesreport/customsql:managecategoriesreport/customsql:viewreport/loglive:viewreport/log:viewreport/log:viewtodayreport/outline:viewreport/outline:viewuserreportreport/participation:viewreport/performance:viewreport/progress:viewreport/questioninstances:viewreport/security:viewreport/stats:viewreport/status:viewreport/usersessions:manageownsessionsrepository/areafiles:viewrepository/boxnet:viewrepository/contentbank:accesscoursecategorycontentrepository/contentbank:accesscoursecontentrepository/contentbank:accessgeneralcontentrepository/contentbank:viewrepository/coursefiles:viewrepository/dropbox:viewrepository/equella:viewrepository/filesystem:viewrepository/flickr_public:viewrepository/flickr:viewrepository/googledocs:viewrepository/local:viewrepository/merlot:viewrepository/nextcloud:viewrepository/onedrive:viewrepository/opencast:viewrepository/picasa:viewrepository/recent:viewrepository/s3:viewrepository/skydrive:viewrepository/upload:viewrepository/url:viewrepository/user:viewrepository/webdav:viewrepository/wikimedia:viewrepository/youtube:viewtool/coursedates:setdatestool/customlang:edittool/customlang:viewtool/dataprivacy:downloadallrequeststool/dataprivacy:downloadownrequesttool/dataprivacy:makedatadeletionrequestsforchildrentool/dataprivacy:makedatarequestsforchildrentool/dataprivacy:managedataregistrytool/dataprivacy:managedatarequeststool/dataprivacy:requestdeletetool/dataprivacy:requestdeleteforotherusertool/lpmigrate:frameworksmigratetool/monitor:managerulestool/monitor:managetooltool/monitor:subscribetool/opencast:externalapitool/opencast:instructortool/opencast:learnertool/policy:accepttool/policy:acceptbehalftool/policy:managedocstool/policy:viewacceptancestool/recyclebin:deleteitemstool/recyclebin:restoreitemstool/recyclebin:viewitemstool/uploaduser:uploaduserpicturestool/usertours:managetourswebservice/soap:usewebservice/xmlrpc:usemod/quiz:viewmod/quiz:viewreportsmoodle/category:viewcourselistmoodle/category:viewhiddencategoriesmoodle/course:viewmoodle/course:viewhiddencoursesmoodle/course:viewhiddensectionsmoodle/course:viewhiddenuserfieldsmoodle/course:viewparticipantsmoodle/site:accessallgroupsmoodle/user:viewdetailsmoodle/user:viewhiddendetailsmoodle/webservice:createmobiletokenmoodle/webservice:createtokenquizaccess/seb:bypasssebreport/courseoverview:viewwebservice/rest:use diff --git a/docs/images/certificates/cert_list.png b/docs/images/certificates/cert_list.png new file mode 100644 index 00000000..36feb4d9 Binary files /dev/null and b/docs/images/certificates/cert_list.png differ diff --git a/docs/images/connection_config/encrypt.png b/docs/images/connection_config/encrypt.png new file mode 100644 index 00000000..dc4df9b6 Binary files /dev/null and b/docs/images/connection_config/encrypt.png differ diff --git a/docs/images/lmssetup/moodle_mobile.png b/docs/images/lmssetup/moodle_mobile.png new file mode 100644 index 00000000..85fc3e1a Binary files /dev/null and b/docs/images/lmssetup/moodle_mobile.png differ diff --git a/docs/images/monitoring/sebClientLogs.png b/docs/images/monitoring/sebClientLogs.png index 2a2afc13..7c56caf2 100644 Binary files a/docs/images/monitoring/sebClientLogs.png and b/docs/images/monitoring/sebClientLogs.png differ diff --git a/docs/lmssetup.rst b/docs/lmssetup.rst index ab76b1f3..a6642f83 100644 --- a/docs/lmssetup.rst +++ b/docs/lmssetup.rst @@ -206,6 +206,20 @@ Once the client registration was successful the client id and client secret can To be able to create an LMS Setup for Moodle you need a Moodle administrator or manager account. You can then use this account in the LMS Setup to connect the the LMS. +Since SEB Server uses some functions from the Moodles mobile API, you have to make sure the web services for mobile apps are enabled within your Moodle setup. +To do so please login to Moodel with an administrator account and go to "Side Administration", scroll down to "Mobile App" and choose "Mobile Settings. + +.. image:: images/lmssetup/moodle_mobile.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/documentation/docs/images/lmssetup/moodle_mobile.png + +If you have a restrictive Moodle setup and troubles with the Moodle API account to use with SEB Server, please try to import the following +Moodle role profile within youe Moodle instance. This profile will create a SEB Server role within Moodle that can be used to apply to an +API account to be used with SEB Server. The role defines only the necessary privileges and functions needed for SEB Server communication. + +Moodle role and account settings: :download:`XML ` + + .. _lms-setup-rest-plugin-label: diff --git a/docs/monitoring.rst b/docs/monitoring.rst index aa9ee110..e354bf05 100644 --- a/docs/monitoring.rst +++ b/docs/monitoring.rst @@ -144,4 +144,12 @@ action form the right action pane to open up a pop-up containing all related inf Currently there is no export functionality to export all interessting SEB client logs to a CSV table for example. But such a feature will probably come with a next version of SEB Server. + +**Delete filtered client logs** + +To delete all currently filtered client logs, please use the "Delete Logs" action form the right action pane. + +.. note:: + On deletion, all available logs will permanantly be deleted from the persistent storage. So please make sure you want to delete all + logs that are currently displayed in the list before deleting. \ No newline at end of file