Content

Accessing FAUbox folders via WebDAV

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. It was defined in rfc4918 and evolved to a de-facto standard. Files (or folders) stored in the cloud can be accessed via WebDAV. WebDAV 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 cloud without the client or any additional software installed.

Instructions for SSO(Single Sign-On)-users (except for guests)

The usage of WebDAV is only possible if you have created an authentication token with the client-Version 11.3.x or above. To do that, you only need to start the client and connect with the server. This makes it possible for SSO-using institutions to use WebDAV.

To access folders via WebDAV, you have to authenticate through signing into the FAUbox. In the case of our web-cloud faubox.rrze.fau.de, you need to use your SSO-username (EduPersonPrincipalName), usually in the form of <IdM-username>@uni-erlangen.de, and the authentication token from the client configuration file. You can find this file in:

  • Windows: %appdata%\FAUbox\PowerFolder.config
    Mac / Linux: ~/.FAUbox/PowerFolder.config

Inside this file, you will find the following line:  server.connect.token.webdav=…
Everything that comes after the “=” is the token needed for the authentication.

On faubox.rrze.fau.de all WebDAV traffic will be SSL-encrypted.

 

Obtaining the WebDAV URL

Each of your folders stored in the cloud also have an address which let’s you access them directly via WebDAV. This address is called the WebDAV URL.

Examples:

  • https://faubox.rrze.fau.de/webdav/ExampleFolder
  • davs://faubox.rrze.fau.de/webdav/ExampleFolder

How to obtain the WebDAV URL:

  1. Login at faubox.rrze.fau.de.
  2. Click on a folder to get the WebDAV URL for.
  3. Click on Settings.
  4. Copy the WebDAV URL.
    4

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!

Using WebDAV on Windows

Via Windows Explorer

  1. Open Windows Explorer (e.g. by right-clicking the Start button)
  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).
  2. Use the net use command to mount your folder to a drive letter of your choice. Example:
    net use Z: https://faubox.rrze.fau.de/webdav/ExampleFolder /user:username password /persistent

    (Info) Replace username and password with <IdM-username>@uni-erlangen.de and the authentication token
    (Info) Replace https://faubox.rrze.fau/webdav/ExampleFolder with the WebDAV URL for the folder you want to mount.

     

Troubleshooting WebDAV on Windows

  • The built-in Windows client might crash occasionally. In that case it might help to restart the Windows service WebClient under Control Panel > Administrative Tools > Services.
  • The built-in Windows client might be very slow. In that case please disable the automatic proxy detection in the Internet Explorer. You can find that setting in the Internet Explorer’s Internet Options > Connections > LAN Settings > Automatically detect settings.
  • The built-in Windows client might repeatedly ask your for your credentials. In that case you might need to enable Basic Authentication:

Enable basic authentication for the Microsoft Windows Mini-Redirector component by modifying a key in the Windows registry
Windows XP
1. Open the Windows registry editor by going to Start > Run and then enter regedit into the ‘Run’ dialog box.
2. Browse to the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters key.
3. Find a DWORD/REG_DWORD entry named UseBasicAuth (if it does not exist, create this DWORD entry).
4. Set the value for this entry to 1.
5. Restart your computer.
Windows Vista, Windows 7 or Windows 8
1. Click Start and type regedit in the Start Search box, and then click regedit.exe in the programs list.
2. Browse to the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters key.
3. Find a DWORD/REG_DWORD entry named BasicAuthLevel.
4. In the Value data box, type 2, and then click OK.
5. Restart your computer.

Using WebDAV on Mac OS X

  1. Click on Go.
  2. Click on Connect to server
  3. Enter the WebDAV URL of the folder into the Server Address field.
  4. Click on Connect.
  5. Choose Registered User and enter your login and password described above (<IdM-username>@uni-erlangen.de + authentication token)
  6. Click on Connect.

Using 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.

Instructions for LDAP-Users(HS Ansbach) and guests

Obtaining the WebDAV URL

Each of your folders stored in the cloud have an address which let’s you access them via WebDAV. This address is called the WebDAV URL.

Examples:

  • https://faubox.rrze.fau.de/webdav/MyFolder
  • https://faubox.rrze.fau.de/webdav/ExampleFolder

How to obtain the WebDAV URL:

  1. Login at faubox.rrze.fau.de.
  2. Click on a folder to get the WebDAV URL for.
  3. Click on Settings.
  4. Copy the WebDAV URL.
    4

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!

Using WebDAV on Windows

Via Windows Explorer

  1. Open Windows Explorer (e.g. by right-clicking the Start button)
  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 your FAUbox login credentials.
    2

Enter your login and password to the cloud.

Via command line

  1. Open a Command Prompt window (or start cmd.exe).
  2. Use the net use command to mount your folder to a drive letter of your choice. Example:
    net use Z: https://faubox.rrze.fau.de/webdav/ExampleFolder /user:username password /persistent

    (Info) Replace username and password with your FAUbox login credentials.
    (Info) Replace https://faubox.rrze.fau/webdav/ExampleFolder with the WebDAV URL for the folder you want to mount.

Troubleshooting WebDAV on Windows

  • The built-in Windows client might crash occasionally. In that case it might help to restart the Windows service WebClient under Control Panel > Administrative Tools > Services.
  • The built-in Windows client might be very slow. In that case please disable the automatic proxy detection in the Internet Explorer. You can find that setting in the Internet Explorer’s Internet Options > Connections > LAN Settings > Automatically detect settings.
  • The built-in Windows client might repeatedly ask your for your credentials. In that case you might need to enable Basic Authentication:

Enable basic authentication for the Microsoft Windows Mini-Redirector component by modifying a key in the Windows registry
Windows XP
1. Open the Windows registry editor by going to Start > Run and then enter regedit into the ‘Run’ dialog box.
2. Browse to the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters key.
3. Find a DWORD/REG_DWORD entry named UseBasicAuth (if it does not exist, create this DWORD entry).
4. Set the value for this entry to 1.
5. Restart your computer.
Windows Vista, Windows 7 or Windows 8
1. Click Start and type regedit in the Start Search box, and then click regedit.exe in the programs list.
2. Browse to the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters key.
3. Find a DWORD/REG_DWORD entry named BasicAuthLevel.
4. In the Value data box, type 2, and then click OK.
5. Restart your computer.

Using WebDAV on Mac OS X

  1. Click on Go.
  2. Click on Connect to server
  3. Enter the WebDAV URL of the folder into the Server Address field.
  4. Click on Connect.
  5. Choose Registered User and enter your FAUbox username and password.
  6. Click on Connect.

Using 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 and password.
  6. Click on connect.
  7. You can now open your FAUbox folders and files directly through the file manager.