AEM中的服务用户

概述

在AEM中获取管理会话或资源解析程序的主要方法是使用Sling提供的SlingRepository.loginAdministrative()和ResourceResolverFactory.getAdministrativeResourceResolver()方法。

但是，这两种方法都没有围绕权限最小原则来设计，而且开发人员很容易就无法为其内容尽早规划适当的结构和相应的访问控制级别(ACL)。如果此类服务中存在漏洞，则通常会导致向admin用户权限升级，即使代码本身不需要管理权限也可正常工作。

如何逐步停用管理员会话

优先级0:该功能是否处于活动状态/需要/废弃？

有时可能未使用管理员会话，或者完全禁用该功能。如果您的实施存在这种情况，请确保完全删除该功能，或将其与NOP代码配合使用。

优先级1:使用请求会话

尽可能重新构建您的功能，以便使用经过身份验证的给定请求会话来读取或写入内容。如果这不可行，则通常可以通过采用下列优先事项来实现。

优先级2:重构内容

许多问题可以通过重组内容来解决。在进行重构时，请牢记以下简单的规则：

更改访问控制
- 确保真正需要访问权限的用户或组实际拥有访问权限；
优化内容结构
- 将其移动到其他位置，例如，在访问控制与可用请求会话匹配的位置；
- 更改内容粒度；
重新构建代码以提供适当的服务
- 将业务逻辑从JSP代码移动到服务。这允许进行不同的内容建模。

此外，请确保您开发的任何新功能都遵循以下原则：

安全要求应驱动内容结构
- 管理访问控制应该感觉很自然
- 访问控制必须由存储库（而非应用程序）强制执行
使用节点类型
- 限制可设置的属性集
遵守隐私设置
- 对于专用用户档案，例如不显示在专用/profile节点上的用户档案图片、电子邮件或全名。

严格访问控制

无论您是在重组内容时应用访问控制，还是在为新服务用户应用访问控制时，都必须尽可能应用最严格的ACL。使用所有可能的访问控制设施：

例如，不应在/apps上应用jcr:read，而只将其应用于/apps/*/components/*/analytics
使用restrictions
对节点类型应用ACL
限制权限
- 例如，当只需要写入属性时，不要授予jcr:write权限；请改用jcr:modifyProperties

服务用户和映射

