Docker Registry / Distribution
Docker Registry / Distribution is a self-hosted Docker Registry V2-compatible registry that organizations run in their own environments. Connecting Docker Registry / Distribution to OX enables OX to discover and scan container images stored in your private registry and surface container security findings alongside the rest of your application security results.
Unlike the Docker Hub connector, which connects to the Docker SaaS platform, the Docker Registry / Distribution connector supports registries hosted and managed within your own environment.
Prerequisites
Before connecting Docker Registry / Distribution to OX, ensure that:
You have permission to configure integrations in OX.
Your Docker Registry / Distribution instance is accessible from OX.
You have a Docker Registry account with permissions to access the repositories that you want OX to scan.
You know the following connection details:
Docker Registry host URL
Username
Password
Note
If your registry is hosted in a private network or behind a firewall, allow connectivity from OX to the registry or configure an OX Broker.
Connect OX to Docker Registry / Distribution
In OX, go to Settings > Connectors.
Select Add Connection.
Select Docker Registry / Distribution.
Enter the connection details.
Docker Registry / Distribution Host URL
The URL of your Docker Registry instance. For example: https://registry.example.com.
User Name
The username used to authenticate to the registry.
Password
The password associated with the registry account.
Connection Name
A descriptive name for the connection in OX.
Select Verify Connectivity.
Select Connect.
Open the connection configuration.
Select the repositories that you want OX to monitor and scan.
Select Save.
After the connection is established, OX scans the selected repositories and continuously monitors them for container security findings. Findings are available throughout the OX platform, including Active Issues, Applications, dashboards, reports, and workflows.
Last updated