jackrabbit-oak-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ang...@apache.org
Subject svn commit: r1560461 - /jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences_accesscontrol.md
Date Wed, 22 Jan 2014 18:19:23 GMT
Author: angela
Date: Wed Jan 22 18:19:23 2014
New Revision: 1560461

URL: http://svn.apache.org/r1560461
Log:
OAK-1350 : Inconsistent Principal Validation between API and Import behavior

Modified:
    jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences_accesscontrol.md

Modified: jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences_accesscontrol.md
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences_accesscontrol.md?rev=1560461&r1=1560460&r2=1560461&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences_accesscontrol.md (original)
+++ jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences_accesscontrol.md Wed Jan 22
18:19:23 2014
@@ -60,6 +60,14 @@ is still performed in the corresponding 
 validation is delegated to the commit phase and executed by a specific `Validator`
 implementation.
 
+The default behavior with respect to principal validation is compliant with the
+specification and the same as in Jackrabbit 2.x.: Adding an ACE for an principal
+unknown to the repository will fail. However in order to be consistent
+with the ability have a more relaxed behavior upon XML import that validation
+will be relaxed if the import behavior is being changed to allow for unknown
+principals (see ([OAK-1350](https://issues.apache.org/jira/browse/OAK-1350))) and
+the section Import below.
+
 Restrictions: as of OAK the optional restrictions present with a given
 `JackrabbitAccessControlEntry` can be multivalued (see below).
 
@@ -86,6 +94,30 @@ The implementation of the additional res
     - "rep:ntNames", which allows to limit the affected ACE to nodes of the specified node
type(s)
     - "rep:prefixes", which allows to limit the effect to item names that have a specific
namespace prefix.
 
+##### Import
+
+The import of access control content via JCR XML import has been extended to
+respect the `o.a.j.oak.spi.xml.ImportBehavior` flags instead of just performing
+a best effort import.
+
+Currently the `ImportBehavior` is only used to switch between different ways of
+handling principals unknown to the repository. For consistency and in order to
+match the validation requirements as specified by `AccessControlList#addAccessControlEntry`
+the default behavior is ABORT (while in Jackrabbit 2.x the behavior always was BESTEFFORT).
+
+The different `ImportBehavior` flags are implemented as follows:
+- `ABORT`: throws an `AccessControlException` if the principal is unknown
+- `IGNORE`: ignore the entry defining the unknown principal
+- `BESTEFFORT`: import the access control entry with an unknown principal.
+
+In order to get the same best effort behavior as present with Jackrabbit 2.x
+the configuration parameters of the `AuthorizationConfiguration` must contain
+the following entry:
+
+    importBehavior = "besteffort"
+
+See also ([OAK-1350](https://issues.apache.org/jira/browse/OAK-1350)))
+
 #### 2. Node Types
 
 As mentioned above the node type definitions have been extended to match the new functionality
related to restrictions.



Mime
View raw message