Note:This article pertains to the CodePlex SDK initially released late 2009. The Windows Azure team has since then released a newer version of the Azure SDK for PHP on Github. Please refer to the Windows Azure PHP Developer Center for documentation on this more recent version of the SDK.
Please stay tuned and come back here regularly as we are working on refreshing the tutorials to deliver up to date and useful content for our PHP developers.
I'm taking a short break from thinking about testing PHP applications in Windows Azure (although, ultimately, this will tie into a post about testing). In this post, I'll show one way that you can password protect a directory for a PHP website running in Windows Azure. When looking for a way to do this, my searches turned up approaches that involved creating a Windows user and granting the right permissions to that user…which seemed like more overhead than I wanted to incur. Then, I found this post by Ruslan Yakushev: How to Secure WordPress Admin Directory on IIS 7.0. I essentially followed that approach (but generically, not just for WordPress). The only hurdle to getting it working in Azure was figuring out how to install the URL Authorization Module, which isn't installed by default on IIS in Azure.
I've tested the steps below when deploying a custom PHP installation to Azure and when using the default scaffold provided by the Windows Azure SDK for PHP (which uses the Web Platform Installer to install PHP).
Note: There really isn't anything specific to PHP here. The one assumption I've made is that you have a resources\WebPICmdLine directory in your root that contains the Web PI command line tools (which is the case if you use the default scaffold or follow my post about packaging a custom PHP installation). With that in place, you can use this approach with any language.
1. Download the FormsAuthForWordPress.zip file from Ruslan's post. After you have extracted the files, copy and paste the App_Data and App_Code directories and the login.aspx file into your project's root directory.
2. Edit the users.xml file in the App_Data directory. You will need to supply the name of the user (and his/her password) who will have access to the secured directory:
3. Edit the web.config file. You'll need to add (or add to) the following elements:
Add this to the <system.web> element:
Add this to the <configuration> element (replacing PrivateDir with the name of the directory you want to secure):
Add this to the <system.webserver> element:
4. Add the following script (install-urlauthmodule.cmd) to your project's bin directory:
5. Edit your ServiceDefinition.csdef file so that install-urlauthmodule.cmd is called as a startup task. Add the following element as the last child element of the <Startup> element:
Now you are ready to package and deploy your application. After deployment, when you attempt to browse to http://yoursite.cloudapp.net/PrivateDir, you should be greeted with this login in dialog:
Supplying the username/password specified in the users.xml file will then take you to the default document for the PrivateDir directory. To understand how this works, I recommend reading Ruslan's post: How to Secure WordPress Admin Directory on IIS 7.0.