--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" \r
+ "http://www.w3.org/TR/REC-html40/loose.dtd"> \r
+<HTML>\r
+<HEAD>\r
+ <link rel="stylesheet" type="text/css" href="../style/doc.css">\r
+ <TITLE>Authentication</TITLE>\r
+</HEAD>\r
+<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EE" VLINK="#551A8B"\r
+ ALINK="#FF0000">\r
+ <div class="icons-w3c">\r
+ <a href="../../../">\r
+ <img src="/Icons/w3c_home" \r
+ border="0" \r
+ alt="W3C logo"\r
+ height="48" \r
+ width="72">\r
+ </a>\r
+ </div>\r
+ <div class="icons-jigsaw">\r
+ <a href="../../">\r
+ <img src="/Icons/jigsaw" \r
+ border="0"\r
+ alt="Jigsaw"\r
+ height="49"\r
+ width="212">\r
+ </a>\r
+ </div>\r
+\r
+ <div class="title">\r
+<H1 class="title">\r
+ Authentication in Jigsaw\r
+</H1>\r
+<hr NOSHADE width="70%" align="left">\r
+ <a href="../../Overview.html">Jigsaw Home</a> /\r
+ <a href="../Overview.html">Documentation Overview</a> /\r
+ <a href="Tutorials.html">Tutorials</a>\r
+ </div>\r
+ <div class="body">\r
+<p>\r
+Setting up authentication requires you to run through the following stages:\r
+\r
+<P><B>1)</B> Open a JigAdmin window (see <A HREF="AdminTools.html">JigAdmin\r
+documentation</A>)\r
+\r
+<P><B>2)</B> Create an authentication realm, if required. You can of course\r
+reuse authentication realms to protect different areas of the server. Select\r
+the "<TT>realms</TT>" pane, type the name\r
+of your new realm (ie "<TT>w3c</TT>") in the "<TT>Realm name</TT>" field\r
+and type on <TT>Enter</TT>.\r
+<p>\r
+ <IMG SRC="images/auth1.gif" VSPACE=20 HEIGHT=401 WIDTH=666 \r
+ alt="add realm">\r
+\r
+<B>3)</B> Add some user for the new realm. Select the new realm "<TT>w3c</TT>", type the user name (ie "<TT>tim</TT>") in\r
+the appropiate field and click on the "<TT>Add User</TT>" button or\r
+ type <TT>Enter</TT>.\r
+<p>\r
+ <IMG SRC="images/auth2.gif" VSPACE=20 HEIGHT=401 WIDTH=666 \r
+ alt="user">\r
+<p><B>4)</B> Setup the user attributes. The user attributes are describe in\r
+the AuthUser <A HREF="../Reference/org.w3c.jigsaw.auth.AuthUser.html">reference\r
+page</A>. Don't forget to commit your changes.\r
+\r
+<p><B>5) </B>Setup an authentication filter on the appropriate frame. The\r
+target of the filter can be either a directory resource (in which case\r
+the filter will protect all the area defined by the sub-resources of this\r
+directory resource), or any other resource (hence allowing you to protect\r
+a single resource). Actually, the filter must be attached to the frame\r
+of the resource to filter. In this example we will setup a filter on a\r
+DirectoryResource.\r
+<OL>\r
+<LI>\r
+Select the resource you want to filter</LI>\r
+\r
+<LI>\r
+Click on the "<TT>Edit Resource</TT>" in the popup menu (right click).\r
+\r
+<LI>\r
+Expand the resource node (in the resource editor tree)\r
+\r
+<LI>\r
+Select the frame of this resource (should be HTTPFrame)\r
+\r
+<LI>\r
+Select "<TT>Add Frame</TT>" in the popup menu (right click)\r
+\r
+<LI>\r
+Select "<TT>org.w3c.jigsaw.auth.GenericAuthFilter</TT>" as the filter class</LI>\r
+\r
+<LI>\r
+Click on the "Ok" button.</LI>\r
+</OL>\r
+\r
+ <IMG SRC="images/auth3.gif" VSPACE=20 HEIGHT=401 WIDTH=666\r
+ alt="parameters"> \r
+<p><B>6)</B> Setup the authentication filter parameters. The GenericAuthFilter\r
+attributes are described in the <A HREF="../Reference/org.w3c.jigsaw.auth.GenericAuthFilter.html">reference\r
+page</A>. Type "<TT>w3c</TT>" in the "<TT>realm</TT>" field and "<TT>tim</TT>"\r
+in the "<TT>users</TT>" field. Don't forget to commit your changes.\r
+<p>\r
+ <IMG SRC="images/auth4.gif" VSPACE=20 HEIGHT=393 WIDTH=455\r
+ alt="users"> \r
+ <IMG SRC="images/auth6.gif" VSPACE=20 HEIGHT=445 WIDTH=455\r
+ alt="users"> \r
+<p>\r
+That's it, your resource has now a restricted access!\r
+ </div> <!-- body -->\r
+ <div class="footer">\r
+<p>\r
+<HR noshade>\r
+ <a href="mailto:jigsaw@w3.org">Jigsaw Team</a><br>\r
+ <span class="mini">\r
+ $Id: authentication.html,v 1.1 2010/06/15 12:22:55 smhuang Exp $\r
+ </span>\r
+ <p class="policyfooter">\r
+ <font size=-1>\r
+ <a href="/Consortium/Legal/ipr-notice.html#Copyright">Copyright</a>\r
+ © 1999 <a href="http://www.w3.org">W3C</a> \r
+ (<a href="http://www.lcs.mit.edu">MIT</a>, \r
+ <a href="http://www.inria.fr/">INRIA</a>, \r
+ <a href="http://www.keio.ac.jp/">Keio</a> ), \r
+ All Rights Reserved. W3C \r
+ <a href="/Consortium/Legal/ipr-notice.html#Legal Disclaimer">\r
+ liability,\r
+ </a>\r
+ <a href="/Consortium/Legal/ipr-notice.html#W3C Trademarks">\r
+ trademark\r
+ </a>, \r
+ <a href="/Consortium/Legal/copyright-documents.html">\r
+ document use \r
+ </a>\r
+ and\r
+ <a href="/Consortium/Legal/copyright-software.html">\r
+ software licensing\r
+ </a> rules apply. Your interactions with this site are in\r
+ accordance with our \r
+ <a href="/Consortium/Legal/privacy-statement.html#Public">\r
+ public\r
+ </a> and \r
+ <a href="/Consortium/Legal/privacy-statement.html#Members">\r
+ Member\r
+ </a>\r
+ privacy statements.</font>\r
+ </div>\r
+</BODY>\r
+</HTML>\r