Skip to content

Commit 0b4db48

Browse files
authored
Add redact documentation (#582)
* Add redact documentation * PR feedback
1 parent b18bb46 commit 0b4db48

File tree

3 files changed

+28
-1
lines changed

3 files changed

+28
-1
lines changed

README.md

+14
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,20 @@ This sample command provides the minimum mandatory arguments required to validat
115115

116116
Currently only SPDX2.2 is supported.
117117

118+
### SBOM Redact
119+
120+
Use the tool to redact any references to files from a given SBOM or set of SBOMs with either of the following commands:
121+
122+
```
123+
sbom-tool redact -sd <directory containing SBOMs to redact> -o <output path>
124+
```
125+
126+
```
127+
sbom-tool redact -sp <path to the SBOM to redact> -o <output path>
128+
```
129+
130+
This command will generate a mirrored set of SBOMs in the output directory, but with the file references removed. Note that the SBOM directory and output path arguments can not reference the same directory and the output path should point to an existing, empty directory.
131+
118132
## Integrating SBOM tool to your CI/CD pipelines.
119133

120134
You can follow these guides to integrate the SBOM tool into your CI/CD pipelines

docs/sbom-tool-arguments.md

+14
Original file line numberDiff line numberDiff line change
@@ -81,5 +81,19 @@ Actions
8181
FollowSymlinks (-F) If set to false, we will not follow symlinks while traversing the build drop folder. Default is set to 'true'.
8282
ManifestInfo (-mi) A list of the name and version of the manifest format that we are using.
8383
84+
Redact -options - Redact file information from given SBOM(s).
85+
86+
Option Description
87+
SbomPath (-sp) The file path of the SBOM to redact.
88+
SbomDir (-sd) The directory containing the sbom(s) to redact.
89+
OutputPath (-o) Gets or sets the directory where the redacted SBOM file(s) will be generated.
90+
Verbosity (-V) Display this amount of detail in the logging output.
91+
Verbose
92+
Debug
93+
Information
94+
Warning
95+
Error
96+
Fatal
97+
8498
Version - Displays the version of the tool being used. Can be used as '--version'
8599
```

src/Microsoft.Sbom.Api/Config/SbomToolCmdRunner.cs

-1
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,6 @@ public GenerationArgs Generate(GenerationArgs generationArgs)
7373
/// </summary>
7474
[ArgActionMethod]
7575
[ArgDescription("Redact file information from given SBOM(s).")]
76-
[OmitFromUsageDocs]
7776
public RedactArgs Redact(RedactArgs redactArgs)
7877
{
7978
return redactArgs;

0 commit comments

Comments
 (0)