Skip to content

scout: create exceptions in docker desktop #20797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 24, 2024
Merged

scout: create exceptions in docker desktop #20797

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 20 additions & 7 deletions content/manuals/scout/explore/exceptions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,15 +25,14 @@
To create an exception for an image, you can:

- Create an exception in the [GUI](/manuals/scout/how-tos/create-exceptions-gui.md) of
Docker Scout Dashboard.

Docker Scout Dashboard or Docker Desktop.
- Create a [VEX](/manuals/scout/how-tos/create-exceptions-vex.md) document and attach
it to the image.

The recommended way to create exceptions is to use Docker Scout Dashboard. The
GUI provides a user-friendly interface for creating exceptions. It also lets
you create exceptions for multiple images, or your entire organization, all at
once.
The recommended way to create exceptions is to use Docker Scout Dashboard or
Docker Desktop. The GUI provides a user-friendly interface for creating
exceptions. It also lets you create exceptions for multiple images, or your
entire organization, all at once.

## View exceptions

Expand All @@ -46,7 +45,7 @@
are visible to anyone who can pull the image, since the VEX document is
stored in the image manifest or on filesystem of the image.

### View exceptions in Docker Scout Dashboard
### View exceptions in Docker Scout Dashboard or Docker Desktop

Check warning on line 48 in content/manuals/scout/explore/exceptions.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.HeadingLength] Try to keep headings short (< 8 words).

Raw Output:
{"message": "[Docker.HeadingLength] Try to keep headings short (\u003c 8 words).", "location": {"path": "content/manuals/scout/explore/exceptions.md", "range": {"start": {"line": 48, "column": 5}}}, "severity": "INFO"}

The [**Exceptions** tab](https://scout.docker.com/reports/vulnerabilities/exceptions)
of the Vulnerabilities page in Docker Scout Dashboard lists all exceptions for
Expand All @@ -59,10 +58,24 @@

To view all exceptions for a specific image tag:

{{< tabs >}}
{{< tab name="Docker Scout Dashboard" >}}

1. Go to the [Images page](https://scout.docker.com/reports/images).
2. Select the tag that you want to inspect.
3. Open the **Exceptions** tab.

{{< /tab >}}
{{< tab name="Docker Desktop" >}}

1. Open the **Images** view in Docker Desktop.
2. Open the **Hub** tab.
3. Select the tag you want to inspect.
4. Open the **Exceptions** tab.

{{< /tab >}}
{{< /tabs >}}

### View exceptions in the CLI

{{% experimental %}}
Expand Down
41 changes: 31 additions & 10 deletions content/manuals/scout/how-tos/create-exceptions-gui.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,24 +1,27 @@
---
title: Create an exception using the GUI
description: Create an exception for a vulnerability in an image using the Docker Scout Dashboard.
keywords: Docker, Docker Scout, vulnerability, exception, create, GUI
description: Create an exception for a vulnerability in an image using the Docker Scout Dashboard or Docker Desktop.
keywords: Docker, Docker Scout, Docker Desktop, vulnerability, exception, create, GUI
---

The Docker Scout Dashboard provides a user-friendly interface for creating
[exceptions](/manuals/scout/explore/exceptions.md) for vulnerabilities found in
container images. Exceptions let you acknowledge accepted risks or address
false positives in image analysis.
The Docker Scout Dashboard and Docker Desktop provide a user-friendly interface
for creating [exceptions](/manuals/scout/explore/exceptions.md) for
vulnerabilities found in container images. Exceptions let you acknowledge
accepted risks or address false positives in image analysis.

## Prerequisites

To create an in the Docker Scout Dashboard, you need a Docker account with
**Editor** or **Owner** permissions for the Docker organization that owns the
image.
To create an in the Docker Scout Dashboard or Docker Desktop, you need a Docker
account with **Editor** or **Owner** permissions for the Docker organization
that owns the image.

## Steps

To create an exception for a vulnerability in an image using the Docker Scout
Dashboard:
Dashboard or Docker Desktop:

{{< tabs >}}
{{< tab name="Docker Scout Dashboard" >}}

1. Go to the [Images page](https://scout.docker.com/reports/images).
2. Select the image tag that contains the vulnerability you want to create an
Expand Down Expand Up @@ -76,3 +79,21 @@ tab of the [Vulnerabilities page](https://scout.docker.com/reports/vulnerabiliti
in the Docker Scout Dashboard.

{{% /create_panel.inline %}}

{{< /tab >}}
{{< tab name="Docker Desktop" >}}

1. Open the **Images** view in Docker Desktop.
2. Open the **Hub** tab.
3. Select the image tag that contains the vulnerability you want to create an
exception for.
4. Select the layer that contains the vulnerability you want to create an
exception for.
5. In the **Vulnerabilities** tab, find the vulnerability you want to create an
exception for.
6. Select the **Create exception** button next to the vulnerability.

{{% create_panel.inline / %}}

{{< /tab >}}
{{< /tabs >}}
Loading