Config Authoring

adobe/skills/plugins/aem/6.5-lts/skills/dispatcher/config-authoring

作者 adobe940b8795c0dfApache-2.0197 个星标收录于 2026年10月9日更新于 2026年10月8日仓库今天更新

Create, modify, review, and harden configuration for the Adobe Dispatcher Apache HTTP Server module and Apache HTTPD in AEM 6.5 LTS environments only. Use for `.any`, vhost, rewrite, cache, and filter changes.

仅含说明DevOps & Cloud
AI 生成的概览

为 AEM 6.5 AMS 环境编写、审查并加固 Adobe Dispatcher 与 Apache HTTPD 配置。

功能
指导对 Dispatcher 和 HTTPD 配置进行最小化、确定性的修改,例如 .any 文件、虚拟主机、重写规则、缓存和过滤器部分。流程包括确认范围、应用防护规则、分解 URL、以最小权限进行编辑、执行静态检查和运行时验证。产出包括差异、证据表、所选测试 ID 以及风险和回滚计划。
适用场景
适用于在 AEM 6.5 LTS AMS 部署中创建、修改、审查或加固 Dispatcher 与 Apache HTTPD 配置。适合 .any 文件、虚拟主机、重写、缓存和过滤器变更,包括使用 auth_checker 的权限敏感缓存。
运行要求
需要适用于 AMS 的 Dispatcher MCP(AEM_DEPLOYMENT_MODE=ams)或预设为 ams 的 AMS Dispatcher MCP SDK,并提供 validate、lint、sdk、trace_request、inspect_cache、monitor_metrics 和 tail_logs 工具。运行时验证需要主机路径和日志环境。不附带脚本,仅含说明和参考文档。

Dispatcher Config Authoring (AMS)

Design minimal, deterministic changes for the Adobe Dispatcher Apache HTTP Server module and related HTTPD configuration in AEM 6.5/AMS, then verify with MCP evidence.

Variant Scope

  • This skill is AMS-only.
  • Scope is fixed by this skill directory; do not ask the user to choose deployment variant.

MCP Tool Contract

Use only these Dispatcher MCP tools:

  • validate
  • lint
  • sdk
  • trace_request
  • inspect_cache
  • monitor_metrics
  • tail_logs

Workflow

text
AMS Config Progress- [ ] 1) Confirm scope and acceptance criteria; if the repo layout is unclear, normalize it with `repo-layout-workflows.md`- [ ] 2) Apply AMS 6.5 guardrails for tier routing, variables, flush ACL, and immutable boundaries- [ ] 3) Decompose target URLs (path/selectors/extension/suffix) and use that model for all URL-based rules—filters, cache rules, etc.—using `/path`, `/selectors`, `/extension`, `/suffix` or aligned globs (not raw `/url`) where applicable; then design complete section-level edits- [ ] 4) Update config with least-privilege defaults (produce final merged section, not isolated rule snippets)- [ ] 5) Run static checks: validate -> lint (deep/order-aware when filters changed)- [ ] 6) Run SDK checks: `sdk({"action":"check-files","config_path":"<dispatcher src path>"})`, `sdk({"action":"diff-baseline","config_path":"<dispatcher src path>"})` as needed- [ ] 7) Run runtime verification in host-path/log environment- [ ] 8) Return diff, evidence table, risk/rollback, and citations

Verification Scope Selection

Use the shared references to select the minimum evidence set:

  • mode-specific-verification-matrix.md
  • test-case-catalog.md

Output Contract

Always include:

  • files changed + intent
  • exact insertion location and final merged section content for each edited block
  • checks executed + evidence
  • selected test IDs
  • risk/rollback plan
  • residual risks and next checks

Feature cross-boundary (Playbook G: auth_checker)

Permission-sensitive caching (/auth_checker) is end-to-end: it requires both Dispatcher config and an AEM servlet. When implementing Playbook G from scratch, create or verify the auth-check servlet in the project core bundle (path /bin/permissioncheck, HEAD/GET, 200 or 403) and allowlist it on publish; then add the /auth_checker block, filter allow for the endpoint, and /allowAuthorized "1" in /cache. See config-scenario-playbooks.md Playbook G and reference-snippets.md.

Guardrails

  • Do not weaken deny-by-default security posture without explicit user approval.
  • Do not claim runtime verification if host-path/log prerequisites were missing.
  • Keep changes minimal and scoped.

References

  • config-patterns.md
  • config-scenario-playbooks.md – high-value development scenarios adapted from broader MCP surfaces to core-7 execution
  • reference-snippets.md – reusable starter snippets for consistent config authoring
  • validation-playbook.md
  • mcp-tool-orchestration.md
  • For runtime prompts and troubleshooting scenarios (tail_logs, trace_request, monitor_metrics, inspect_cache), use the incident-response skill reference runtime-prompts-and-troubleshooting-scenarios.md when incident triage is needed.
  • quick-start-execution-path.md – single entry path for new users and broad requests
  • repo-layout-workflows.md – map the user repo to the dispatcher src root and likely file families
  • playbook-command-linkage.md – convert selected playbooks into exact MCP command chains
  • ams-6-5-guardrails.md
  • mode-specific-verification-matrix.md
  • test-case-catalog.md
  • change-risk-and-rollback-template.md
  • public-doc-citation-rules.md
  • public-docs-index.md
  • core-7-tools-reference.md

来源与署名

来源:adobe/skills位于plugins/aem/6.5-lts/skills/dispatcher/config-authoring提交940b879

许可证: Apache-2.0

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架