Skip to content

Commit

Permalink
refactor: Update package.json and README.md (#26)
Browse files Browse the repository at this point in the history
  • Loading branch information
mathieubellon committed Sep 26, 2024
1 parent bcdb1af commit 3e0eece
Show file tree
Hide file tree
Showing 5 changed files with 10 additions and 31 deletions.
33 changes: 6 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# GitGuardian's ggshield VSCode extension

## Table of contents
## Table of content

- [GitGuardian's ggshield VSCode extension](#gitguardians-ggshield-vscode-extension)
- [Table of contents](#table-of-contents)
Expand All @@ -20,45 +20,24 @@

## Description

This extension helps you detect more than 350+ types of secrets, as well as other potential security vulnerabilities or policy breaks affecting your codebase, directly from VSCode using [ggshield](https://www.gitguardian.com/ggshield)) CLI application.
This extension helps you detect more than 400+ types of secrets directly from VSCode using [ggshield](https://www.gitguardian.com/ggshield)) CLI application.

NB: The extension uses the quota of secret detection of your ggshield API token.

### Features

- When a file is opened or saved, it is scanned using the ggshield CLI application
- When a file is saved, it is scanned using the ggshield CLI application
- Found incidents are highlighted in code and available in the `Problems` panel as warnings
- Secrets can be ignored running the command `ggshield: Ignore last found incidents`
- Secrets can be ignored running the command `ggshield: Ignore last found incidents` or via the UI
- The API quota can be checked running the command `ggshield: Show quota`

![Incident highlighted](./doc/incident_highlighted.png)
![Incident highlighted](./doc/incident_highlighted_dark.png)

## Getting started

### Requirements

The extension requires `ggshield` to be installed. See [documentation](https://docs.gitguardian.com/ggshield-docs/getting-started) for more details on how to install and use it.

The current minimum version is *1.15.0*.

### Installation

To test the plugin, open this project with VSCode and press F5, a window called "Development Host" will open with the extension loaded.
You then need to set up the extension settings.

Once released it will installed directly from the VS Code Marketplace.

### Configuration

- `ggshield.ggshieldPath`: Path to ggshield executable (use `$ where ggshield` to find out)
- `ggshield.apiKey`: GitGuardian Internal Monitoring API key
- `ggshield.apiUrl`: GitGuardian Internal Monitoring URL (default: <https://api.gitguardian.com/>)

![Settings](./doc/settings.png)

### Scan for secrets

The scanning is triggered automatically when opening or saving a file. Incidents are highlighted in file and available in the `Problems` panel as warnings.
The scanning is triggered automatically when saving a file. Incidents are highlighted in file and available in the `Problems` panel as warnings.

### How to remediate incidents?

Expand Down
Binary file removed doc/incident_highlighted.jpg
Binary file not shown.
Binary file modified doc/incident_highlighted.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/incident_highlighted_dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 4 additions & 4 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"name": "gitguardian",
"repository": "https://gitlab.gitguardian.ovh/gg-code/ggshield-vscode-extension.git",
"repository": "https://github.com/GitGuardian/gitguardian-vscode",
"displayName": "GitGuardian",
"description": "GitGuardian's integration",
"description": "Visual Studio Code extension designed to help developers safeguard their sensitive information from accidental leaks in their code",
"icon": "images/icon.png",
"version": "0.0.1",
"version": "0.1.0",
"publisher": "GitGuardian",
"engines": {
"vscode": "^1.81.0"
Expand Down Expand Up @@ -147,4 +147,4 @@
"dependencies": {
"axios": "^1.7.7"
}
}
}

0 comments on commit 3e0eece

Please sign in to comment.