This guide explains how to connect Docker Hub (Personal) to WatchDog Security using an API access token.Once connected, WatchDog will monitor your Docker Hub environment for container repository configuration risks and inventory information.
What WatchDog Monitors#
WatchDog operates in read-only mode and does not modify configuration settings within your Docker Hub environment.
After the integration is connected, WatchDog may monitor:Docker RepositoriesRepository visibility settings
Repository security configuration
The exact information collected depends on the permissions granted to the API token.
Requirements#
Before connecting the integration, ensure the following:You have administrator access to the Docker Hub account
You're an Account Owner or Security Admin in WatchDog UI
Step 1 — Generate a Docker Hub Access Token#
Docker Hub uses Personal Access Tokens (PATs) to authenticate API access.5.
Under Access Tokens, click Generate New Token
6.
Provide a Token Description (example: WatchDog Security)
7.
Ensure the token has Read access
9.
Copy the generated Access Token
Docker Hub access tokens are only displayed once after creation. Store the token securely before continuing.
Step 2 — Connect the Integration in WatchDog#
2.
Navigate to Management → Integrations
3.
Locate Docker Hub (Personal)
5.
Enter the generated Docker Hub Access Token
6.
Click Connect Integration
Initial Sync#
WatchDog will begin collecting repository metadata from Docker Hub
The first synchronization typically completes within 5–10 minutes
Troubleshooting#
Verify the following:
The access token was copied correctly
The token has read permissions
The token has not expired or been revoked