ucphhpc · SebastianPrehn · Apr 29, 2025 · Apr 23, 2025 · Apr 23, 2025 · Apr 29, 2025
diff --git a/docs/index.rst b/docs/index.rst
@@ -34,13 +34,21 @@ ERDA/SIF: User Guides
 
    sections/sif/signup/index
    sections/sif/project/index
+   sections/sif/networkdrive/index
 
 
 Welcome to the documentation site for ERDA and SIF! `ERDA <https://erda.ku.dk/>`_ and `SIF <https://sif.ku.dk/>`_ simplifies storing, sharing, analyzing and archiving research data for KU/UCPH employees, their collaboration partners, and KU/UCPH students.
 
 
 To quickly get started with ERDA or SIF, we recommend our :ref:`Getting Started <gettingstarted_intro>` page. If you are looking for something specific, the search functionality and the sidebar on the left is a good way to find what you are looking for!
 
+Make sure to read the `terms <https://erda.ku.dk/terms.html>`_ you agree to when you use ERDA and for SIF at the bottom of its `front page <https://sif.ku.dk/>`_.
+
+In short the terms should follow common sense, e.g. it is your responsibility to only store data that you actually have the right to store, and to keep your login safe and secret to prevent others from access to your account.
+
+.. important:: Please carefully read about data replication and backup in our FAQ on the `front page of ERDA <https://erda.ku.dk/>`_ to make sure you are fully aware exactly what we do and don’t offer and what your own responsibilities are regarding data safety.
+               This is relevant both in regard to our terms of use and fulfilling the requirements of the `mandatory data classification at UCPH <https://kunet.ku.dk/employee-guide/Pages/Safety-and-Emergency-Preparedness/Information-Security.aspx>`_.
+
 
 |:file_cabinet:| About ERDA
     ERDA (Electronic Research Data Archive) at the University of Copenhagen (KU/UCPH) is meant for storing,

