You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lenya.apache.org by an...@apache.org on 2003/07/31 17:56:26 UTC
cvs commit: cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol authenticators.xml accesscontrollers.xml authorizers.xml accesscontrollerresolvers.xml
andreas 2003/07/31 08:56:26
Modified: src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol
authenticators.xml accesscontrollers.xml
authorizers.xml accesscontrollerresolvers.xml
Log:
added some docs
Revision Changes Path
1.2 +14 -1 cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol/authenticators.xml
Index: authenticators.xml
===================================================================
RCS file: /home/cvs/cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol/authenticators.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- authenticators.xml 31 Jul 2003 14:07:42 -0000 1.1
+++ authenticators.xml 31 Jul 2003 15:56:26 -0000 1.2
@@ -15,8 +15,16 @@
<section>
<title>Introduction</title>
- <p>An authenticator is used to identify a certain entity.</p>
+ <p>An authenticator is used to identify a client.</p>
</section>
+
+<section>
+ <title>Declaring the Roles in lenya.roles</title>
+ <source><![CDATA[<role name="org.apache.lenya.cms.ac2.Authenticator"
+ shorthand="authenticator"
+ default-class="org.apache.lenya.cms.ac2.UserAuthenticator"/>]]></source>
+</section>
+
<section>
<title>UserAuthenticator</title>
<p>The UserAuthenticator uses the request parameters</p>
@@ -25,6 +33,11 @@
<li><code>password</code></li>
</ul>
<p>to authenticate or reject a user.</p>
+
+ <source><![CDATA[<component logger="lenya.ac.authenticator"
+ class="org.apache.lenya.cms.ac2.UserAuthenticator"
+ role="org.apache.lenya.cms.ac2.Authenticator"/>]]></source>
+
</section>
</body>
1.4 +4 -3 cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol/accesscontrollers.xml
Index: accesscontrollers.xml
===================================================================
RCS file: /home/cvs/cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol/accesscontrollers.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- accesscontrollers.xml 31 Jul 2003 15:32:44 -0000 1.3
+++ accesscontrollers.xml 31 Jul 2003 15:56:26 -0000 1.4
@@ -46,7 +46,7 @@
</section>
<section>
- <title>DefaultAccessController</title>
+ <title>Default Access Controller</title>
<p>The DefaultAccessController combines an
<link href="authenticators.html">Authenticator</link>, a set of
<link href="authorizers.html">Authorizers</link>, an
@@ -63,7 +63,8 @@
role="org.apache.lenya.cms.ac2.AccessController/global">
<accreditable-manager type="file">
- <parameter name="directory" value="context:///lenya/config/ac/passwd"/>
+ <parameter name="directory"
+ value="context:///lenya/config/ac/passwd"/>
</accreditable-manager>
<policy-manager type="file"/>
@@ -77,7 +78,7 @@
</section>
<section>
- <title>BypassableAccessController</title>
+ <title>Bypassable Access Controller</title>
<p>The BypassableAccessController is a DefaultAccessController that can be
bypassed for certain URL patterns. For URLs that match those patterns
(regular expressions), access is granted for free.</p>
1.2 +4 -3 cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol/authorizers.xml
Index: authorizers.xml
===================================================================
RCS file: /home/cvs/cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol/authorizers.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- authorizers.xml 31 Jul 2003 14:07:42 -0000 1.1
+++ authorizers.xml 31 Jul 2003 15:56:26 -0000 1.2
@@ -29,11 +29,12 @@
parameter and checks the usecase policy file for the roles that are
allowed to execute this usecase. The location of this file is defined
using the <code><![CDATA[<config-file>]]></code> tag:</p>
- <source>
-<![CDATA[<authorizer type="usecase">
+ <source><![CDATA[<authorizer type="usecase">
<config-file src="context:///lenya/pubs/default/config/ac/usecase-policies.xml"/>
-</authorizer>]]> </source>
+</authorizer>]]></source>
+
<p>The usecase policy file might look as follows:</p>
+
<source><![CDATA[<?xml version="1.0"?>
<usecases xmlns="http://apache.org/cocoon/lenya/ac/1.0">
<usecase id="create-workflow">
1.3 +30 -25 cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol/accesscontrollerresolvers.xml
Index: accesscontrollerresolvers.xml
===================================================================
RCS file: /home/cvs/cocoon-lenya/src/webapp/lenya/pubs/docs-new/content/xdocs/docs/concepts/accesscontrol/accesscontrollerresolvers.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- accesscontrollerresolvers.xml 31 Jul 2003 15:32:44 -0000 1.2
+++ accesscontrollerresolvers.xml 31 Jul 2003 15:56:26 -0000 1.3
@@ -31,38 +31,41 @@
<source><![CDATA[<role name="org.apache.lenya.cms.ac2.AccessControllerResolverSelector"
shorthand="access-controller-resolvers"
default-class="org.apache.avalon.excalibur.component.ExcaliburComponentSelector">
- <hint shorthand="configurable" class="org.apache.lenya.cms.ac2.ConfigurableAccessControllerResolver"/>
- <hint shorthand="publication" class="org.apache.lenya.cms.ac2.PublicationAccessControllerResolver"/>
- <hint shorthand="composable" class="org.apache.lenya.cms.ac2.ComposableAccessControllerResolver"/>
+ <hint shorthand="configurable"
+ class="org.apache.lenya.cms.ac2.ConfigurableAccessControllerResolver"/>
+ <hint shorthand="publication"
+ class="org.apache.lenya.cms.ac2.PublicationAccessControllerResolver"/>
+ <hint shorthand="composable"
+ class="org.apache.lenya.cms.ac2.ComposableAccessControllerResolver"/>
</role>]]></source>
</section>
<section>
- <title>Declaring the AccessControllerResolvers in cocoon.xconf</title>
+ <title>Declaring the Access Controller Resolvers in cocoon.xconf</title>
<source><![CDATA[<access-controller-resolvers>
- <component-instance logger="lenya.ac.accesscontrollerresolver.publication"
- class="org.apache.lenya.cms.ac2.PublicationAccessControllerResolver"
- name="publication">
- </component-instance>
- <component-instance logger="lenya.ac.accesscontrollerresolver.global"
- class="org.apache.lenya.cms.ac2.ConfigurableAccessControllerResolver"
- name="global">
- <access-controller type="global"/>
- </component-instance>
- <component-instance logger="lenya.ac.accesscontrollerresolver.composable"
- class="org.apache.lenya.cms.ac2.ComposableAccessControllerResolver"
- name="composable">
- <resolver type="publication"/>
- <resolver type="global"/>
- </component-instance>
+ <component-instance logger="lenya.ac.accesscontrollerresolver.publication"
+ class="org.apache.lenya.cms.ac2.PublicationAccessControllerResolver"
+ name="publication">
+ </component-instance>
+ <component-instance logger="lenya.ac.accesscontrollerresolver.global"
+ class="org.apache.lenya.cms.ac2.ConfigurableAccessControllerResolver"
+ name="global">
+ <access-controller type="global"/>
+ </component-instance>
+ <component-instance logger="lenya.ac.accesscontrollerresolver.composable"
+ class="org.apache.lenya.cms.ac2.ComposableAccessControllerResolver"
+ name="composable">
+ <resolver type="publication"/>
+ <resolver type="global"/>
+ </component-instance>
</access-controller-resolvers>]]></source>
</section>
<section>
- <title>PublicationAccessControllerResolver</title>
+ <title>Publication Access Controller Resolver</title>
<p>The PublicationAccessControllerResolver looks for a <code>config/ac.xconf</code>
file inside the publication. If you want to use multiple AccessControllers
within your Lenya installation, just declare them in the <code>
@@ -71,10 +74,12 @@
<source><![CDATA[<?xml version="1.0"?>
<access-controller type="publication-file">
<authorizer type="usecase">
- <config-file src="context:///lenya/pubs/default/config/ac/usecase-policies.xml"/>
+ <config-file
+ src="context:///lenya/pubs/default/config/ac/usecase-policies.xml"/>
</authorizer>
<accreditable-manager>
- <parameter name="directory" value="context:///lenya/pubs/default/config/ac/passwd"/>
+ <parameter name="directory"
+ value="context:///lenya/pubs/default/config/ac/passwd"/>
</accreditable-manager>
</access-controller>]]></source>
<p>As you see here, you can put additional configuration code inside the
@@ -84,9 +89,9 @@
</section>
<section>
- <title>ConfigurableAccessControllerResolver</title>
+ <title>Configurable Access Controller Resolver</title>
<p>The ConfigurableAccessControllerResolver can be configured with an
- AccessController directly inside cocoon.xconf:</p>
+ AccessController directly inside <code>cocoon.xconf</code>:</p>
<source><![CDATA[<component-instance logger="lenya.ac.accesscontrollerresolver"
class="org.apache.lenya.cms.ac2.ConfigurableAccessControllerResolver"
name="global">
@@ -95,7 +100,7 @@
</section>
<section>
- <title>ComposableAccessControllerResolver</title>
+ <title>Composable Access Controller Resolver</title>
<p>The ComposableAccessControllerResolver is configured with a list of
AccessControllerResolvers. Each one of these resolvers is invoked until one
is successful. If no resolver finds an AccessController, the
---------------------------------------------------------------------
To unsubscribe, e-mail: lenya-cvs-unsubscribe@cocoon.apache.org
For additional commands, e-mail: lenya-cvs-help@cocoon.apache.org