Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
19 changes: 16 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,23 @@ Amazon Web Services (AWS) is offering _experimental_ Open Security Controls Asse

## Available Content

This repository contains OSCAL component-definition files in JSON format describing AWS regions and services. See the [AWS Component Definitions](docs/COMPONENTS.md) document for details.
This repository contains OSCAL content in JSON format conforming to OSCAL version 1.2.1. The content is organized into the following directories:

Additional detail about each service will be added to these files. Please [open an issue](/issues/new) to let us know what content is most beneficial to you.
### Catalogs

The [`catalogs/`](catalogs/) directory contains OSCAL catalog files. Currently this includes the AWS Security Hub Controls catalog with 77 groups and 452 controls. See the [Catalogs README](catalogs/README.md) for details.

### Component Definitions

The [`component-definitions/`](component-definitions/) directory contains 230 OSCAL component definition files describing AWS regions and services. Each AWS service is modeled as a _component_ within a file. Service components with Security Hub controls include references to the [catalog](catalogs/aws_security-hub.oscal.json) and associated Config rules.

See the [Component Definitions README](component-definitions/README.md) for a full inventory, or the [AWS Component Definitions](docs/COMPONENTS.md) document for details on the OSCAL representation.

### Tools

See the [Tools](docs/TOOLS.md) document for information on converting OSCAL content between formats.

## Additional Resources

You may also want to try the [OSCAL MCP Server](https://github.com/awslabs/mcp-server-for-oscal/), which can help you understand the content in this project, how to use it, and OSCAL in general.

Expand All @@ -22,4 +36,3 @@ See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more inform
## License

This project is licensed under the [Apache-2.0 License](LICENSE).

13 changes: 13 additions & 0 deletions catalogs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Catalogs

OSCAL model type: `catalog`

This directory contains 1 OSCAL Catalog files in JSON format.

## Summary

| File | Title | Groups | Controls | Version | OSCAL Version | Last Modified |
|---|---|---|---|---|---|---|
| [aws_security-hub.oscal.json](aws_security-hub.oscal.json) | AWS Security Hub Controls | 77 | 452 | 0.2.0 | 1.2.1 | 2026-03-31 |

Generated on 2026-04-01.
Loading