mirror of https://github.com/docker/docs.git
Add first draft of trust chain documentation (#3680)
* Add first draft of trust chain documentation * Adding Trust Chain to TOC * Updates per review feedback * Fixes
This commit is contained in:
parent
bbe8c7c447
commit
9ea1ad5484
|
@ -2509,6 +2509,8 @@ manuals:
|
||||||
title: Docker Store overview
|
title: Docker Store overview
|
||||||
- path: /docker-store/publish/
|
- path: /docker-store/publish/
|
||||||
title: Submit a product to Docker Store
|
title: Submit a product to Docker Store
|
||||||
|
- title: Docker Store Trust Chain
|
||||||
|
path: /docker-store/trustchain/
|
||||||
- path: /docker-store/faq/
|
- path: /docker-store/faq/
|
||||||
title: Docker Store FAQs
|
title: Docker Store FAQs
|
||||||
- sectiontitle: Release notes
|
- sectiontitle: Release notes
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 93 KiB |
|
@ -0,0 +1,59 @@
|
||||||
|
---
|
||||||
|
title: Docker Store Trust Chain
|
||||||
|
keywords: trust, chain, store
|
||||||
|
---
|
||||||
|
|
||||||
|
## For consumers
|
||||||
|
|
||||||
|
Docker ensures that all content is securely received and verified from original
|
||||||
|
producers, and additionally audits images before adding them to the Docker
|
||||||
|
Store. Docker cryptographically signs the images upon completion of a
|
||||||
|
satisfactory image check, so that you can verify and trust certified content
|
||||||
|
from the Docker Store.
|
||||||
|
|
||||||
|
Here’s the full trust chain in detail, with details on how to cryptographically
|
||||||
|
verify completion of the process when pulling an image from Docker Store:
|
||||||
|
|
||||||
|
1. Producers sign and push their images using Docker Content Trust to a private staging area.
|
||||||
|
|
||||||
|
2. Docker pulls the image, verifies the signatures to guarantee authenticity, integrity, and freshness of the image.
|
||||||
|
|
||||||
|
3. The Docker Store certification team performs a thorough review of the image, looking for vulnerabilities and verifying best practices for image hygiene, such as ensuring minimal image sizes and working health-checks.
|
||||||
|
|
||||||
|
4. Upon a successful review, Docker signs the image and makes it officially available on Docker Store. As a consumer, you can confirm that Docker signed the image by pulling and running with Docker Content Trust:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
DOCKER_CONTENT_TRUST=1 docker pull <image>
|
||||||
|
|
||||||
|
DOCKER_CONTENT_TRUST=1 docker run <image>
|
||||||
|
```
|
||||||
|
|
||||||
|
## For producers
|
||||||
|
|
||||||
|
The Docker Store has a thorough and well-defined certification process to ensure
|
||||||
|
top-quality content from producers is delivered to consumers in a trusted
|
||||||
|
manner. As a producer of content, you will be required to sign your images so
|
||||||
|
that Docker can verify that your content is not tampered with upon starting the
|
||||||
|
image certification and publishing process as outlined below:
|
||||||
|
|
||||||
|
1. Producers sign and push their images using Docker Content Trust to a private staging area. To do this, run a `docker push` command with Content Trust enabled:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
DOCKER_CONTENT_TRUST=1 docker pull <image>
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Docker verifies the signatures to guarantee authenticity, integrity, and freshness of the image. All of the individual layers of your image, and the combination thereof, are encompassed as part of this verification check. [Read more detail about Content Trust in Docker's documentation](/engine/security/trust/content_trust/#understand-trust-in-docker).
|
||||||
|
|
||||||
|
3. Upon a successful signature verification, Docker pulls the original image to a private, internal staging area only accessible to the Docker Store certification team
|
||||||
|
|
||||||
|
4. The Docker Store certification team performs a thorough review of the image, looking for vulnerabilities and verifying best practices for image hygiene, such as ensuring minimal image sizes and working health-checks.
|
||||||
|
|
||||||
|
5. Upon a successful review, Docker signs the image and makes it officially available on Docker Store. Similar to artifacts on the Apple Store, this is the final and only signature on the image. Your consumers that the full certification process was completed by checking Docker’s signature by pulling and running with Docker Content Trust:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
DOCKER_CONTENT_TRUST=1 docker pull <image>
|
||||||
|
|
||||||
|
DOCKER_CONTENT_TRUST=1 docker run <image>
|
||||||
|
```
|
||||||
|
|
||||||
|

|
Loading…
Reference in New Issue