Image Access Management

Note

Image Access Management is available to Docker Business customers only.

Image Access Management gives administrators control over which types of images, such as Docker Official Images, Docker Verified Publisher Images, or community images, their developers can pull from Docker Hub.

For example, a developer, who is part of an organization, building a new containerized application could accidentally use an untrusted, community image as a component of their application. This image could be malicious and pose a security risk to the company. Using Image Access Management, the organization owner can ensure that the developer can only access trusted content like Docker Official Images, Docker Verified Publisher Images, or the organization’s own images, preventing such a risk.

Prerequisites

You need to configure a registry.json to enforce sign-in. For Image Access Management to take effect, Docker Desktop users must authenticate to your organization.

Configure Image Access Management permissions


  1. Sign in to Docker Hub.
  2. Select Organizations, your organization, Settings, and then select Image Access.
  3. Enable Image Access Management to set the permissions for the following categories of images you can manage:
  • Organization images: Images from your organization are always allowed by default. These images can be public or private created by members within your organization.
  • Docker Official Images: A curated set of Docker repositories hosted on Hub. They provide OS repositories, best practices for Dockerfiles, drop-in solutions, and applies security updates on time.
  • Docker Verified Publisher Images: Images published by Docker partners that are part of the Verified Publisher program and are qualified to be included in the developer secure supply chain.
  • Community images: These images are disabled by default when Image Access Management is enabled because various users contribute them and they may pose security risks. This category includes Docker-Sponsored Open Source images.

Note

Image Access Management is turned off by default. However, owners in your organization have access to all images regardless of the settings.

  1. Select the category restrictions for your images by selecting Allowed. Once the restrictions are applied, your members can view the organization permissions page in a read-only format.

Verify the restrictions

The new Image Access Management policy takes effect after the developer successfully authenticates to Docker Desktop using their organization credentials. If a developer attempts to pull a disallowed image type using Docker, they receive an error message.

Early Access

The Docker Admin Console is an early access product.

It's available to all company owners and organization owners. You can still manage companies and organizations in Docker Hub, but the Admin Console includes enhanced features for company-level management.

  1. Sign in to the Admin Console.
  2. Select your organization in the left navigation drop-down menu, and then select Image access.
  3. Enable Image Access Management to set the permissions for the following categories of images you can manage:
  • Organization images: Images from your organization are always allowed by default. These images can be public or private created by members within your organization.
  • Docker Official Images: A curated set of Docker repositories hosted on Hub. They provide OS repositories, best practices for Dockerfiles, drop-in solutions, and applies security updates on time.
  • Docker Verified Publisher Images: Images published by Docker partners that are part of the Verified Publisher program and are qualified to be included in the developer secure supply chain.
  • Community images: These images are disabled by default when Image Access Management is enabled because various users contribute them and they may pose security risks. This category includes Docker-Sponsored Open Source images.

Note

Image Access Management is turned off by default. However, owners in your organization have access to all images regardless of the settings.

  1. Select the category restrictions for your images by selecting Allowed. Once the restrictions are applied, your members can view the organization permissions page in a read-only format.

Verify the restrictions

The new Image Access Management policy takes effect after the developer successfully authenticates to Docker Desktop using their organization credentials. If a developer attempts to pull a disallowed image type using Docker, they receive an error message.