More WebDAV Tips, Tricks and Bugs

My WebDAV with ASP.NET post has proved to be very popular and gets me emails, so I figured I’d share some more tidbits that I’ve picked up along the way.

What do you learn when you write your own server to implement a standard protocol? Well you learn that protocols share a lot in common with legal contracts. People interpret them in different ways, often in the way that is most advantageous to what they are doing. In writing a WebDAV server, I’ve found out a lot more about Windows than I think I ever wanted to know. I figured I’d write down some of that stuff so that I could remember it, and maybe someone out there on the internet will find it useful as well.

There is not 1 WebDAV for Windows

You can’t really say Microsoft Windows supports WebDAV and think of a monolithic chunk of code that everything uses to talk WebDAV. Windows Explorer uses what’s called the Mini-Redirector. The min-redirector allows you to map a WebDAV location to a Drive letter the same as if you were using a Windows File Sharing/SMB/CIFS share. The mini-redirector has some limitations though.

The Mini-Redirector:

  • No support for HTTPS
  • No support for declared ports (
  • No support for LOCK and UNLOCK commands

There is also a system called Web Folders. Web Folders is the WebDAV implementation for Microsoft Office products. Web Folders supports all of the things that the Mini-Redirector doesn’t, including SSL, file locking, etc.

Right now, you might find yourself asking: “If there are two implementations and one is really limited and one is more featured, then why not just replace the worse version with the better?”. Yeah, I asked the same question and don’t know the answer.

When you map a WebDAV drive in Windows and want to open a Microsoft Office document, you get the distinct pleasure of using both WebDAV implementations. The Mini-Redirector asks the server for the file and once it gets it it opens Office and then Office re-asks the server for the same file again after doing some server discovery and file locking. The hand-off means that Office has to re-authenticate if your WebDAV server uses Digest Authentication, so you get to see a login dialog again. What fun!?

Server Discovery

Office uses the OPTIONS command do to Server discovery. Server discovery is basically the process of trying to figure out what kind of server it is and what protocols it supports.

The Office Web Folders always requests OPTIONS from the root (/) of the web server making a horrible assumption that any any server that supports WebDAV must support all the way to the root of the server.

Often when you are allowing users to manipulate files and folders across the internet you might want to use some form of authentication. Digest Authentication is more secure than Basic Authentication which sends the user name and password in plain-text form, so it is a good choice for authentication if you are not going to use a secure (HTTPS) connection. There’s only one small problem with this. There is a bug in the Web Folders implementation so it will not send Authentication headers on OPTIONS requests. That means you have to return an OPTIONS response regardless of what lives at a URL or whether a user is authenticated or they can’t properly open Office documents.

The Office Web Folders support does not just do WebDAV, it can also use Front Page Extensions. Since Front Page is a Microsoft proprietary product, Office prefers to use Front Page over WebDAV. In fact, it prefers it so much, that one of the only ways to get Office to use WebDAV is to use a custom header in OPTIONS requests: MS-Author-Via: DAV
The MS-Author-Via header tells Office that you don’t care how bad it wants to try Front Page, just use WebDAV.

Some Other Resources

Mini-Redirector Issues:

Web Folder Client Issues:

WebDAV Reference Book:
WebDAV: Next-Generation Collaborative Web Authoring by Lisa Dusseault

15 Replies to “More WebDAV Tips, Tricks and Bugs”

  1. Yes, It all sounds like the same set of problems when I was trying to have support for windows odd behavors. in addition to the problems you said I also found problems with authentication. Mini redirector only sends user info via digest it also sends username along with domain user/domain. Also for the OPTIONS method it will not send authentication information and yes requests for the root / url.

    I wish they would follow the standards better. I think they could but do this by design. Every time I download an update from windows I cross my fingers hoping that I don’t have to make more changes to accomidate for their poor implementation

  2. This article is a nice synopsis of a lot of limititions and idiosyncrasies that are not clearly and explicitly stated by MS or the google-able pros on the web.

    It pains me that I cannot map a network drive over HTTPS. I can open a network place, but not map it to a drive. If I use plain HTTP, then I can both do a network place and map a drive.

    Very frustrating!

    Thanks for the information.

  3. Can WebDav over Plone, made the lock file for MS Word during editing of .doc via NetDrive/Morgul DAV client ?


    ps: If this comment is inappropriate, remove it…but answer me, plese :)

  4. Roberto,
    I don’t know anything specifically about NetDrive or Morgul, but I assume they are similar to something like Webdrive.

    Webdrive completely hides WebDAV from Microsoft Office products, so the Office WebFolders implementation never gets involved. Everything looks like a local file. This is good in many ways, because the WebDAV implementation in Office has a lot of limitations. Because the Office WebDAV redirector is not involved, it of course can not send LOCK commands. All of this locking would have to be done through Webdrive. So, that’s something that you would have to configure on your Webdrive client (or NetDrive or Morgul).

    Hope that helps.

  5. Hi,
    You mention about not auth-protecting OPTIONS to make WebFolders work. Does the same trick work for mini-redirector too? Because, it isn’t working for me on a fully updated Windows XP SP2 box. I see that mini-redirector does PROPFIND instead of OPTIONS. And it ends throwing up a LANMAN login prompt (it is surely not digest auth dialog as it doesn’t display the Realm Name). Any idea how to get it working? I have MS-Author-via headers set and the same setup works well with Office clients. Without auth protection it works well with all MS clients.


  6. Vinay,
    When I was working on my WebDAV server, I had to open a number of support tickets with Microsoft to figure out these things. There was no way for me to find these things out on my own (no documentation or anything about non-standard behavior). So, you might have to call them?

    I think the mini-redirector might have the same problem with OPTIONS. Also understand that it often requests OPTIONS from the root of the web path ( regardless of the path where the DAV server is mapped.

    Here are some things to try:
    Make sure that only Anonymous authentication is enabled in IIS (not Windows or any others).

    Try taking a look at the ‘resources’ links to the pages. They have a lot of useful information about bugs in various WebDAV implementations on Windows.

    Hope that helps.

  7. Hello
    I’m having problem with mapping drive to WebDAV location on my XP SP2 box. When I type something like this:
    net use z: http://srv1/budget/
    I get this:
    System error 67 has occurred.
    The network name cannot be found.
    Srv1 is 2003 server with enabled read, write, browsing, log and index capabilities, execute permission is set to script only, and directory security is set to anonimous access only. Does not help if I click integrated windows authentication.
    Is it possible to map a drive to WebDav location, am I missing something?

  8. THANK YOU!!! We searched for ages for the reason why MS Word 2003 would always insist on opening Word documents read-only from our webdav server software. It was driving me nuts. Just added the “MS-Author-Via” header to the OPTIONS response block and as if by magic IT STARTED WORKING. No more read-only documents, no more incorrect document updates, truly a terrific fix. I can’t thank you enough!!

  9. hi, i found this site and it looks like it will solve my problem; however, it is for an older version of Zope.
    i am using Zope 2.10.5-final.
    i found another site
    this deals with the newer version; however, his patch doesn’t work for me.
    i have added to the bug report at the above link. i am posting here just in case you have kept up on this issue and know how to solve it.
    thanks for having this post – without experts like you newbies like me would never get anything done

  10. Hi ,

    I have a very interesting question.

    We have in-house webdav application designed on .NET platform. This is hosted on Win 2008 server. The situation is when we open a word document using Word 2007 it is opening in editable mode in XP OS however this is opening as READ ONLY using 2007 in Win 7.

    So this is clear that this is not problem with Office 2007 but there is something wrong happening with OS settings. When I used the Fiddler to capture the request and reponse then I found that in Win 7, it is not calling the LOCK method.
    The second difference is in Win XP it is using User-Agent: Microsoft Data Access Internet Publishing Provider DAV
    However, in Win 7 it is using User-Agent: Microsoft-WebDAV-MiniRedir/6.1.7601
    The other difference I noticed that In Win 7, the following registry setting for BASICAUTH is set to 1 (Basic authentication enabled for SSL shares only

    Do you think , if we changed the BASICAUTH to 2 then would it correct the problem OR Do we need to change the type of USER AGENT.

    I truly appreciate any help

    I hosted webdav .net solution on IIS 5.1 (windowsxp). It worked when I run from VS 2010. But when deployed to IIS, The document opens in readonly mode. Using log statements I found that it is not receiving options command from WEBDAV client. I made sure that .xls/.xlsx extensions (The ones that I need) are mapped to aspnet_isapi.dll for all verbs. What else should I check.

  12. Alex, Using the Microsoft redirectors, the OPTIONS command get sent to the root of the web application / and so you need to make sure that your web server responds with the proper HTTP verbs for WebDAV from that location.

  13. Hi, I know this is a very old post, but I thought I’d ask because I’ve Googled high and low without avail. Something on my Windows 8.1 Pro system is making WebDAV requests to a nonexistent server (it was retired years ago) once every 8 hours or so. I can’t for the life of me figure out where the request is originating, I just happened to notice it while running Fiddler for something else. NET USE is empty, I haven’t mapped any drives, and nothing else I can think of. I searched the registry for the URL, but nothing. Is there a client-side config file or task that I’m not aware of that’s doing this?

Leave a Reply

Your email address will not be published. Required fields are marked *