Windows Explorer WebDAV interop (last client from the v0.1 matrix) #2

Open
opened 2026-07-18 20:16:56 +00:00 by Cordy · 7 comments
Owner

WebDAV is verified against curl only (all methods return correct status codes and payloads). Real clients are pickier — each has quirks around LOCK, PROPFIND properties, trailing slashes, and header casing.

Test matrix (v0.1 gate):

  • rclone — rclone lsd/copy/sync against /dav/ (most important: it's the power-user path and the easiest to automate in CI later)
  • macOS Finder — Connect to Server → browse, upload, rename, delete (exercises the fake LOCK path)
  • Cyberduck — full CRUD
  • Windows Explorer — map network drive (notoriously strict; may need OPTIONS on / and Basic-over-HTTP registry caveat documented)
  • Nextcloud desktop client (generic WebDAV mode) — nice-to-have, big migration story if it works

Document per-client findings + required workarounds in the wiki. Anything requiring protocol changes gets its own issue.

WebDAV is verified against curl only (all methods return correct status codes and payloads). Real clients are pickier — each has quirks around LOCK, PROPFIND properties, trailing slashes, and header casing. Test matrix (v0.1 gate): - [ ] **rclone** — `rclone lsd/copy/sync` against `/dav/` (most important: it's the power-user path and the easiest to automate in CI later) - [ ] **macOS Finder** — Connect to Server → browse, upload, rename, delete (exercises the fake LOCK path) - [ ] **Cyberduck** — full CRUD - [ ] **Windows Explorer** — map network drive (notoriously strict; may need `OPTIONS` on `/` and Basic-over-HTTP registry caveat documented) - [ ] **Nextcloud desktop client** (generic WebDAV mode) — nice-to-have, big migration story if it works Document per-client findings + required workarounds in the wiki. Anything requiring protocol changes gets its own issue.
Author
Owner

Client interop matrix complete against v0.0.2 (2026-07-20):

  • Finder ✔ — ⌘K mount, browse, MKCOL + rename, LOCK/PUT/GET/UNLOCK copy, AppleDouble ._* traffic. Pod 0 restarts (this was the #5 killer traffic).
  • rclone ✔ — via new interop-rclone.yml manual-dispatch workflow on the LAN runner: lsd, upload, rclone check (0 differences; no common hash — expected, WebDAV exposes none), round-trip download byte-identical, purge cleanup. Re-runnable any time from the Actions tab (needs CAIRN_TEST_PASSWORD secret, already set).
  • Cyberduck ✔ — WebDAV (HTTP) connect on port 80, browse, MKCOL (cyberduck-test), upload (5.9 KB), download round-trip (size-verified), DELETE cleanup. Only client-side notes: Cyberduck's plaintext-HTTP warning (expected on LAN; goes away if/when files.c0rdyceps.ch TLS exposure happens) and its 401→login-prompt flow on first connect (normal Basic-auth challenge handling).

Pod stayed Running, 0 restarts across all three clients. Windows Explorer remains untested (no Windows box handy) — leaving as a nice-to-have.

**Client interop matrix complete against v0.0.2 (2026-07-20):** - **Finder** ✔ — ⌘K mount, browse, MKCOL + rename, LOCK/PUT/GET/UNLOCK copy, AppleDouble `._*` traffic. Pod 0 restarts (this was the #5 killer traffic). - **rclone** ✔ — via new `interop-rclone.yml` manual-dispatch workflow on the LAN runner: lsd, upload, `rclone check` (0 differences; no common hash — expected, WebDAV exposes none), round-trip download byte-identical, purge cleanup. Re-runnable any time from the Actions tab (needs `CAIRN_TEST_PASSWORD` secret, already set). - **Cyberduck** ✔ — WebDAV (HTTP) connect on port 80, browse, MKCOL (`cyberduck-test`), upload (5.9 KB), download round-trip (size-verified), DELETE cleanup. Only client-side notes: Cyberduck's plaintext-HTTP warning (expected on LAN; goes away if/when `files.c0rdyceps.ch` TLS exposure happens) and its 401→login-prompt flow on first connect (normal Basic-auth challenge handling). Pod stayed Running, 0 restarts across all three clients. Windows Explorer remains untested (no Windows box handy) — leaving as a nice-to-have.
Author
Owner

Status (2026-07-25): rclone, Finder, Cyberduck all verified against the live dogfood (2026-07-20). Windows Explorer is the only remaining client — moved to v0.4 as the parity item. Nextcloud desktop client is superseded by the dedicated "Desktop sync client — strategic spike" (#20).

Status (2026-07-25): rclone, Finder, Cyberduck all verified against the live dogfood (2026-07-20). **Windows Explorer is the only remaining client** — moved to v0.4 as the parity item. Nextcloud desktop client is superseded by the dedicated "Desktop sync client — strategic spike" (#20).
Author
Owner

Triage: tandem (manual client testing). WebDAV interop across rclone, Finder, Cyberduck, Windows Explorer on real OSes — mount, up/download, rename, large files, the NFC path fix (#183). I can supply a test matrix/checklist; you run the clients and report. Some paths are already covered by the CI interop workflows (rclone/tus).

**Triage: tandem (manual client testing).** WebDAV interop across rclone, Finder, Cyberduck, Windows Explorer on real OSes — mount, up/download, rename, large files, the NFC path fix (#183). I can supply a test matrix/checklist; you run the clients and report. Some paths are already covered by the CI interop workflows (rclone/tus).
Cordy changed title from v0.1: WebDAV client interop testing (rclone, Finder, Cyberduck, Explorer) to Windows Explorer WebDAV interop (last client from the v0.1 matrix) 2026-09-03 01:52:16 +00:00
Author
Owner

Retitled (2026-09-03): rclone, Finder and Cyberduck were all verified 2026-07-20 and the Nextcloud client is superseded by #20 — Windows Explorer is the only remaining client, so the issue now says exactly that.

One thing has changed since the last triage that makes this test more valuable, not less: per-file locks (#315) replaced the old granted-and-ignored WebDAV LOCK tokens with real, enforced class-2 locking. Explorer/Office on Windows is the strictest lock client in the matrix, so the Explorer pass should now also cover: open a Word/Excel file from the mapped drive (lock appears on the admin Locks page and in the row chip), attempt a conflicting edit from a second account (should be refused with 423), close the document (lock released), plus the classic Explorer checks — map drive, browse, up/download, rename, large file, umlaut/NFC filenames (#183). Tandem as before: checklist from the agent, clients run by the operator.

Retitled (2026-09-03): rclone, Finder and Cyberduck were all verified 2026-07-20 and the Nextcloud client is superseded by #20 — Windows Explorer is the only remaining client, so the issue now says exactly that. One thing has changed since the last triage that makes this test **more** valuable, not less: per-file locks (#315) replaced the old granted-and-ignored WebDAV LOCK tokens with real, enforced class-2 locking. Explorer/Office on Windows is the strictest lock client in the matrix, so the Explorer pass should now also cover: open a Word/Excel file from the mapped drive (lock appears on the admin Locks page and in the row chip), attempt a conflicting edit from a second account (should be refused with 423), close the document (lock released), plus the classic Explorer checks — map drive, browse, up/download, rename, large file, umlaut/NFC filenames (#183). Tandem as before: checklist from the agent, clients run by the operator.
Author
Owner

Update (2026-10-09): a dedicated Windows test laptop is available

Nikola has prepared a Windows laptop with a clean install and nothing else on it, for Claude to drive fully. The plan is to run this issue's Explorer pass there instead of the earlier "tandem" setup.

How Claude drives it from the Mac (both machines in one session, one action at a time):

  • GUI: Remote Desktop from the Mac (the Microsoft "Windows App"), which Claude operates through computer use. Windows Pro or Enterprise is needed as the RDP host; Home has no RDP server.
  • Shell (optional, works on Home too): the built-in OpenSSH Server optional feature. Claude runs PowerShell over ssh from the Mac for scripted checks (net use, robocopy, hashes, large files).
  • One-time setup by Nikola: enable Remote Desktop or OpenSSH Server on the laptop, install the Windows App on the Mac, and approve it for computer use. Sign-ins with real passwords stay with Nikola.

Test scope (from the 2026-09-03 comment, plus):

  • Map a drive via the WebClient service. Note that WebClient's Basic auth over plain http is off by default (BasicAuthLevel), so test over https through files.c0rdyceps.ch, with an app password.
  • Browse, upload and download, rename, a large file (the WebClient default FileSizeLimitInBytes is 50 MB), and umlaut/NFC filenames (#183).
  • Word/Excel from the mapped drive: the lock appears on the admin Locks page and the row chip, a conflicting edit from a second account gets 423, and the lock is released on close (#315).
  • Also run the #848 live check on that laptop: sign in as nikola-test2 there, change that user's password in Keycloak, and expect that Windows browser session to end within directoryRecheck (5 min) while a fresh sign-in with the new password stays.
## Update (2026-10-09): a dedicated Windows test laptop is available Nikola has prepared a Windows laptop with a clean install and nothing else on it, for Claude to drive fully. The plan is to run this issue's Explorer pass there instead of the earlier "tandem" setup. **How Claude drives it from the Mac (both machines in one session, one action at a time):** - **GUI:** Remote Desktop from the Mac (the Microsoft "Windows App"), which Claude operates through computer use. Windows Pro or Enterprise is needed as the RDP host; Home has no RDP server. - **Shell (optional, works on Home too):** the built-in OpenSSH Server optional feature. Claude runs PowerShell over ssh from the Mac for scripted checks (`net use`, robocopy, hashes, large files). - **One-time setup by Nikola:** enable Remote Desktop or OpenSSH Server on the laptop, install the Windows App on the Mac, and approve it for computer use. Sign-ins with real passwords stay with Nikola. **Test scope (from the 2026-09-03 comment, plus):** - Map a drive via the WebClient service. Note that WebClient's Basic auth over plain http is off by default (BasicAuthLevel), so test over https through `files.c0rdyceps.ch`, with an app password. - Browse, upload and download, rename, a large file (the WebClient default FileSizeLimitInBytes is 50 MB), and umlaut/NFC filenames (#183). - Word/Excel from the mapped drive: the lock appears on the admin Locks page and the row chip, a conflicting edit from a second account gets 423, and the lock is released on close (#315). - **Also run the #848 live check on that laptop:** sign in as nikola-test2 there, change that user's password in Keycloak, and expect that Windows browser session to end within `directoryRecheck` (5 min) while a fresh sign-in with the new password stays.
Author
Owner

The laptop runs Windows Pro, so the Remote Desktop route works: the GUI is driven over RDP from the Mac. The #848 live check, which ends a session after a Keycloak password change, runs as part of this pass.

The laptop runs Windows **Pro**, so the Remote Desktop route works: the GUI is driven over RDP from the Mac. The #848 live check, which ends a session after a Keycloak password change, runs as part of this pass.
Author
Owner

Also to run on the Windows machine: the #1097 ZIP64 gate (Windows 11 File Explorer). unzip, 7-Zip and macOS Archive Utility passed on 2026-11-05 (results and expected SHA-256 on #1097); Explorer is the last tool, and #1097 stays open until it is in.

Steps (spec §17 G, with the Gate.zip from #1097 or a fresh download of a folder holding a file over 4 GiB): note winver; open Gate.zip in Explorer (four files and Leer, names Grüße äöü.txt and 日本語テスト.txt correct); Extract All… to C:\gate; Get-FileHash -Algorithm SHA256 C:\gate\Gate\* | Format-List and compare with the hashes on #1097. Post the result on #1097.

**Also to run on the Windows machine: the #1097 ZIP64 gate (Windows 11 File Explorer).** unzip, 7-Zip and macOS Archive Utility passed on 2026-11-05 (results and expected SHA-256 on #1097); Explorer is the last tool, and #1097 stays open until it is in. Steps (spec §17 G, with the `Gate.zip` from #1097 or a fresh download of a folder holding a file over 4 GiB): note `winver`; open `Gate.zip` in Explorer (four files and `Leer`, names `Grüße äöü.txt` and `日本語テスト.txt` correct); **Extract All…** to `C:\gate`; `Get-FileHash -Algorithm SHA256 C:\gate\Gate\* | Format-List` and compare with the hashes on #1097. Post the result on #1097.
Sign in to join this conversation.
No labels
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Cordy/Cairn#2
No description provided.