<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Language" content="en-us" /> <meta name="ROBOTS" content="ALL" /> <meta http-equiv="imagetoolbar" content="no" /> <meta name="MSSmartTagsPreventParsing" content="true" /> <meta name="Keywords" content="cherokee web server httpd http" /> <meta name="Description" content="Cherokee is a flexible, very fast, lightweight Web server. It is implemented entirely in C, and has no dependencies beyond a standard C library. It is embeddable and extensible with plug-ins. It supports on-the-fly configuration by reading files or strings, TLS/SSL (via GNUTLS or OpenSSL), virtual hosts, authentication, cache friendly features, PHP, custom error management, and much more." /> <link href="media/css/cherokee_doc.css" rel="stylesheet" type="text/css" media="all" /> </head> <body> <h2 id="_a_href_index_html_index_a_8594_a_href_modules_html_modules_a_8594_a_href_modules_validators_html_validators_a"><a href="index.html">Index</a> → <a href="modules.html">Modules</a> → <a href="modules_validators.html">Validators</a></h2> <div class="sectionbody"> <h3 id="_validator_plain">Validator: Plain</h3><div style="clear:left"></div> <div class="paragraph"><p>The plain validator uses a flat-file to authenticate users.</p></div> <h4 id="_syntax">Syntax</h4> <div class="paragraph"><p>Each line defines a user. The username and password are delimited by a <tt>`:</tt>` colon.</p></div> <h4 id="parameters">Parameters</h4> <div class="tableblock"> <table rules="all" width="100%" frame="border" cellspacing="0" cellpadding="4"> <col width="20%" /> <col width="80%" /> <thead> <tr> <th align="left" valign="top">Parameter </th> <th align="left" valign="top">Description</th> </tr> </thead> <tbody> <tr> <td align="left" valign="top"><p class="table"><em>passwdfile</em></p></td> <td align="left" valign="top"><p class="table">Required. The location of the user/pass file.</p></td> </tr> </tbody> </table> </div> <div class="paragraph"><p>The parameter that specifies the file containing the pairs <em>user:password</em> is mandatory. <tt>Plain</tt> authentication can use both <tt>Basic</tt> and <tt>Digest</tt> schemes.</p></div> <div class="paragraph"><p>You can and should place the password file outside the web tree to prevent remote users from accessing the list.</p></div> <div class="imageblock"> <div class="content"> <img src="media/images/admin_validators_plain.png" alt="media/images/admin_validators_plain.png" /> </div> </div> <div class="paragraph"><p>This could be the contents of the the file <tt>/var/www/passwd</tt> specified in this example:</p></div> <div class="sidebarblock"> <div class="sidebar-content"> <div class="paragraph"><p>testuser:testpassword</p></div> <div class="paragraph"><p>cherokee:webserver</p></div> </div></div> <div class="paragraph"><p>This would only allow access to the users <tt>cherokee</tt> and <tt>testuser</tt>.</p></div> <h4 id="compatibility">Compatibility</h4> <div class="paragraph"><p>This validator is compatible with both <strong>basic</strong> and <strong>digest</strong> schemes.</p></div> </div> <div id="footer"> <div id="footer-text"> </div> </div> </body> </html>