opensite-ai/opensite-skills / aws-security
aws-security
VerifiedCovers AWS security services and workflows — Security Hub V2 (OCSF) findings, connectors, aggregators, automation rules, and security posture summaries; Security Hub CSPM (V1/ASFF) controls and compliance standards; GuardDuty threat findings; Inspector vulnerability findings; Macie sensitive data findings; Detective investigation; and Security Lake configuration and data aggregation. Applicable when questions involve security posture, Exposure findings, CSPM failed controls, threat findings, vulnerability findings, sensitive data findings, automation rules, or cross-service security configuration across AWS environments. Procedures use standard AWS CLI syntax and work with or without the AWS MCP server.
references/security-hub-cspm-configuration.md
View on GitHub# Reviewing Security Hub CSPM Configuration
## Overview
Reviews Security Hub CSPM configuration — standards, controls, and compliance posture management using ASFF format. Covers enabled standards (FSBP, CIS, PCI-DSS, NIST 800-53, NIST 800-171, AI Best Practices, Resource Tagging), control status, automation rules, and organization-wide policy enforcement.
Security Hub CSPM provides two categories of functionality:
- **Compliance management** — standards, controls, compliance findings
- **ASFF hub features** — finding aggregation, automation rules, custom actions, cross-region aggregation
This skill works from both standalone accounts and delegated administrator accounts.
**API constraint:** MUST use V1 APIs (no `-v2` suffix) only. MUST NOT use V2 APIs.
**Membership:** Supports both Organizations (Central Configuration) and legacy invitation-based membership.
## Classify the Request
| Signal | Workflow |
|--------|----------|
| Standards enabled, control status, disabled controls | A: Review Standards & Controls |
| Automation rules, org-wide policies, standard enforcement | B: Review Automation & Policies |
## Workflow A: Review Standards & Controls
1. List enabled standards:
```bash
aws securityhub get-enabled-standards
```
2. For each enabled standard, list controls:
```bash
aws securityhub describe-standards-controls --standards-subscription-arn <arn>
```
3. Get security control definitions:
```bash
aws securityhub list-security-control-definitions
```
4. Batch check specific controls:
```bash
aws securityhub batch-get-security-controls --security-control-ids '["EC2.1","S3.1","IAM.1"]'
```
5. Identify disabled controls:
```bash
aws securityhub describe-standards-controls --standards-subscription-arn <arn> --query "Controls[?ControlStatus=='DISABLED']"
```
6. Check custom actions:
```bash
aws securityhub describe-action-targets
```
**Constraints:**
- MUST enumerate all enabled standards
- MUST report disabled controls with their DisabledReason
- SHOULD flag standards available but not enabled
- SHOULD note control count per standard (enabled vs total)
## Workflow B: Review Automation & Policies
0. Determine membership model:
```bash
aws securityhub describe-organization-configuration
```
If succeeds: Organizations (Central Configuration). If fails: may use invitation-based or not an admin.
1. List automation rules:
```bash
aws securityhub list-automation-rules
```
2. Get rule details:
```bash
aws securityhub batch-get-automation-rules --automation-rules-arns '["<arn>"]'
```
3. List configuration policies:
```bash
aws securityhub list-configuration-policies
```
4. Get policy details:
```bash
aws securityhub get-configuration-policy --identifier <policy-id>
```
5. Check policy associations:
```bash
aws securityhub list-configuration-policy-associations --filters '{"ConfigurationPolicyId":"<policy-id>"}'
```
6. Check org configuration:
```bash
aws securityhub describe-organization-configuration
```
**Security check:** Verify CloudTrail is enabled and logging Security Hub CSPM API calls (`securityhub:*` events without `-v2` suffix) for audit purposes.
## Constraints
- MUST run from delegated admin for policy management
- MUST report automation rules that suppress or archive findings
- MUST NOT paginate through all member accounts by default
- MUST only enumerate individual member status if user explicitly requests it
- SHOULD verify configuration policies enforce required standards across OUs
## Troubleshooting
| Symptom | Check |
|---------|-------|
| Standard shows enabled but no controls | describe-standards-controls — may be pending initial evaluation |
| Control status NOT_AVAILABLE | Resource type not present in account |
| Automation rule not triggering | Check rule criteria and RuleStatus=ENABLED |
| Configuration policy not applying | Verify association target and policy status |
## Output Sensitivity
Configuration output reveals enabled compliance standards, disabled controls with reasons, automation rule logic, configuration policy definitions, and organization enrollment structure. Present configuration summary first; offer raw API responses on request.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |