Content

Accessing FAUbox folders via WebDAV

WebDAV means Web-based Distributed Authoring and Versioning. It is a set of extensions to the HTTP protocol which allows users to collaboratively edit and manage files on remote web servers (meaning by remote access to the content of the web-server). It was defined in rfc4918 and evolved to a de-facto standard.

Files (or folders) stored in the cloud can be accessed via WebDAV but the access is not available if you are syncing folders between clients only. Many operating systems come with built-in WebDAV support and allow to upload, access and explore files stored in the FAUbox without the client or any additional software installed.On faubox.rrze.fau.de all WebDAV traffic will be SSL-encrypted.

I. Access to WebDAV URL

Each folder you have saved in the FAUbox has its own URL which allows you to access the content of the folder through WebDAV. This address is called WebDAV-URL and also needed.

Examples:

  • https://faubox.rrze.fau.de/webdav/ExampleFolder
  • davs://faubox.rrze.fau.de/webdav/ExampleFolder
    Obtaining the WebDAV URL
    1. Login at faubox.rrze.fau.de.
    2. Click on the folder you want to get the WebDAV URL of.
    3. Click on Settings .
    4. Copy the WebDAV URL
  • The address can be used in any WebDAV client to access the contents of a folder stored in the cloud.You can only access folder created and owned by you!

II. Instructions for employees and students of affiliated institutions (SSO oder Single Sign-On-users)

https://www.doku.faubox.rrze.fau.de/files/2019/02/sc4.png You will find the instruction for the guests further below.

https://www.doku.faubox.rrze.fau.de/files/2019/02/sc4.png The usage of WebDav is only possible if you have created an authentication token with the client-version 11.3.x or above.

To access folders via WebDAV, you have to authenticate through signing into the FAUbox. You will need your username which is usually your SSO-username (EduPersonPrincipalName) in the form of <IdM-username>@uni-erlangen.de and the authentication token from the client configuration file.

1. To find the authentication token:

For Windows:

1. Open the client and log in.
2. Open the Explorer.
3.Write into the bar %appdata%\FAUbox\PowerFolder.config.
4. Open the file PowerFolder.config and search for the line: server.connect.token.webdav=…
The part following the ‘=’ is the token needed for the WebDAV-authentication.

 For Mac :

  1. Click on Go.
  2. Click on Go to Folder…
  3. Write into the bar ~/.FAUbox/.
  4. Click on Go.
  5. Open the file PowerFolder.config and search for the line: server.connect.token.webdav=…
    The part following the ‘=’ is the token needed for the WebDAV-authentication.

Summary:
Login: <IdM-username@<domain>
Password: <WebDAV-token>

The <domain> could be:

uni-erlangen.de
h-ab.de
th-ab.de
hs-coburg.de
hs-ansbach.de
ku.de
thi.de
th-nuernberg.de

2. Setting up WebDAV on Windows
  1. Open Windows Explorer.
  2. Right-click Computer in the left navigation pane.
  3. Click on Map network drive…
  4. Select a free drive letter under the Drive drop-down.
  5. Enter the WebDAV URL of the folder into the Folder field.
  6. Check the Connect using different credentials checkbox.
  7. Click on Finish.
    1
  8. Connect using the access information described above (<IdM-username>@uni-erlangen.de + authentication token).
    2

Enter your login and password to the cloud.

Via command line

  1. Open a Command Prompt window (or start cmd.exe).

Use the following net use command to mount your folder to a drive letter of your choice.

net use * https://faubox.rrze.uni-erlangen.de/webdav/ExampleFolder /user:username password /persistent

(Info) Replace https://faubox.rrze.uni-erlangen.de/webdav/ExampleFolder with the WebDAV-URL for the folder you want to mount.
Example:
net use * https://faubox.rrze.uni-erlangen.de/webdav/MlRod3RTOITVUTSENWQlQzTkNWWjFk /user: username password/ persistent: no

(Info) To access not only to one folder but the whole content of your FAUbox, leave an empty line between ‘…webdav/‘ and ‘/user:…
net use * https://faubox.rrze.uni-erlangen.de/webdav/ /user:username password /persistent:yes
(Info)Replace username with <IdM-username>@<domain> and the password with the authentication token as described above.
(Info)persistent:yes” means that the connection to the network drive will be restored every time you switch on your computer  while “persistent:no” means, that the connection will be disconnected once you shut down your computer.

3. Disconnect WebDAV Connection

If you want to disconnect the network drive:

Windows:

  1.  OpenExplorer.
  2.  Right-click on the network drive in the left-navigation pane.
  3.  Select Disconnect.
  4. Save and close any affected files that you have opened over the connection if you have not already done it. Then confirm your intention.
  5. There you go. The connection to the network drive is now disconnected.

MAC:

  1. open the Finder
  2. Select the network drive in the left navigation area with a left-Click
  3. right-Click on Webdav and select “Eject Webdav”

4.Setting up WebDAV on Linux

  1. Open the file manager.
  2. Click on “connect to server”:
  3. Enter the following address in the “server-address” field: davs://faubox.rrze.uni-erlangen.de/webdav
  4. Click on “connect”.
  5. Enter your FAUbox username. You can find your username in the web cloud under “User”. Your username is usually <yourIdM-Username>@uni-erlangen.de. Your password is the authentication token.
  6. Click on connect.
  7. You can now open your FAUbox folders and files directly through the file manager.
5.Setting up WebDAV on Mac OS X
  1. Click on Go.
  2. Click on Connect to server…
  3. Enter the WebDAV URL of the folder in the Server Adress field.
  4. Click on Connect
  5. Select Registered User, and enter your User ID (IdM user ID>@uni-erlangen.de) and authentication token in the window that opens.
  6. Click on Connect.

 

III. Guest guide

External persons use the same procedure as SSO users, but they do not need an authentication token. they use their FAUbox user name and password for login.