1
1
# Socket Security CLI
2
2
3
- The Socket Security CLI was created to enable integrations with other tools like Github Actions, Gitlab, BitBucket, local use cases and more. The tool will get the head scan for the provided repo from Socket, create a new one, and then report any new alerts detected. If there are new alerts against the Socket security policy it'll exit with a non-Zero exit code.
3
+ The Socket Security CLI was created to enable integrations with other tools like GitHub Actions, Gitlab, BitBucket, local use cases and more. The tool will get the head scan for the provided repo from Socket, create a new one, and then report any new alerts detected. If there are new alerts against the Socket security policy it'll exit with a non-Zero exit code.
4
4
5
5
## Usage
6
6
@@ -18,62 +18,63 @@ If you don't want to provide the Socket API Token every time then you can use th
18
18
### Parameters
19
19
20
20
#### Authentication
21
- | Parameter | Required | Default | Description |
22
- |:------------- |:---------|:--------|:------ --------------------------------------------------------------------------------|
23
- | --api-token | False | | Socket Security API token (can also be set via SOCKET_SECURITY_API_KEY env var) |
21
+ | Parameter | Required | Default | Description |
22
+ |:------------|:---------|:--------|:--------------------------------------------------------------------------------|
23
+ | --api-token | False | | Socket Security API token (can also be set via SOCKET_SECURITY_API_KEY env var) |
24
24
25
25
#### Repository
26
- | Parameter | Required | Default | Description |
27
- |:-------------|:---------|:--------|:- ------------------------------------------------------------------------|
28
- | --repo | False | | Repository name in owner/repo format |
29
- | --integration| False | api | Integration type (api, github, gitlab) |
30
- | --owner | False | | Name of the integration owner, defaults to the socket organization slug |
31
- | --branch | False | "" | Branch name |
32
- | --committers | False | | Committer(s) to filter by |
26
+ | Parameter | Required | Default | Description |
27
+ |:-------------- |:---------|:--------|:------------------------------------------------------------------------|
28
+ | --repo | False | | Repository name in owner/repo format |
29
+ | --integration | False | api | Integration type (api, github, gitlab) |
30
+ | --owner | False | | Name of the integration owner, defaults to the socket organization slug |
31
+ | --branch | False | "" | Branch name |
32
+ | --committers | False | | Committer(s) to filter by |
33
33
34
34
#### Pull Request and Commit
35
- | Parameter | Required | Default | Description |
36
- |:----------------|:---------|:--------|:-------------------|
37
- | --pr-number | False | "0" | Pull request number|
38
- | --commit-message| False | | Commit message |
39
- | --commit-sha | False | "" | Commit SHA |
35
+ | Parameter | Required | Default | Description |
36
+ |:----------------- |:---------|:--------|:- -------------------|
37
+ | --pr-number | False | "0" | Pull request number |
38
+ | --commit-message | False | | Commit message |
39
+ | --commit-sha | False | "" | Commit SHA |
40
40
41
41
#### Path and File
42
- | Parameter | Required | Default | Description |
43
- |:-------------|:---------|:--------|:------ -------------------------------------|
44
- | --target-path| False | ./ | Target path for analysis |
45
- | --sbom-file | False | | SBOM file path |
46
- | --files | False | [] | Files to analyze (JSON array string) |
42
+ | Parameter | Required | Default | Description |
43
+ |:-------------- |:---------|:--------|:-------------------------------------|
44
+ | --target-path | False | ./ | Target path for analysis |
45
+ | --sbom-file | False | | SBOM file path |
46
+ | --files | False | [] | Files to analyze (JSON array string) |
47
47
48
48
#### Branch and Scan Configuration
49
- | Parameter | Required | Default | Description |
50
- |:---------------|:---------|:--------|:----------------------------------------------------------|
51
- | --default-branch| False | False | Make this branch the default branch |
52
- | --pending-head | False | False | If true, the new scan will be set as the branch' s head scan|
49
+ | Parameter | Required | Default | Description |
50
+ |:----------------- |:---------|:--------|:-- ----------------------------------------------------------|
51
+ | --default-branch | False | False | Make this branch the default branch |
52
+ | --pending-head | False | False | If true, the new scan will be set as the branch' s head scan |
53
53
54
54
# ### Output Configuration
55
- | Parameter | Required | Default | Description |
56
- | :----------------------| :---------| :--------| :---------------------------------------------------------------|
57
- | --generate-license | False | False | Generate license information |
58
- | --enable-debug | False | False | Enable debug logging |
59
- | --enable-json | False | False | Output in JSON format |
60
- | --enable-sarif | False | False | Enable SARIF output of results instead of table or JSON format|
61
- | --disable-overview | False | False | Disable overview output |
55
+ | Parameter | Required | Default | Description |
56
+ | :-------------------------- | :---------| :--------| :------------------- ---------------------------------------------------------------|
57
+ | --generate-license | False | False | Generate license information |
58
+ | --enable-debug | False | False | Enable debug logging |
59
+ | --enable-json | False | False | Output in JSON format |
60
+ | --enable-sarif | False | False | Enable SARIF output of results instead of table or JSON format |
61
+ | --disable-overview | False | False | Disable overview output |
62
62
| --exclude-license-details | False | False | Exclude license details from the diff report (boosts performance for large repos) |
63
63
64
64
# ### Security Configuration
65
- | Parameter | Required | Default | Description |
66
- | :-----------------------| :---------| :--------| :- ------------------------------|
67
- | --allow-unverified | False | False | Allow unverified packages |
68
- | --disable-security-issue| False | False | Disable security issue checks |
65
+ | Parameter | Required | Default | Description |
66
+ | :------------------------- | :---------| :--------| :------------------------------|
67
+ | --allow-unverified | False | False | Allow unverified packages |
68
+ | --disable-security-issue | False | False | Disable security issue checks |
69
69
70
70
# ### Advanced Configuration
71
- | Parameter | Required | Default | Description |
72
- | :-------------------| :---------| :--------| :-----------------------------------------------|
73
- | --ignore-commit-files| False | False | Ignore commit files |
74
- | --disable-blocking | False | False | Disable blocking mode |
75
- | --scm | False | api | Source control management type |
76
- | --timeout | False | | Timeout in seconds for API requests |
71
+ | Parameter | Required | Default | Description |
72
+ | :-------------------------| :---------| :--------| :----------------------------------------------------------------------|
73
+ | --ignore-commit-files | False | False | Ignore commit files |
74
+ | --disable-blocking | False | False | Disable blocking mode |
75
+ | --scm | False | api | Source control management type |
76
+ | --timeout | False | | Timeout in seconds for API requests |
77
+ | --include-module-folders | False | False | If enabled will include manifest files from folders like node_modules |
77
78
78
79
# # File Selection Behavior
79
80
0 commit comments