Skip to content

Commit 7b54f84

Browse files
emmanuelgjrclaude
andcommitted
docs(readme): refresh for current deliverables and visual appeal
The README predated most of what the repo now ships. Rewrite it: - Centered header with tagline, badge row (OWASP, live-webapp, DSGAI-21, frameworks-26, scanner v0.3.0, license, PRs-welcome) and a quick-nav line with explicit anchors. - Prominent call-to-action to the Crosswalk webapp, and a feature table with deep links (Score Your Coverage, Explorer, Coverage Matrix, Incidents, Submit a Standard). - Crosswalk stats corrected: 51 entries across 4 source lists x 26 frameworks, 3,800+ mappings, 131 incidents; framework list replaced with the 26 actually mapped (was a stale 21-framework list naming frameworks the crosswalk does not carry). - New DSGAI Scanner section (previously absent): v0.3.0, 107 rules, languages, SARIF/Semgrep/gitleaks, quick start, sample report. - Datasets table with real per-dataset entry counts; datasets that exist are no longer listed as 'proposed'. - At-a-glance deliverables table, repository map, condensed workstreams; every prior section kept (white papers, DSGAI table, collaboration, contribute, initiatives table, acknowledgments, license). All relative paths verified against the tree; all external URLs return 2xx/3xx with a browser UA except the two known bot-blocks (Slack, LinkedIn), unchanged from before. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KJVKF6raJCNKBWjTkDSqR4
1 parent fdf425c commit 7b54f84

1 file changed

Lines changed: 127 additions & 46 deletions

File tree

‎README.md‎

Lines changed: 127 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,56 @@
1-
# OWASP GenAI Data Security Initiative
1+
<div align="center">
22

