|
1 | 1 | # GitGuardian's ggshield VSCode extension
|
2 | 2 |
|
3 |
| -## Table of contents |
| 3 | +## Table of content |
4 | 4 |
|
5 | 5 | - [GitGuardian's ggshield VSCode extension](#gitguardians-ggshield-vscode-extension)
|
6 | 6 | - [Table of contents](#table-of-contents)
|
|
20 | 20 |
|
21 | 21 | ## Description
|
22 | 22 |
|
23 |
| -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. |
| 23 | +This extension helps you detect more than 400+ types of secrets directly from VSCode using [ggshield](https://www.gitguardian.com/ggshield)) CLI application. |
24 | 24 |
|
25 | 25 | NB: The extension uses the quota of secret detection of your ggshield API token.
|
26 | 26 |
|
27 | 27 | ### Features
|
28 | 28 |
|
29 |
| -- When a file is opened or saved, it is scanned using the ggshield CLI application |
| 29 | +- When a file is saved, it is scanned using the ggshield CLI application |
30 | 30 | - Found incidents are highlighted in code and available in the `Problems` panel as warnings
|
31 |
| -- Secrets can be ignored running the command `ggshield: Ignore last found incidents` |
| 31 | +- Secrets can be ignored running the command `ggshield: Ignore last found incidents` or via the UI |
32 | 32 | - The API quota can be checked running the command `ggshield: Show quota`
|
33 | 33 |
|
34 |
| - |
| 34 | + |
35 | 35 |
|
36 | 36 | ## Getting started
|
37 | 37 |
|
38 |
| -### Requirements |
39 |
| - |
40 |
| -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. |
41 |
| - |
42 |
| -The current minimum version is *1.15.0*. |
43 |
| - |
44 |
| -### Installation |
45 |
| - |
46 |
| -To test the plugin, open this project with VSCode and press F5, a window called "Development Host" will open with the extension loaded. |
47 |
| -You then need to set up the extension settings. |
48 |
| - |
49 |
| -Once released it will installed directly from the VS Code Marketplace. |
50 |
| - |
51 |
| -### Configuration |
52 |
| - |
53 |
| -- `ggshield.ggshieldPath`: Path to ggshield executable (use `$ where ggshield` to find out) |
54 |
| -- `ggshield.apiKey`: GitGuardian Internal Monitoring API key |
55 |
| -- `ggshield.apiUrl`: GitGuardian Internal Monitoring URL (default: <https://api.gitguardian.com/>) |
56 |
| - |
57 |
| - |
58 |
| - |
59 | 38 | ### Scan for secrets
|
60 | 39 |
|
61 |
| -The scanning is triggered automatically when opening or saving a file. Incidents are highlighted in file and available in the `Problems` panel as warnings. |
| 40 | +The scanning is triggered automatically when saving a file. Incidents are highlighted in file and available in the `Problems` panel as warnings. |
62 | 41 |
|
63 | 42 | ### How to remediate incidents?
|
64 | 43 |
|
|
0 commit comments