Images Vulnerabilities
The tool creates a list of vulnerabilities per image in format CSV.
Supported Operating Systems
- Linux (Bash): CentOS, Debian, Ubuntu, RedHat
- Windows (PowerShell): 10, 2012, 2016
Prerequisites
- Python 3.9+
- Mend user with admin permissions
Installation
pip install mend-images-vuln
Note: Depending on whether the package was installed as a root user or not, you need to make sure the package installation location was added to the
$PATHenvironment variable.
Usage
Using command-line arguments only:
images_vuln --user-key $WS_USERKEY --api-key $WS_APIKEY --url $WS_WSS_URL --email $WS_EMAIL --dir $OUTPUT_DIRECTORY
Using environment variables:
export WS_USERKEY=xxxxxxxxxxx
export WS_APIKEY=xxxxxxxxxxx
export WS_WSS_URL=https://saas.mend.io
export WS_EMAIL=email@organization.com
images_vuln --dir <Output folder>
Note: Either form is accepted. For the rest of the examples, the latter form would be used
Configuration Parameters
Note: Parameters can be specified as either command-line arguments, environment variables, or a combination of both.
Command-line arguments take precedence over environment variables.
| CLI argument | Env. Variable | Type | Required | Description |
|---|---|---|---|---|
| ‑‑help | switch |
No | Show help and exit | |
| ‑‑version | switch |
No | Show current version and exit | |
| ‑‑user-key | WS_USERKEY |
string |
Yes | Mend User Key |
WS_EMAIL |
string |
Yes | Mend User Email | |
| ‑‑api-key | WS_APIKEY |
string |
Yes | Mend API Key |
| ‑‑url | WS_WSS_URL |
string |
Yes | Mend Server URL |
| ‑‑dir | string |
No | Output directory for the CSV files (default: $PWD) |
|
| ‑‑separate | boolean |
No | If set to True, then a CSV file will be created for each repo. If set to False, then one consolidated CSV file will be made.(default: True) |
|
| ‑‑proxy | HTTP_PROXY |
string |
No | Proxy host including port, with or without protocol prefix and optionally credentials. Expected formats:myproxy.host.com:1234,http://myproxy.host.com:1234,http://user:pass@myproxy.host.com:1234 |
| ‑‑proxyUsername | HTTP_PROXY_USERNAME |
string |
No | Proxy username, if needed and if not included in the proxy host. |
| ‑‑proxyPassword | HTTP_PROXY_PASSWORD |
string |
No | Proxy password, if needed and if not included in the proxy host. |
Metadata
Release files for mend-images-vuln 2023.9.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mend_images_vuln-2023.9.1-py3-none-any.whl | Python 3 | none | any | Details for mend_images_vuln-2023.9.1-py3-none-any.whl |
Release files / mend_images_vuln-2023.9.1-py3-none-any.whl
| Download URL | mend_images_vuln-2023.9.1-py3-none-any.whl |
|---|---|
| Size | 12.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ca2ccd6e759307b5ad0b18e85692368a587a76f5790ce01c28df78b5f9c10262
|
|
BLAKE2b-256 checksum How to use checksums |
2bb84e1fb902d9b7f54b2348409947d67905b64bc4bd8754925a9daf24e38b4d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.5
|
Security for mend-images-vuln 2023.9.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.