Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- fn2:datei-upload [2019/04/05 09:59] – [Optional in context.xml] christoph
+++ fn2:datei-upload [2019/11/12 11:36] – [Klausur-Upload] christoph
@@ Zeile 1: / Zeile 1: @@
-=======Datei-Upload innerhalb der Studenten-Schnittstelle=======
+======Datei-Upload======
 Der Datei-Upload, der in Zusammenarbeit mit der Universität Göttingen implementiert wurde, soll es Studenten ermöglichen Abgaben vollständig über die Studenten-Schnittstelle (FN2SSS) abwickeln zu können. Eine erste Iteration wurde im Februar 2019 abgeschlossen und ermöglicht den eigentlichen Upload von Dokumenten, sowie deren rudimentäre Verwaltung durch FN2SSS und das PA-Modul.
@@ Zeile 27: / Zeile 27: @@
 ergänzt werden.
-====Optional in context.xml====
-Optional kann das Intervall angegeben werden, in dem nach abgabefälligen Uploads gesucht wird.
-    <Parameter description="Intervall mit dem nach abgabefälligen Uploads gesucht wird in Sekunden" name="FN2SSS.DATEI_UPLOAD_CHECK_INTERVALL" value="10800"/>
-Das Intervall hat einen Default-Wert von einer Stunde (wenn der Parameter nicht vorhanden ist) und einen Minimal-Wert von einer halben Stunde.
 ====FN2SSS/WEB-INF/web.xml====
@@ Zeile 88: / Zeile 81: @@
 ====MIME-Typ====
-Mit dem Parameter FN2SSS.UPLOAD_MIME werden für den Upload zulässige MIME-Typen nach [[https://tools.ietf.org/html/rfc2046|RFC2046]] hinterlegt. Wie schon in der Beschreibung erklärt, müssen die einzelnen Types mit Doppelpunkten getrennt werden, z.B. würde ein value von
+Mit dem Parameter FN2SSS.UPLOAD_MIME werden für den Upload zulässige MIME-Typen nach [[https://tools.ietf.org/html/rfc2046|RFC2046]] hinterlegt. Wie schon in der Beschreibung erklärt, müssen die einzelnen Typen mit Doppelpunkten getrennt werden, z.B. würde ein value von
   application/pdf:text/plain
 für .pdf und .txt (und Ähnliche) stehen. Eine Liste mit den gängigsten MIME-Typen ist [[https://wiki.selfhtml.org/wiki/MIME-Type/Übersicht|hier]] zu finden.
-<WRAP center round alert 60%>
+<WRAP center round important 60%>
-Java kennt von sich aus nur die absoluten Basis MIME-Typen.
+Java kennt von sich aus nur einige wenige Basis MIME-Typen.
-Wenn andere Typen gewünscht werden, bitten wir um Rücksprache um diese ggf. einfügen zu können.
 </WRAP>
+Wenn "exotischere" Typen gewünscht werden, bitten wir um Rücksprache um diese ggf. einfügen zu können. (z.B. zählen schon Word Documente (.doc/.docx) zu den Java-unbekannten Typen)
 ====Begrenzung der Datei/Upload-Größe====
@@ Zeile 106: / Zeile 98: @@
 Die maximal Anzahl an hochladbaren Dateien wird in der Tabelle TEILPRF in der Spalte HOCHLADEN für jede Teilprüfung separat angegeben.
-=====Hinweis zum Klausur-Upload=====
-Die folgenden Parameter beziehen sich auf den Datei-Upload in FN2SSS, nicht den Klausur-Upload in FN2LM.
+=====Optionaler Eintrag in context.xml=====
-Die Parameter für den Klausur-Upload können jedoch leicht daran abgeleitet werden:
-  * Einträge in der in FN2SSS-web.xml müssen statt dessen in die FN2LM-web.xml
+Optional kann das Intervall angegeben werden, in dem nach abgabefälligen Uploads gesucht wird.
-  * Einträge in der context.xml müssen statt dessen mit FN2LM beginnen
+    <Parameter description="Intervall mit dem nach abgabefälligen Uploads gesucht wird in Sekunden" name="FN2SSS.DATEI_UPLOAD_CHECK_INTERVALL" value="10800"/>
+Das Intervall hat einen Default-Wert von einer Stunde (wenn der Parameter nicht vorhanden ist) und einen Minimal-Wert von einer halben Stunde.
+======Klausur-Upload======
+Da der Klausur-Upload weitestgehend die gleiche Infrastruktur wie der Datei-Upload nutzt, können die zugehörigen Parameter leicht abgeleitet werden:
+Die Parameter-Benamung bleibt gleich, es müssen lediglich die
+  * Einträge in der in FN2SSS-web.xml statt dessen in die FN2LM-web.xml
+  * Einträge in der context.xml statt dessen mit FN2LM beginnen
+Selbstverständlich müssen die Werte sinnvoll gewählt werden, z.B. sollte FN2LM.UPLOAD_SUFFIX den Wert "LM/" oder ähnlich haben.
+Da für Klausur-Uploads eine Fächer/Prüfungsspezifische Begrenzung der Anzahl nur wenig Sinn macht, kann die maximale Anzahl der hochladbaren Dateien global in der FN2LM-web.xml mit dem Init-Parameter 'UPLOAD_LIMIT' eingestellt werden:
+  <init-param>
+      <description>Anzahl der max. Klausuren, die pro Prüfungszeitraum hoch geladen werden dürfen</description>
+      <param-name>UPLOAD_LIMIT</param-name>
+      <param-value>3</param-value>
+  </init-param>
+Ist der Wert negativ, nicht vorhanden oder nicht als Zahl interpretierbar, können beliebig viele Uploads durchgeführt werden.
+=====Verschlüsselung=====
+Wenn gewünscht, können die hochgeladenen Klausuren zusätzlich verschlüsselt werden. Dazu muss in der FN2LM-web.xml ein Init-Parameter ENCRYPT_KLAUSUREN mit dem Wert true hinterlegt werden:
+  <init-param>
+       <description>Sollen hochgeladene Klausuren verschlüsselt werden? (true/false)</description>
+       <param-name>ENCRYPT_KLAUSUREN</param-name>
+       <param-value>true</param-value>
+  </init-param>
+Das verwendete Verfahren kann ebenfalls über Init-Parameter gewählt werden.
+Für die verwendete Transformation der Parameter CIPHER:
+  <init-param>
+       <description>Welche Transformation soll verwendet werden?</description>
+       <param-name>CIPHER</param-name>
+       <param-value>############</param-value>
+  </init-param>
+Für den verwendeten Schlüssel der Parameter CIPHER_KEY:
+  <init-param>
+       <description>Verwendeter Schlüssel</description>
+       <param-name>CIPHER_KEY</param-name>
+       <param-value>############</param-value>
+  </init-param>
+Valide Werte können [[https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#impl|hier]] entnommen werden.
+Die Parameter sind **alle optional**. Wenn sie nicht vorhanden sind, werden folgende Defaults genutzt:
+^ Parameter        ^    Default-Wert    ^ Effekt                      ^
+| ENCRYPT_KLAUSUREN|       false        | Klausuren werden nicht verschlüsselt |
+| CIPHER           |AES/CBC/PKCS5Padding|     AES mit CBC und PKCS5-Padding    |
+| CIPHER_KEY       |     #########      |       Bitte bei Bedarf erfragen      |