Skip to content

opensite-ai/opensite-skills / aws-security

aws-security

Verified

Covers 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-lake-sources.md

View on GitHub
# Summarizing Security Lake Sources

## Overview

Produces structured summaries of Amazon Security Lake source configuration, subscriber status, and data lake exceptions. Gives operators a rapid view of data lake health without performing data queries.

Works from both standalone and delegated administrator accounts.

## Classify the Request

| User intent | Workflow |
|---|---|
| "What sources are configured?" | A: Sources & Ingestion Summary |
| "Show subscribers" / "Any data lake issues?" | B: Subscriber & Exception Overview |

## Workflow A: Sources & Ingestion Summary

1. Get configured sources:

   ```bash
   aws securitylake get-data-lake-sources
   ```

2. List log sources for detail:

   ```bash
   aws securitylake list-log-sources
   ```

3. Check data lake regions:

   ```bash
   aws securitylake list-data-lakes
   ```

4. Present source summary per region:

   | Region | Source | Status | Account Count |
   |---|---|---|---|
   | us-east-1 | CLOUD_TRAIL_MGMT | ACTIVE | 12 |
   | us-east-1 | VPC_FLOW | ACTIVE | 12 |
   | us-east-1 | ROUTE53 | ACTIVE | 8 |

5. MUST list all regions where Security Lake is enabled.

6. SHOULD note any source with non-ACTIVE status.

7. MAY include custom sources if present.

8. (ONLY if user asks about volume or ingestion size) Query CloudWatch:

   ```bash
   aws cloudwatch get-metric-statistics --namespace AWS/SecurityLake --metric-name ProcessedSize --dimensions Name=Source,Value=<SOURCE_NAME> --start-time <7-days-ago> --end-time <now> --period 86400 --statistics Sum
   ```

   Repeat for each source. Shows total stored bytes per source per day — useful for identifying sources that stopped ingesting.

## Workflow B: Subscriber & Exception Overview

1. List subscribers:

   ```bash
   aws securitylake list-subscribers
   ```

2. For each subscriber:

   ```bash
   aws securitylake get-subscriber --subscriber-id <id>
   ```

3. List exceptions:

   ```bash
   aws securitylake list-data-lake-exceptions
   ```

4. Present subscriber summary:

   | Subscriber | Access Type | Status | Sources Subscribed |
   |---|---|---|---|
   | SIEM-Integration | S3 | ACTIVE | ALL |
   | Analytics-Team | LAKEFORMATION | ACTIVE | VPC_FLOW, CLOUD_TRAIL_MGMT |

5. Present exception summary:

   | Account | Region | Source | Exception |
   |---|---|---|---|
   | 111122223333 | eu-west-1 | VPC_FLOW | INTERNAL_ERROR |

6. MUST report total subscriber count and access type breakdown.

7. MUST report exception count — zero exceptions is healthy.

8. SHOULD note subscribers in non-ACTIVE status.

## Constraints

- MUST NOT perform data queries against Security Lake
- MUST NOT modify configuration, subscribers, or sources
- MUST NOT query CloudWatch metrics by default — only if user explicitly asks about volume
- MUST present data as-is in structured tables
- SHOULD handle AccessDeniedException gracefully

## Troubleshooting

| Symptom | Resolution |
|---|---|
| get-data-lake-sources returns empty | Security Lake not enabled or no sources configured |
| AccessDeniedException | Caller is not Security Lake delegated admin or not enabled |
| UnauthorizedException | Same as above |
| Subscriber DEACTIVATED | Note in summary — may have been disabled |
| High exception count | Summarize by account/region — may indicate rollout issues |

## Output Sensitivity

Source summary reveals data lake regions, per-source ingestion status across accounts, subscriber identities and access configurations, and exception details (account IDs, failure reasons). Present source status table and subscriber overview first. Display full configuration details only when the caller explicitly requests raw output.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall