[XAP][Source] Webserver v0.5.3 (.REG download)
New, version Alpha 0.5.3, is now up on Codeplex and available for download here!
OK, a bit quicker that time. The major change this time is the addition of a button to download a registry key (including all its subkeys, and of course all their values) as a .REG file. Other changes
include better handling of relative paths and path traversal in the file system, a "go up" link in the registry, and bugfixes on some of the more esoteric registry behaviors. Oh, and the ability to open the phone's web browser, pointing at the server, from within the app (the URL is now a link).
Previous update (0.5.1): OK, the main advantage of the new version is nothing complex: a large number of capabilities have been added, giving access to some parts of the file system and registry that were previously unreachable. Obviously, this is only in the AllCapabilities version. This version is still compatible with GDR3; I haven't targeted 8.1 yet. The other change, which impacts the standard-capability version as well, is that a lot of the initial navigation is now cleaner and the static pages have received script tweaks to improve navigation. Also, it is now clearly stated when the current path has no subkeys/values/files, and the ../ directory entry simply takes you to the parent directory instead of literally appending .. (although that still works, if you want to use it).
PLEASE REPORT ANY BUGS YOU FIND IN THE CURRENTLY IMPLEMENTED FEATURES, ESPECIALLY THE NEW ONES!
The .REG file creation had to be written from scratch - I can call the native function that's supposed to do it, but if fails unless you have SeBackupPrivilege, which I haven't been able to add to an app - and it probably needs more testing. I also don't actually promise that the .REG files are importable using regedit; they should be but I have *not* tested that. I made some unusual choices in how the file is generated (everything is presented as binary, which means I didn't need to worry about things like quotes in strings or DWORDs that are 20 bytes long. I also embedded a ton of comments, including the non-binary representations of the values. Speed is pretty good but very un-optimized so I may improve it later (in the meantime, downloading all of HKLM at once will take a little while).
I still plan to implement upload/write operations... some day! I'm also looking at moving the server to a background process and making the app just a control UI for it, adding support for authentication and/or HTTPS, adding some stylesheets to the web UI, adding cache control, and much more.
As with the last few releases, the XAP is published twice; once as a fairly standard XAP that any phone can sideload, the second with many exotic capabilities to enable viewing of slightly more of the file system. The standard XAP has had its list of capabilities expanded to pretty much all of them that can be used without interop-unlock. The high-capability variant requires not just interop-unlock
, but the additional capability-unlock hack available in the interop-unlock thread.
An item of note: the AllCapabilities version can open other drives in the file system. On phones with an SD card, it is mounted at D:\ and you can browse it as normal. Credit to @hjc4869
for this discovery!
Version 0.5.3 comes with an update to the NativeAccess
libraries as well, in particular an improvement to the Registry::RegistryKey class that was never really there before. I plan to add some of the stuff in the new library versions, such as process listing, "soon" though. The HttpServer also got a small update.
This is a very basic webserver app which can enumerate those files that are in folders readable from the sandbox, can download files, can browse the registry, and can display the contents of registry values of any type. It runs on WP8.x only. It is a spiritual successor to the Functional Webserver / WebServer (Mango)
projects from WP7. This version is still missing a lot of functionality as I decided to implement it from scratch, but it is advancing swiftly. Note that there's no access controls implemented; use it on a public network only at your own risk!
Instructions are simple: sideload the XAP, connect to WiFi (required), run the app (called "WebServer Native Access"), point a web browser (on a PC or phone that is also on that local network) to the URL that the app displays. You should get a basic index page. Click on a Filesystem or Registry link to begin browsing the phone. There's a textbox near the top of all filesystem pages, type in a path there (for example, "\windows" with no quotes) and hit Enter or click Get Files. You'll see a list of the contents of that folder. Click on a file to download it or a directory to open it. Navigating the registry is similar, except you'll need to specify the registry hive and then the path from that hive (or no path, to access the root of the hive).
Modifications (uploading or editing files, creating, deleting, or changing registry keys or values) are currently not supported. They will be "soon" although my personal testing suggests that basically the whole registry, and most of the file system, is off-limits for writing unless you use restricted capabilities. Interestingly, I can *read* most of the registry, including stuff that I probably shouldn't be able to.
You might see an error code (error 5 is "ACCESS_DENIED", you'll see it a lot). Or you might see a status 500 message because of an exception in the server. Or the server may just crash (hopefully not so often anymore...). I'm making it more resilient, but there are still bugs. Please report any previously-unreported issues you find, including how to reproduce them, and I'll fix them if possible.
Also feel free to request features or changes; I'll implement them if reasonably possible. The app is a mixture of C++ and C# code; I could probably have done it all in one or the other but wanted to have a C++ component in case I ran into something that wasn't available in C#, and although it probably would have saved some time, I decided that hacking up a web server in C++ was maybe not the best idea.
The source code is on Codeplex, at the following projects: https://wp8webserver.codeplex.com/
for the server and the app (C#) and https://wp8nativeaccess.codeplex.com/
for the native access wrappers (C++). You may have to fix up the reference paths to get the C# component to see the C++ component correctly. The code is reasonably well documented, but let me know if you have any questions. Permission to re-use the code or components is granted under the MS-PL (Microsoft Permissive License) as posted on Codeplex.
Go forth and find cool stuff!
0.2.0: Initial release, FS only, 920 downloads (source: 652 downloads)
0.3.2: initial registry, HTTP server and web app encapsulation, source on Codeplex, 225 downloads
0.3.3: bugfixes, 454 downloads
0.4.2: basic registry values display, 86 downloads
0.4.3: bugfixes, 326 downloads
0.4.6: multistring registry values, bugfixes, updated libraries, first AllCapabilities version (950 downloads), 453 downloads
25 Oct 2013 - 0.4.8: binary and long registry values, formatting and bugfixes, 451 downloads AllCaps, 201 normal
22 Dec 2013 - 0.4.9: all registry value types, better threading, proper resume, remembers port, 97 downloads AllCaps, 53 normal
24 Dec 2013 - 0.5.0: background operation using Location APIs. Downloads: 1011 AllCaps, 963 Normal
20 Jul 2014 - 0.5.1: More capabilities, better navigation. Downloads: 108 AllCaps, 61 normal
07 Aug 2014 - 0.5.3: .REG export, better traversal, bugfixes.