aws-cloudformation / aws-cloudformation/cloudformation-coverage-roadmap

AWS::CloudFormation::GuardHook - Enhancement - Native centralized aggregation of Managed Hook invocation results across AWS Organizations

Open
#2,504 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
No language data
Stars
1.1k
Forks
62
PR merge metrics
No merged PRs in 30d

Description

### Name of the resource

Other

### Resource name

AWS::CloudFormation::GuardHook

### Description
We are using AWS CloudFormation Managed Hooks (via Control Catalog) across a large AWS Organizations environment (~600+ accounts) to enforce governance controls.

"Proactive controls as Hooks – Evaluates resources using proactive controls from the AWS Control Tower Control Catalog".

While Managed Hooks meet our enforcement requirements, we’ve identified a significant gap in centralized observability and reporting of hook invocations.

With the introduction of the Hooks Invocation Summary page (September 2025) and granular invocation details (November 2025), CloudFormation now provides excellent per-account visibility into Hook activity — including which controls were invoked, execution details, and outcomes (pass, warn, fail).

However, for organizations managing dozens or hundreds of accounts via AWS Organizations, there is no native mechanism to aggregate and view Hook invocation results across all member accounts from a single pane of glass. This creates significant operational overhead for centralized governance, compliance, and security teams who need organization-wide visibility into Hook enforcement outcomes.

Current Workarounds
Today, achieving cross-account aggregation requires stitching together multiple services manually:

EventBridge cross-account event forwarding — Setting up rules in each member account to forward CloudFormation Hook events to a central event bus in a management/audit account.
CloudWatch Logs + StackSets — Deploying logging infrastructure via StackSets and using CloudWatch Logs Insights for querying.
S3 + Athena — Routing events to a centralized S3 bucket and querying with Athena.
AWS Config Organization Aggregator — Provides some compliance data but does not capture granular Hook invocation details (e.g., individual control findings, severity, remediation advice).
These workarounds are complex to set up, maintain, and scale — especially as new accounts are added to the Organization.

Requested Feature
A native, organization-wide aggregation capability for Managed Hook invocation results, accessible from a delegated administrator or management account. Ideally, this would include:

Centralized dashboard/console view — Similar to the existing per-account Hooks Invocation Summary, but aggregated across all accounts and OUs in the Organization.
Cross-account querying — Ability to filter and search Hook invocation results by account, OU, region, hook type, outcome (pass/warn/fail), severity, and time range.
Compliance reporting — Exportable summaries showing organization-wide Hook compliance posture (e.g., percentage of resources passing all Hooks, top failing controls, trends over time).
Delegated administrator support — Allow a designated audit/security account to access aggregated results without requiring management account credentials.
API support — Programmatic access to aggregated results via ListHookResults or a new API that supports cross-account queries with Organizations integration.

Use Cases
Central Security/Compliance Team — Needs a single view of all Hook enforcement outcomes across the organization to ensure policy compliance and generate audit reports.
Incident Response — Quickly identify which accounts/regions have failing Hooks to prioritize remediation.
Executive Reporting — Provide leadership with organization-wide compliance dashboards without manual data aggregation.
Drift Detection — Identify accounts where Hooks are not deployed or are producing unexpected results compared to organizational baselines.

Proposed Implementation Approach
This could follow patterns already established by other AWS services:

AWS Config — Organization-wide aggregator with delegated administrator support
AWS Security Hub — Cross-account findings aggregation
AWS CloudTrail — Organization trails with centralized logging
AWS User Notifications — Managed notification aggregation for Organizations
Impact
This feature would significantly reduce the operational burden on organizations using CloudFormation Hooks at scale and would make Hooks a more compelling choice for enterprise-wide governance and compliance enforcement.

### Other Details

_No response_

Contributor guide

Open the contributing guide

Research direction

No repository files, tests, or entry points are identified. Start by reviewing the existing CloudFormation Hooks Invocation Summary and the listed cross-account workarounds, then assess the requested organization-wide dashboard, querying, reporting, delegated administration, and API support; done would mean a defined native aggregation capability meeting those requirements.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws
Domain
cloud
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.