diff --git a/docs/sections/sif/networkdrive/index.rst b/docs/sections/sif/networkdrive/index.rst
@@ -0,0 +1,82 @@
+.. _sif-networkdrive-start:
+
+=====================
+Efficient Data Access
+=====================
+
+As a SIF user, you can work locally on your cmoputer with your SIF files by connecting SIF as a network drive for efficient and transparently integrated file access through different interfaces.
+
+
+These interfaces allow you to transfer many or big files more efficiently and to map your individual SIF project files and folders on your local PC or workstation.
+In that way you can work with them as if they were local files.
+
+
+Please note that the strict SIF project isolation applies to these interfaces as well, so you can only have one project open at a time.
+If you have more than one SIF project you configure efficient access for each of them individually.
+
+
+All the interfaces use a secure connection to SIF, so they are accessible from anywhere where you have an Internet connection.
+Thus, you do not need VPN or anything like that to access them from outside UCPH.
+However, they require you to have an active two-factor authentication session from the same computer for added security.
+
+
++--------------------+-------------------------------------------------------------------------+
+| 1. WebDAVS         | WebDAVS is an abbreviation for Web-based Distributed Authoring          |
+|                    |                                                                         |
+|                    | and Versioning. A "S" is for secure, as it all runs on a                |
+|                    |                                                                         |
+|                    | secure connection.                                                      |
+|                    |                                                                         |
+|                    |   ☑ Can be used from Windows, Mac and Linux/UNIX                        |
+|                    |                                                                         |
+|                    |   ☑ Easy to get started                                                 |
+|                    |                                                                         |
+|                    |   ☑ Does not require software installation                              |
+|                    |                                                                         |
+|                    |   𐄂 Limit on file size on Windows - 50 MB as a starting point           |
+|                    |                                                                         |
+|                    |   𐄂 Sensitive to network outages                                        |
+|                    |                                                                         |
+|                    |   𐄂 WebDAVS is less efficient at transferring many and/or large files.  |
+|                    |                                                                         |
++--------------------+-------------------------------------------------------------------------+
+| 2. SSHFS with SFTP | SSHFS is an abbreviation for Secure Shell File System and is the        |
+|                    | client                                                                  |
+|                    |                                                                         |
+|                    | that connects an SFTP service as a network drive on your                |
+|                    |                                                                         |
+|                    |                                                                         |
+|                    | computer. SFTP is an abbreviation for Secure File Transfer Protocol.    |
+|                    |                                                                         |
+|                    |   ☑ Can be used from Windows, Mac and Linux/UNIX                        |
+|                    |                                                                         |
+|                    |   ☑ Efficient handling of many/large files                              |
+|                    |                                                                         |
+|                    |   ☑ Robust regarding network outages                                    |
+|                    |                                                                         |
+|                    |   ☑ Unlimited file size                                                 |
+|                    |                                                                         |
+|                    |   𐄂 You have to install two small programs - once                       |
+|                    |                                                                         |
++--------------------+-------------------------------------------------------------------------+
+
+
+.. TIP::
+   **We recommend SSHFS with SFTP, particularly for users who feel comfortable with the technology and/or who work intensively with their data.**
+
+⏩️ :doc:`WebDAVS </sections/sif/networkdrive/webdavs/index>`
+   WebDAVS is a popular protocol to access remote storage using extensions to the HTTP protocol and is the simpler option.
+
+⏩️ :doc:`SSHFS with SFTP </sections/sif/networkdrive/sshfs/index>`
+   SSHFS with SFTP is another popular option to access remote storage that uses the SSH File Transfer Protocol, and is the more robust, but more complex option.
+
+⏩️ :doc:`Workarounds </sections/sif/networkdrive/workarounds/index>`
+   Sometimes workarounds are necessary. Those can be found here.
+
+.. toctree::
+   :maxdepth: 3
+   :hidden:
+
+   WebDAVS </sections/sif/networkdrive/webdavs/index>
+   SSHFS with SFTP </sections/sif/networkdrive/sshfs/index>
+   Workarounds </sections/sif/networkdrive/workarounds/index>
diff --git a/docs/sections/sif/networkdrive/sshfs/index.rst b/docs/sections/sif/networkdrive/sshfs/index.rst
@@ -0,0 +1,4 @@
+SSHFS
+=====
+
+WIP
diff --git a/docs/sections/sif/networkdrive/webdavs/index.rst b/docs/sections/sif/networkdrive/webdavs/index.rst
@@ -0,0 +1,4 @@
+WebDAVS
+=======
+
+WIP
diff --git a/docs/sections/sif/networkdrive/workarounds/index.rst b/docs/sections/sif/networkdrive/workarounds/index.rst
@@ -0,0 +1,61 @@
+===========
+Workarounds
+===========
+
+Sometimes we need to introduce a workaround either due to limitations in our own systems, or due to how something works at the KU level. Such workarounds are (for now) placed here.
+
+
+SOCK5 connection to SIF
+=======================
+
+This workaround can sometimes be necessary if you cannot get 2FA to work on your remote KU server.
+Based on `https://linuxize.com/post/how-to-setup-ssh-socks-tunnel-for-private-browsing <https://linuxize.com/post/how-to-setup-ssh-socks-tunnel-for-private-browsing>`_.
+
+Prerequisites
+-------------
+
+* Server at KU running any flavor of Linux, with SSH access to route your traffic through it.
+* A web browser (Google Chrome, Firefox etc.).
+* SSH client.
+
+
+Set up the SSH tunnel
+---------------------
+
+Linux and MacOS (tested)
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Run the following command::
+
+  ssh -D 9090 [USER]@[SERVER_IP]
+
+[USER]@[SERVER_IP] - Your remote SSH user and server IP address.
+
+9090 is simply a port number, and can be configured.
+
+Configuring your browser to use proxy
+-------------------------------------
+
+Google Chrome (tested)
+^^^^^^^^^^^^^^^^^^^^^^
+
+**Linux:**::
+
+  /usr/bin/google-chrome \
+    --user-data-dir="$HOME/proxy-profile" \
+    --proxy-server="socks5://localhost:9090"
+
+**MacOS:**::
+
+  "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
+    --user-data-dir="$HOME/proxy-profile" \
+    --proxy-server="socks5://localhost:9090"
+
+**Windows:**::
+
+  "C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" ^
+    --user-data-dir="%USERPROFILE%\proxy-profile" ^
+    --proxy-server="socks5://localhost:9090"
+
+ Once open, simply navigate to sif.ku.dk and login. After that, you can use sftp on the machine you SSH'ed to, as you have logged into SIF on that machine through the proxy.
+
-Original file line number
+Diff line change
@@ -0,0 +1,4 @@
+    SSHFS
+    =====
+    WIP