oswalpalash / gsd-tools

Global Security Database Tools

GSD Tools

This repository (repo) is a part of the Global Security Database (GSD), an open source project by the Cloud Security Alliance (CSA) to address gaps within the current vulnerability identifier space.

If you are unfamiliar with the GSD and the vulnerability identifier space, please read the following document: TODO: Create a tl;dr of what GSD & vuln ids are within gsd-project

If you're looking to contribute or file a bug, please see the following guide: TODO: Extract the repo descriptions & issue guide to a doc within gsd-project

The gsd-tools repo contains any tools, parsers, applications, and other code related to the GSD. The data for the identifiers themselves live within the gsd-database repo, and any non-data, non-code related documentation (such as meeting times and policies) live within the gsd-project repo.

Licensing

Please note that the data for GSD is CC0, everything else is Apache v2.0. See the LICENSE.md file for each project for more details.

Tools

Each project has its own README and supporting documents. Included below is a short one line description of each project and a quick link to its more detailed README.

Table of Contents

• GSD Analysis
• GSD API
• GSD Bot
• GSD GitHub Actions
• GSD Requests
• GSD Schema
• GSD URL Processing
• GSD Web
• Local Scripts

GSD Analysis

• Website: N/A
• Location: gsd-tools/gsd-analysis/
• README: GSD Analysis README
• Short Description: A review of the GSD data using a python parser.
• Depends on: None

GSD API

• Website: https://api.gsd.id
• Location: gsd-tools/gsd-api/
• README: GSD API README
• Short Description: Provides a simple REST API for interfacing with the GSD Database.
• Depends on: GSD Database

GSD Bot

• Website: N/A
• Location: gsd-tools/gsd-bot/
• README: GSD Bot README
• Short Description: Provides automation around specifically formatted issues within the gsd-database repo.
• Depends on: None

GSD GitHub Actions

• Website: N/A
• Location: gsd-tools/gsd-github-actions/
• README: GSD GitHub Actions README
• Short Description: The GitHub actions used by GSD Database to validate new and existing identifiers.
• Depends on: None

GSD Requests

• Website: https://requests.globalsecuritydatabase.org
• Location: gsd-tools/gsd-requests/
• README: Requests Webform README
• Short Description: A utilitarian webform for submitting new GSD IDs.
• Depends on: GSD Database

GSD Schema

• Website: N/A
• Location: gsd-tools/gsd-schema/
• README: GSD Schema README
• Short Description: Provides the json schema of a GSD identifier.
• Depends on: None

GSD URL Processing

• Website: N/A
• Location: gsd-tools/gsd-url-processing/
• README: GSD URL Processing README
• Short Description: Various scripts written by @kurtseifried to process urls into GSD ids.
• Depends on: None

GSD Web

• Website: https://gsd.id/home
• Location: gsd-tools/gsd-web
• README: GSD Web README
• Short Description: A human interface for interacting with and updating the GSD data.
• Depends on: GSD API, GSD Schema

Local Scripts

• Website: N/A
• Location: gsd-tools/local-scripts/
• README: Local Scripts README
• Short Description: TODO - Ask @kurtseifried
• Depends on: None