如果上述方法失败，Sling 7提供了服务用户映射服务，该服务允许配置包到用户的映射以及两个相应的API方法： [SlingRepository.loginService()](https://sling.apache.org/apidocs/sling7/org/apache/sling/jcr/api/SlingRepository.html#loginService-java.lang.String-java.lang.String-)和 [ResourceResolverFactory.getServiceResourceResolver()](https://sling.apache.org/apidocs/sling7/org/apache/sling/api/resource/ResourceResolverFactory.html#getServiceResourceResolver-java.util.Map-)，它们仅返回具有配置用户权限的会话/资源解析程序。这些方法具有以下特征：

它们允许将服务映射到用户
它们使用户能够定义子服务用户
中心配置点是：org.apache.sling.serviceusermapping.impl.ServiceUserMapperImpl
service-id = service-name [ ":"subservice-name ]
service-id 映射到资源解析程序和/或JCR存储库用户ID以进行身份验证
service-name 是提供服务的包的符号名称

其他Recommendations

将admin-session替换为service-user

服务用户是JCR用户，没有设置密码，并且拥有执行特定任务所需的最少权限集。未设置密码意味着无法与服务用户登录。

一种弃用管理会话的方法是，将其替换为服务用户会话。如果需要，也可以由多个子服务用户替换。

要将管理员会话替换为服务用户，您应执行以下步骤：

确定服务的必要权限，并牢记最少权限的原则。
检查是否已经有一个用户可用，且该用户完全符合您所需的权限设置。如果现有用户与您的需求不匹配，请创建新的系统服务用户。需要RTC来创建新的服务用户。有时，创建多个子服务用户（例如，一个用于写入，一个用于阅读）以划分更多访问权限是有意义的。
为用户设置和测试ACE。
为服务和user/sub-users添加service-user映射
使服务用户sling功能可用于您的包：更新至org.apache.sling.api的最新版本。
将代码中的admin-session替换为loginService或getServiceResourceResolver API。

创建新服务用户

在您确认AEM服务用户列表中的任何用户均不适用于您的用例，且相应的RTC问题已获得批准后，您可以继续将新用户添加到默认内容中。

建议创建服务用户以使用位于https://<server>:<port>/crx/explorer/index.jsp的存储库资源管理器

目标是获取有效的jcr:uuid属性，该属性是必需的，以便通过安装内容包来创建用户。

您可以通过以下方式创建服务用户：

转到位于https://<server>:<port>/crx/explorer/index.jsp的存储库资源管理器
通过按屏幕左上角的登录链接以管理员身份登录。
接下来，创建并命名您的系统用户。要将用户创建为系统用户，请将中间路径设置为system，并根据您的需要添加可选子文件夹：
验证您的系统用户节点是否如下所示：

注意

请注意，没有与服务用户关联的混合类型。这意味着系统用户将没有访问控制策略。

将相应的.content.xml添加到包的内容时，请确保已设置rep:authorizableId，并且主类型为rep:SystemUser。它应该如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:rep="internal"
    jcr:primaryType="rep:SystemUser"
    jcr:uuid="4917dd68-a0c1-3021-b5b7-435d0044b0dd"
    rep:principalName="authentication-service"
    rep:authorizableId="authentication-service"/>

向ServiceUserMapper配置添加配置修正

要将服务中的映射添加到相应的系统用户，您需要为 [ServiceUserMapper](https://sling.apache.org/apidocs/sling7/org/apache/sling/serviceusermapping/ServiceUserMapper.html)服务创建工厂配置。要保持此模块化，可使用Sling amend机制提供此类配置。在包中安装此类配置的推荐方法是使用Sling初始内容加载:

在包的src/main/resources文件夹下创建子文件夹SLING-INF/content
在此文件夹中，创建一个名为org.apache.sling.serviceusermapping.impl.ServiceUserMapperImpl.revined-<工厂配置的某个唯一名称>.xml的文件，其中包含工厂配置的内容（包括所有子服务用户映射）。示例:
在包的src/main/resources文件夹下创建SLING-INF/content文件夹；
在此文件夹中，创建一个文件named org.apache.sling.serviceusermapping.impl.ServiceUserMapperImpl.amended-<a unique name for your factory configuration>.xml，其中包含工厂配置的内容，包括所有子服务用户映射。

为了提供说明，请获取名为org.apache.sling.serviceusermapping.impl.ServiceUserMapperImpl.amended-com.adobe.granite.auth.saml.xml的文件：
```
<?xml version="1.0" encoding="UTF-8"?>
<node>
    <primaryNodeType>sling:OsgiConfig</primaryNodeType>
    <property>
        <name>user.default</name>
        <value></value>
    </property>
    <property>
        <name>user.mapping</name>
        <values>
            <value>com.adobe.granite.auth.saml=authentication-service</value>
        </values>
    </property>
</node>
```

在包pom.xml的maven-bundle-plugin配置中引用Sling初始内容。示例:

<Sling-Initial-Content>
   SLING-INF/content;path:=/libs/system/config;overwrite:=true;
</Sling-Initial-Content>

安装包并确保已安装出厂配置。您可以通过以下方式执行此操作：
- 转到位于https://serverhost:serveraddress/system/console/configMgr的Web控制台
- 搜索Apache Sling服务用户映射器服务修正
- 单击该链接可查看是否配置正确。

处理服务中的共享会话

对loginAdministrative()的调用通常会与共享会话一起显示。这些会话在服务激活时获取，并且仅在服务停止后注销。尽管这是常见的做法，但它导致了两个问题：

安全： 此类管理员会话用于缓存并返回绑定到共享会话的资源或其他对象。在调用堆栈的后面，这些对象可能会以提升的权限适应会话或资源解析器，而且调用者通常不清楚这是他们正在使用的管理员会话。
性能： 在Oak共享会话中，可能会导致性能问题，目前不建议使用这些会话。

安全风险最明显的解决方案是，只需将loginAdministrative()调用替换为具有受限权限的用户的loginService()调用。但是，这不会对任何潜在的性能下降产生任何影响。缓解这种情况的一种方法是，将所有请求的信息包含在与会话没有关联的对象中。然后，根据需要创建（或销毁）会话。

推荐的方法是重构服务的API，以便让调用方控制会话的创建/销毁。

JSP中的管理会话

JSP无法使用loginService()，因为没有关联的服务。但是，JSP中的管理会话通常是违反MVC模式的一个标志。

可以通过以下两种方式解决此问题：

以允许在用户会话中处理内容的方式重组内容；
将逻辑提取到提供API的服务，该API随后可供JSP使用。

第一种方法是首选方法。

处理事件、复制预处理器和作业

在处理事件或作业（在某些情况下是工作流）时，触发该事件的相应会话通常会丢失。这会导致事件处理程序和作业处理程序经常使用管理会话来完成其工作。可以想象的解决这个问题的方法各不相同，每种方法都有其优势和劣势：

在事件有效负载中传递user-id并使用模拟。

优点： 易于使用。

缺点： 仍使用 loginAdministrative()。它会重新验证已通过身份验证的请求。
创建或重复使用有权访问数据的服务用户。

优点： 与当前设计一致。需要最少的更改。

缺点： 需要非常强大的服务用户才能灵活，这很容易导致权限提升。规避安全模型。
在事件有效负载中传递Subject的序列化，并基于该主题创建ResourceResolver。例如，在ResourceResolverFactory中使用JAAS doAsPrivileged。

优势： 从安全角度清理实施。它避免了重新认证，并且以原始权限运行。安全相关代码对事件的消费者是透明的。

缺点： 需要重构。安全相关代码对事件的消费者是透明的，这一事实也可能导致问题。

第三种方法目前是首选的处理技术。

工作流进程

在工作流流程实施中，触发工作流的相应用户会话通常会丢失。这会导致通常使用管理会话来执行其工作的工作流进程。

为了解决这些问题，建议使用处理事件、复制预处理器和作业中提到的相同方法。

SlingPOST处理器和已删除的页面

slingPOST处理器实施中使用了几个管理会话。通常，管理会话用于访问正在处理的POST中处于待删除状态的节点。因此，它们将不再通过请求会话可用。可以访问节点挂起的删除以公开其他不应访问的元数据。

adobe.com 上的资源

Multichannel Communication Ecommerce Integrations Personalized Experiences Customer Communications Asset Collections Content Management System