directive. Typically this login page will contain an HTML form, asking the user to
provide their usename and password.</p>
- <div class="example"><h3>Example login form</h3><p><code>
- <form method="POST" action="/dologin.html"><br />
- Username: <input type="text" name="httpd_username" value="" /><br />
- Password: <input type="password" name="httpd_password" value="" /><br />
- <input type="submit" name="login" value="Login" /><br />
- </form><br />
- </code></p></div>
+ <div class="example"><h3>Example login form</h3><pre class="prettyprint lang-html">
+<form method="POST" action="/dologin.html">
+ Username: <input type="text" name="httpd_username" value="" />
+ Password: <input type="password" name="httpd_password" value="" />
+ <input type="submit" name="login" value="Login" />
+</form>
+ </pre>
+</div>
<p>The part that does the actual login is handled by the <var>form-login-handler</var>.
The action of the form should point at this handler, which is configured within
form, as in the example below. As a result, the same <var>form-login-handler</var> can be
reused for different areas of a website.</p>
- <div class="example"><h3>Example login form with location</h3><p><code>
- <form method="POST" action="/dologin.html"><br />
- <span class="indent">
- Username: <input type="text" name="httpd_username" value="" /><br />
- Password: <input type="password" name="httpd_password" value="" /><br />
- <input type="submit" name="login" value="Login" /><br />
- <input type="hidden" name="httpd_location" value="http://example.com/success.html" /><br />
- </span>
- </form><br />
- </code></p></div>
+ <div class="example"><h3>Example login form with location</h3><pre class="prettyprint lang-html">
+<form method="POST" action="/dologin.html">
+ Username: <input type="text" name="httpd_username" value="" />
+ Password: <input type="password" name="httpd_password" value="" />
+ <input type="submit" name="login" value="Login" />
+ <input type="hidden" name="httpd_location" value="http://example.com/success.html" />
+</form>
+ </pre>
+</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
the original protected URL, without the page having to know what that
URL is.</p>
- <div class="example"><h3>Example inline login form</h3><p><code>
- <form method="POST" <strong>action=""</strong>><br />
- <span class="indent">
- Username: <input type="text" name="httpd_username" value="" /><br />
- Password: <input type="password" name="httpd_password" value="" /><br />
- <input type="submit" name="login" value="Login" /><br />
- </span>
- </form><br />
- </code></p></div>
+ <div class="example"><h3>Example inline login form</h3><pre class="prettyprint lang-html">
+<form method="POST" <strong>action=""</strong>>
+ Username: <input type="text" name="httpd_username" value="" />
+ Password: <input type="password" name="httpd_password" value="" />
+ <input type="submit" name="login" value="Login" />
+</form>
+</pre>
+</div>
<p>When the end user has filled in their login details, the form will make
an HTTP POST request to the original password protected URL.
<p>To enable body preservation, add three additional fields to the login form as
per the example below.</p>
- <div class="example"><h3>Example with body preservation</h3><p><code>
- <form method="POST" action=""><br />
- <span class="indent">
- Username: <input type="text" name="httpd_username" value="" /><br />
- Password: <input type="password" name="httpd_password" value="" /><br />
- <input type="submit" name="login" value="Login" /><br />
- <strong><input type="hidden" name="httpd_method" value="POST" /><br />
- <input type="hidden" name="httpd_mimetype" value="application/x-www-form-urlencoded" /><br />
- <input type="hidden" name="httpd_body" value="name1=value1&name2=value2" /></strong><br />
- </span>
- </form>
- </code></p></div>
+ <div class="example"><h3>Example with body preservation</h3><pre class="prettyprint lang-html">
+<form method="POST" action="">
+ Username: <input type="text" name="httpd_username" value="" />
+ Password: <input type="password" name="httpd_password" value="" />
+ <input type="submit" name="login" value="Login" />
+ <br /> <strong><input type="hidden" name="httpd_method" value="POST" />
+ <input type="hidden" name="httpd_mimetype" value="application/x-www-form-urlencoded" />
+ <input type="hidden" name="httpd_body" value="name1=value1&name2=value2" /></strong><br />
+</form>
+ </pre>
+</div>
<p>How the method, mimetype and body of the original request are embedded within the
login form will depend on the platform and technology being used within the website.