Vulnerability Static Analysis for Containers
9df4f5bd70
- Debian/RHEL/Oracle vulnsrc now use httputil to download files - httputil sets the User-Agent to the requests as Clair/<version> (https://github.com/coreos/clair/) - httputil holds Status2xx() which returns if the response is a http success (2xx) - GetClientAddr moved from api/httputil to pkg/httputil - the version packge holds a Version string which is set at build time from the git tag and sha - the .git directory was removed from .dockerignore so that we can use the git tag to set the version |
||
|---|---|---|
| .github | ||
| api | ||
| cmd/clair | ||
| contrib | ||
| database | ||
| Documentation | ||
| ext | ||
| pkg | ||
| testdata/DistUpgrade | ||
| vendor | ||
| .dockerignore | ||
| .travis.yml | ||
| bill-of-materials.json | ||
| code-of-conduct.md | ||
| config.yaml.sample | ||
| DCO | ||
| Dockerfile | ||
| glide.lock | ||
| glide.yaml | ||
| LICENSE | ||
| NOTICE | ||
| notifier.go | ||
| README.md | ||
| ROADMAP.md | ||
| updater_test.go | ||
| updater.go | ||
| worker_test.go | ||
| worker.go | ||
Clair
Note: The master branch may be in an unstable or even broken state during development.
Please use releases instead of the master branch in order to get stable binaries.
Clair is an open source project for the static analysis of vulnerabilities in application containers (currently including appc and docker).
- In regular intervals, Clair ingests vulnerability metadata from a configured set of sources and stores it in the database.
- Clients use the Clair API to index their container images; this creates a list of features present in the image and stores them in the database.
- Clients use the Clair API to query the database for vulnerabilities of a particular image; correlating vulnerabilities and features is done for each request, avoiding the need to rescan images.
- When updates to vulnerability metadata occur, a notification can be sent to alert systems that a change has occured.
Our goal is to enable a more transparent view of the security of container-based infrastructure.
Thus, the project was named Clair after the French term which translates to clear, bright, transparent.
Getting Started
- Learn the terminology and about the drivers and data sources that power Clair
- Watch presentations on the high-level goals and design of Clair
- Follow instructions to get Clair up and running
- Explore the API on SwaggerHub
- Discover third party integrations that help integrate Clair with your infrastructure
- Read the rest of the documentation on the CoreOS website or in the Documentation directory
Contact
Contributing
See CONTRIBUTING for details on submitting patches and the contribution workflow.
License
Clair is under the Apache 2.0 license. See the LICENSE file for details.