[sling-site] branch master updated: SLING-9422 - Content Package Installer: Use service resource resolvers instead of admin resource resolver for installation

[ro...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

rombert pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/sling-site.git


The following commit(s) were added to refs/heads/master by this push:
     new 276ac6b  SLING-9422 - Content Package Installer: Use service resource resolvers instead of admin resource resolver for installation
276ac6b is described below

commit 276ac6b5dd27d52fa51bed901663151d133ed291
Author: Robert Munteanu <ro...@apache.org>
AuthorDate: Fri May 8 12:39:22 2020 +0200

    SLING-9422 - Content Package Installer: Use service resource resolvers instead of admin resource resolver for installation
    
    Document configuration with service users
---
 .../bundles/content-package-installer-factory.md   | 23 ++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/main/jbake/content/documentation/bundles/content-package-installer-factory.md b/src/main/jbake/content/documentation/bundles/content-package-installer-factory.md
index 91f6ea8..3bc4076 100644
--- a/src/main/jbake/content/documentation/bundles/content-package-installer-factory.md
+++ b/src/main/jbake/content/documentation/bundles/content-package-installer-factory.md
@@ -10,6 +10,29 @@ The content package installer factory provides support for [Jackrabbit FileVault
 
 Content Packages must be provided with extension `.zip`. They will be automatically installed/uninstalled via the [JcrPackageManager API](https://jackrabbit.apache.org/filevault/apidocs/org/apache/jackrabbit/vault/packaging/JcrPackageManager.html). The (un-)installation behaviour can be further tweaked via the OSGi configuration provided for PID `org.apache.sling.installer.factory.packages.impl.PackageTransformer`
 
+## Configuration
+
+As of version 1.0.4 the bundle requires a service user mapping to function correctly. An example mapping, using the provisioning model is
+
+```
+  org.apache.sling.serviceusermapping.impl.ServiceUserMapperImpl.amended-installer-factories
+    user.mapping=[
+      "org.apache.sling.installer.factory.packages\=sling-package-install"
+    ]
+```
+
+The service user requires needs access to all locations which are covered by packages and to `/etc/packages` itself.
+
+A sample user configuration using repoinit is
+
+```
+create service user sling-package-install
+
+set ACL for sling-package-install
+    allow  jcr:all     on  /
+    allow  jcr:namespaceManagement,jcr:nodeTypeDefinitionManagement on :repository
+end
+```
 
 # Project Info