3-
Part of the [OWASP GenAI Security Project](https://genai.owasp.org/) · [Data Security Initiative Page](https://genai.owasp.org/initiative/data-security/)
3+
# 🛡️ OWASP GenAI Data Security Initiative
4+
5+
**Community-developed taxonomies, crosswalks, datasets, and tooling for securing data in generative and agentic AI systems.**
6+
7+
Part of the [OWASP GenAI Security Project](https://genai.owasp.org/) · [Initiative Page](https://genai.owasp.org/initiative/data-security/)
8+
9+
[![OWASP](https://img.shields.io/badge/OWASP-GenAI%20Security%20Project-1a4b8c?logo=owasp&logoColor=white)](https://genai.owasp.org/)
10+
[![Crosswalk](https://img.shields.io/badge/Crosswalk-live%20webapp-2ea44f)](https://genai-security-project.github.io/crosswalk/)
11+
[![DSGAI](https://img.shields.io/badge/DSGAI%202026-21%20risks-6d28d9)](https://genai.owasp.org/resource/owasp-genai-data-security-risks-mitigations-2026/)
12+
[![Frameworks](https://img.shields.io/badge/frameworks-26-orange)](https://genai-security-project.github.io/crosswalk/#/frameworks)
13+
[![Scanner](https://img.shields.io/badge/DSGAI%20Scanner-v0.3.0-16a34a)](dsgai_scanner_tool/README.md)
14+
[![License](https://img.shields.io/badge/license-CC%20BY--SA%204.0-lightgrey)](https://creativecommons.org/licenses/by-sa/4.0/legalcode)
15+
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](CONTRIBUTING.md)
16+
17+
[**🌐 Explore the Crosswalk webapp →**](https://genai-security-project.github.io/crosswalk/)
18+
19+
[White Papers](#deliverables) · [Crosswalk](#crosswalk) · [Scanner](#scanner) · [Datasets](#datasets) · [Contribute](#contribute)
20+
21+
</div>
422

523
---
624

725
## Overview
826

9-
The OWASP GenAI Data Security Initiative addresses the data security risks unique to Large Language Models, Generative AI, and Agentic AI systems. As AI introduces new data surfaces — prompts, context windows, embeddings, vector stores, agent traces, tool payloads — and new failure modes — prompt-driven extraction, cross-session bleed, inference attacks, plugin data drains — traditional data security frameworks no longer map cleanly to what needs protection.
27+
The OWASP GenAI Data Security Initiative addresses the data security risks unique to Large Language Models, Generative AI, and Agentic AI systems. AI introduces new data surfaces — prompts, context windows, embeddings, vector stores, agent traces, tool payloads — and new failure modes — prompt-driven extraction, cross-session bleed, inference attacks, plugin data drains — that traditional data security frameworks no longer map cleanly onto.
1028

11-
This initiative produces community-developed, peer-reviewed guidance to help organizations understand and address these emerging challenges. All materials are released under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/legalcode).
29+
This initiative produces community-developed, peer-reviewed guidance, interactive tooling, and open datasets to help organizations understand and address these challenges. All materials are released under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/legalcode).
30+
31+
### At a glance
32+
33+
| Deliverable | What it is | Where |
34+
| --- | --- | --- |
35+
| 📄 **DSGAI Risk Taxonomy 2026** | 21 GenAI data security risks with tiered mitigations | [White paper](https://genai.owasp.org/resource/owasp-genai-data-security-risks-mitigations-2026/) |
36+
| 📄 **Data Security Best Practices** | Companion implementation guide | [White paper](https://genai.owasp.org/resource/llm-and-gen-ai-data-security-best-practices/) |
37+
| 🌐 **Framework Crosswalk** | 51 risk entries × 26 frameworks, 3,800+ control mappings, interactive webapp | [Webapp](https://genai-security-project.github.io/crosswalk/) · [Repo](https://github.com/GenAI-Security-Project/crosswalk) |
38+
| 🛡️ **DSGAI Scanner** | Deterministic compliance scanner for AI codebases (SARIF, CI-ready) | [`dsgai_scanner_tool/`](dsgai_scanner_tool/) |
39+
| 📊 **Community Datasets** | Exploits, vulnerabilities, test cases, incidents, traces | [`datasets/`](datasets/) |
40+
| ✅ **Data Validation** | Schemas and checks for contributed data | [`data_validation/`](data_validation/) |
41+
| 📚 **Literature Review** | Categorized corpus of LLM-security research papers | [`literature/`](literature/) |
1242

1343
---
1444

15-
## Key Deliverables
45+
<a id="deliverables"></a>
46+
47+
## 📄 Key Deliverables
1648

1749
### GenAI Data Security Risks and Mitigations 2026 (v1.0)
1850

1951
📄 [Download PDF](https://genai.owasp.org/resource/owasp-genai-data-security-risks-mitigations-2026/) · Released March 2026
2052

21-
A comprehensive enumeration of 21 data security risks specific to GenAI systems, each with tiered mitigations (Foundational → Hardening → Advanced) designed for organizations at different maturity levels. This is not a Top 10 — it is a structured risk taxonomy following data as it moves through a GenAI system.
53+
A comprehensive enumeration of 21 data security risks specific to GenAI systems, each with tiered mitigations (Foundational → Hardening → Advanced) for organizations at different maturity levels. This is not a Top 10 — it is a structured risk taxonomy following data as it moves through a GenAI system.
2254

2355
Cross-referenced to the [OWASP Top 10 for LLM Applications](https://genai.owasp.org/llm-top-10/) and the [OWASP Top 10 for Agentic Applications 2026](https://genai.owasp.org/initiatives/agentic-security-initiative/).
2456

@@ -61,66 +93,113 @@ The companion implementation guide covering data security principles, secure dep
6193

6294
---
6395

64-
## Framework Crosswalk
96+
<a id="crosswalk"></a>
6597

66-
The initiative maintains a comprehensive crosswalk of GenAI data security risks against 21 widely recognized cybersecurity and AI frameworks. The crosswalk covers all 41 entries across the OWASP LLM Top 10 2025, Agentic Top 10 2026, and DSGAI Risk Taxonomy.
98+
## 🌐 Framework Crosswalk
6799

68-
### 🌐 [Crosswalk →](https://genai-security-project.github.io/crosswalk/)
69-
The web application provides an interactive interface for exploring crosswalk mappings, framework coverage, incident data, security tooling, implementation recipes, and a glossary of key terms.
100+
The initiative's flagship interactive deliverable: **51 risk entries** across four OWASP source lists — LLM Top 10 2026, Agentic Top 10 2026, DSGAI 2026, and Agentic Skills Top 10 — mapped to **26 industry frameworks** through **3,800+ individual control mappings**, with **131 tracked AI security incidents**.
70101

71-
Crosswalk source files are maintained in the dedicated [`GenAI-Security-Project/crosswalk`](https://github.com/GenAI-Security-Project/crosswalk) repository.
102+
> ### [🚀 Open the Crosswalk webapp](https://genai-security-project.github.io/crosswalk/)
103+
>
104+
> | Feature | What it does |
105+
> | --- | --- |
106+
> | [**Score Your Coverage**](https://genai-security-project.github.io/crosswalk/#/score) | Select your frameworks, see your GenAI risk coverage gaps, validate with Garak/PyRIT results |
107+
> | [**Explorer**](https://genai-security-project.github.io/crosswalk/#/explorer) | Search and filter all 51 entries; view mapped controls across every framework |
108+
> | [**Coverage Matrix**](https://genai-security-project.github.io/crosswalk/#/frameworks) | Interactive 51 × 26 matrix — click any cell for the specific controls |
109+
> | [**Incidents**](https://genai-security-project.github.io/crosswalk/#/incidents) | Real-world AI security incidents, filterable by severity, year, and layer |
110+
> | [**Submit a Standard**](https://genai-security-project.github.io/crosswalk/#/submit) | Propose any framework for automated mapping |
72111
73-
### Frameworks Covered
112+
Crosswalk source data, per-framework compliance gap reports (Markdown, CSV, JSON, OSCAL), and enterprise exports (STIX 2.1, OSCAL Component Definition) are maintained in the dedicated [`GenAI-Security-Project/crosswalk`](https://github.com/GenAI-Security-Project/crosswalk) repository.
74113

75-
**Cybersecurity & AI Standards** — NIST CSF 2.0, NIST AI RMF 1.0, ISO/IEC 27001, ISO/IEC 42001, ISO/IEC 23894, ISO/IEC 5338
114+
**Frameworks covered:**
76115

77-
**Threat Modeling & Adversarial** — MITRE ATT&CK, MITRE ATLAS, STRIDE, FAIR
116+
- **AI governance & regulation** — NIST AI RMF 1.0 · ISO/IEC 42001 · EU AI Act · ENISA Multilayer Framework · AIUC-1 · CoSAI *(candidate)* · EU AI Act Code of Practice *(candidate)*
117+
- **Security management & compliance** — ISO/IEC 27001 · NIST CSF 2.0 · SOC 2 · PCI DSS v4.0 · CIS Controls v8.1 · FedRAMP
118+
- **Threat modeling & adversarial** — MITRE ATLAS · MAESTRO (CSA) · STRIDE · CWE/CVE
119+
- **Testing & verification** — OWASP ASVS · OWASP AISVS 1.0 · OWASP AI Testing Guide
120+
- **Secure SDLC, identity & maturity** — NIST SP 800-218A · OWASP SAMM · OWASP NHI Top 10
121+
- **OT/ICS & financial resilience** — ISA/IEC 62443 · NIST SP 800-82 Rev 3 · DORA
78122

79-
**Application Security & Compliance** — CIS Controls, ASVS, SOC 2, PCI DSS, ENISA, CycloneDX ML SBOM
123+
---
80124

81-
**Governance & Architecture** — COBIT, OPENCRE, SAMM, BSIMM
125+
<a id="scanner"></a>
82126

83-
**OT / Industrial AI Security** — ISA/IEC 62443
127+
## 🛡️ DSGAI Scanner
84128

85-
---
129+
**v0.3.0** · [`dsgai_scanner_tool/`](dsgai_scanner_tool/) — audits GenAI and agentic codebases against all 21 DSGAI controls.
86130

87-
## Workstreams
131+
A **deterministic engine** owns the pattern matching — 107 PCRE rules run via ripgrep produce identical findings on identical input, so you get a reproducible compliance artifact rather than an LLM opinion. An optional [Claude Code](https://www.anthropic.com/claude-code) skill orchestrates the run and writes the narrative report.
88132

89-
1. **Data Collection** — Public open call for real-world vulnerability data and incident reports related to LLMs and GenAI applications. Submit data through the Slack channel or by opening an issue in this repository.
133+
- 🎯 **Deterministic & reproducible** — a compliance report you can diff; secrets never leave your machine
134+
- 🌐 **Multi-language** — Python, JavaScript/TypeScript, Java, Kotlin, Go, plus credential coverage for C#, Rust, Ruby
135+
- 🐛 **CVE enrichment without hallucination** — queries OSV (+ NVD for CVSS) per pinned dependency across 6 ecosystems
136+
- 🧰 **Meets your toolchain** — SARIF 2.1.0 for GitHub Code Scanning, a [Semgrep rule-pack export](dsgai_scanner_tool/dist/dsgai.semgrep.yaml), and a [gitleaks pack](dsgai_scanner_tool/integrations/gitleaks/dsgai.toml) for pre-commit
137+
- 💸 **$0 CI path** — the CLI needs only Python 3.10+ and ripgrep; no LLM, no account
90138

91-
2. **Framework Crosswalk** — Crosswalking the [OWASP Top 10 for LLM Applications 2025](https://genai.owasp.org/llm-top-10/) and [Agentic Top 10 2026](https://genai.owasp.org/initiatives/agentic-security-initiative/) to recognized cybersecurity and AI frameworks. See the [Crosswalk](https://genai-security-project.github.io/crosswalk/) and the [`GenAI-Security-Project/crosswalk`](https://github.com/GenAI-Security-Project/crosswalk) repository for current crosswalk data.
139+
```bash
140+
git clone --depth 1 https://github.com/GenAI-Security-Project/GenAI-Data-Security-Initiative
141+
python GenAI-Data-Security-Initiative/dsgai_scanner_tool/cli/dsgai_scan.py scan . \
142+
--sarif DSGAI-scan.sarif --json-out DSGAI-scan.json
143+
```
92144

93-
3. **Data Security Risks & Best Practices** — Research, authoring, and maintenance of the initiative's two published white papers: the DSGAI risk taxonomy and the companion implementation guide. This workstream also maintains alignment with the broader OWASP GenAI Security Project deliverables.
145+
<details>
146+
<summary><strong>Sample report</strong></summary>
147+
148+
![DSGAI Scanner sample report](dsgai_scanner_tool/DSGAI-samplereport.png)
94149

95-
4. **Community Datasets** — Development of open, community-contributed datasets for research, benchmarking, and security testing. See the [`/datasets`](https://github.com/GenAI-Security-Project/GenAI-Data-Security-Initiative/tree/main/datasets) directory for current and proposed datasets.
150+
</details>
96151

97-
5. **Data Validation** — Automated and peer-reviewed validation of all contributed data. Scripts in [`/data_validation`](https://github.com/GenAI-Security-Project/GenAI-Data-Security-Initiative/tree/main/data_validation) ensure integrity and accuracy.
152+
See the [scanner README](dsgai_scanner_tool/README.md) for the full feature set, CI/CD integration, and the Claude Code skill.
98153

99154
---
100155

101-
## Datasets
156+
<a id="datasets"></a>
157+
158+
## 📊 Community Datasets
159+
160+
Open, community-contributed datasets for research, benchmarking, and security testing — every entry mapped to the DSGAI taxonomy and validated before merge. See [`datasets/`](datasets/) and [CONTRIBUTING.md](CONTRIBUTING.md).
161+
162+
| Dataset | Contents | Status |
163+
| --- | --- | --- |
164+
| [Exploit Dataset](datasets/exploit_dataset/) | Documented exploit techniques targeting LLM applications, keyed to MITRE ATLAS | ✅ 59 entries |
165+
| [Vulnerability Dataset](datasets/vulnerability_dataset/) | Real-world CVEs affecting LLM applications | ✅ 47 entries |
166+
| [Risk Assessment Dataset](datasets/riskassessment_dataset/) | Mapped risk assessments for LLM deployments | ✅ 23 entries |
167+
| [Prompt Injection & Data Extraction Test Cases](datasets/promptinj_dataextraction_testcases/) | Adversarial prompts and extraction techniques for red-teaming and regression testing | ✅ 300+ cases |
168+
| [RAG Poisoning & Retrieval Integrity](datasets/rag_dataset/) | Synthetic poisoning fixtures for testing vector store integrity and retrieval filtering | 🌱 growing — contribute |
169+
| [Incident Dataset](datasets/incident_dataset/) | Anonymized real-world GenAI data security incidents | 🙋 seeking contributors |
170+
| [Agent Data Flow & Tool Exchange Traces](datasets/agentdataflow_toolexchange_traces/) | Sanitized traces of agent tool calls and plugin data exchanges (DSGAI06) | 🙋 seeking contributors |
171+
| [Cross-Framework Mapping Dataset](datasets/crossframework_mapping_dataset/) | Machine-readable DSGAI-to-framework control mappings | ↗ maintained in the [crosswalk repo](https://github.com/GenAI-Security-Project/crosswalk) |
172+
173+
Contributions to every dataset are validated by the schemas and checks in [`data_validation/`](data_validation/) — see the [setup guide](data_validation/SETUP.md).
102174

103-
### Current
175+
---
104176

105-
- **Vulnerability Dataset** — Real-world vulnerabilities affecting LLM applications
106-
- **Exploit Dataset** — Documented exploits and attack techniques targeting LLMs
107-
- **Risk Assessment Dataset** — Mapped risk assessments for various LLM deployments
177+
## 🗺️ Repository Map
108178

109-
### Proposed Community Datasets
179+
```text
180+
├── datasets/ ← community datasets (8 tracks, one entry per file)
181+
├── data_validation/ ← JSON schemas + validation pipeline for contributions
182+
├── dsgai_scanner_tool/ ← DSGAI Scanner v0.3.0 (deterministic CLI + Claude Code skill)
183+
├── literature/ ← categorized LLM-security literature corpus
184+
├── CONTRIBUTING.md ← contribution paths by role and workstream
185+
└── SECURITY.md ← vulnerability reporting policy
186+
```
110187

111-
We are looking for contributors to help build datasets for the broader AI security community. Priority areas include:
188+
---
112189

113-
- **GenAI Data Security Incident Database** — Structured, anonymized catalog of real-world data security incidents in GenAI deployments (leakage events, cross-tenant bleed, RAG exfiltration, agent credential exposure), focused on failure modes enumerated in DSGAI01–DSGAI21.
114-
- **Prompt Injection & Data Extraction Test Cases** — Adversarial prompts and extraction techniques mapped to the DSGAI risk taxonomy for red-teaming and regression testing.
115-
- **RAG Poisoning & Retrieval Integrity Dataset** — Benign and adversarial document sets for testing vector store integrity, retrieval-time redaction, and poisoning detection.
116-
- **Cross-Framework Control Crosswalk Dataset** — Machine-readable crosswalk of DSGAI risks to controls across NIST CSF 2.0, NIST AI RMF, MITRE ATLAS, ISO/IEC 42001, and OWASP LLM Top 10 for automated compliance gap analysis.
117-
- **Agent Data Flow & Tool Exchange Traces** — Sanitized traces of agentic AI tool calls, plugin data exchanges, and delegation chains supporting research into DSGAI06 and related agent security patterns.
190+
## 🧭 Workstreams
118191

119-
If you are interested in contributing, join the Slack channel or reach out directly.
192+
| # | Workstream | Focus |
193+
| --- | --- | --- |
194+
| 1 | **Data Collection** | Open call for real-world vulnerability data and incident reports — submit via [Slack](https://owasp.slack.com) or a GitHub issue |
195+
| 2 | **Framework Crosswalk** | Mapping OWASP GenAI risk lists to industry frameworks — see the [webapp](https://genai-security-project.github.io/crosswalk/) and [crosswalk repo](https://github.com/GenAI-Security-Project/crosswalk) |
196+
| 3 | **Risks & Best Practices** | Research, authoring, and maintenance of the initiative's white papers |
197+
| 4 | **Community Datasets** | Building the open datasets above — schemas, curation, review |
198+
| 5 | **Data Validation** | Automated and peer-reviewed validation of all contributed data |
120199

121200
---
122201

123-
## AI Risk Database Collaboration
202+
## 🤝 AI Risk Database Collaboration
124203

125204
The initiative collaborates with leading AI risk authorities to consolidate efforts and avoid fragmented approaches to risk identification:
126205

@@ -132,18 +211,20 @@ Community members are encouraged to report new GenAI data security risks to thes
132211

133212
---
134213

135-
## How to Contribute
214+
<a id="contribute"></a>
136215

137-
- **Slack:** Join `#team-genai-data-security-initiative` on the [OWASP Slack workspace](https://owasp.slack.com) · [New to OWASP Slack? Join here](https://owasp.org/slack/invite)
138-
- **GitHub:** Submit issues or pull requests to this repository — see [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines
139-
- **Security:** Report vulnerabilities via [GitHub Private Vulnerability Reporting](https://github.com/GenAI-Security-Project/GenAI-Data-Security-Initiative/security/advisories/new) — see [SECURITY.md](SECURITY.md)
140-
- **Contact:** Reach out to Emmanuel Guilherme Junior (Initiative Lead) via [Slack](https://owasp.slack.com) or [LinkedIn](https://www.linkedin.com/in/emmanuelgjr/)
216+
## 🙌 How to Contribute
141217

142218
All contributions are welcome — from security practitioners, AI engineers, researchers, compliance professionals, and anyone working to secure GenAI systems.
143219

220+
- 💬 **Slack:** Join `#team-genai-data-security-initiative` on the [OWASP Slack workspace](https://owasp.slack.com) · [New to OWASP Slack? Join here](https://owasp.org/slack/invite)
221+
- 🧑‍💻 **GitHub:** Submit issues or pull requests — [CONTRIBUTING.md](CONTRIBUTING.md) has starting points for every role and experience level
222+
- 🔒 **Security:** Report vulnerabilities via [GitHub Private Vulnerability Reporting](https://github.com/GenAI-Security-Project/GenAI-Data-Security-Initiative/security/advisories/new) — see [SECURITY.md](SECURITY.md) · researchers are credited in [SECURITY-THANKS.md](SECURITY-THANKS.md)
223+
- ✉️ **Contact:** Reach out to Emmanuel Guilherme Junior (Initiative Lead) via [Slack](https://owasp.slack.com) or [LinkedIn](https://www.linkedin.com/in/emmanuelgjr/)
224+
144225
---
145226

146-
## OWASP GenAI Security Project — Initiatives
227+
## 🧩 OWASP GenAI Security Project — Initiatives
147228

148229
This initiative is one of several under the [OWASP GenAI Security Project](https://genai.owasp.org/):
149230

@@ -160,15 +241,15 @@ This initiative is one of several under the [OWASP GenAI Security Project](https
160241

161242
---
162243

163-
## Acknowledgments
244+
## 🙏 Acknowledgments
164245

165246
**Initiative Lead:** [Emmanuel Guilherme Junior](https://www.linkedin.com/in/emmanuelgjr/)
166247

167248
This initiative is made possible by the contributions of its authors, contributors, and reviewers from across the global AI security community. Thank you to everyone who has helped build and shape this community resource. Full contributor lists are included in each published document.
168249

169250
---
170251

171-
## License
252+
## 📜 License
172253

173254
All materials produced by this initiative are licensed under [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/legalcode).
174255

0 commit comments

Comments
 (0)