Docker Hub Integration Setup
Getting Started
Use this guide to connect Docker Hub to your BalkanID tenant. You will need credentials from Docker Home and access to the Integrations section in BalkanID.
Docker Hub requires two separate credentials. The SCIM API token provides user records and their status, and the organization access token provides organization membership, teams and roles. Both are required.
Requirements:
Before you begin, collect the following values from Docker:
SCIM URL
SCIM API Token
Organization Name
Organization Access Token
Configure Docker Hub within your BalkanID tenant
To find the SCIM URL and SCIM API Token, sign in to Docker Home and select Identity & auth, then SSO and SCIM.
In the SSO connections table, select the Actions icon for your connection, then select Setup SCIM.
Copy the SCIM Base URL and API Token values. The base URL is the value BalkanID asks for as SCIM URL.
To create the Organization Access Token, select your organization in Docker Home, then select Identity & auth followed by Access tokens.
Select Generate access token, give it a label and an expiration date, then expand the Organization dropdown and enable Member Read and Group Read (see Integration Scopes below).
Select Generate token and copy the value. Docker shows it only once. Your Organization Name is the organization's name as it appears in Docker Home.
In BalkanID, go to Integrations and select Add integration.

Search for Docker Hub, select it, and click Next.

Set the primary application owner, and a description if you want one. Under Select Extraction Type, choose Direct Configuration and paste the four values you collected into the corresponding fields, then click Next.

Fill Optional Configuration, if required.

Once you have filled in the information, click Save. Your integration is now configured and you will see the status of the integration displayed alongside other integrations on the Integrations page. When data is available, the integration Status column will read Connected and the integration Message will read Data available.
What BalkanID extracts
Users
Every member of the organization, including accounts that were not provisioned through SCIM.
Teams
The organization's teams, and each user's membership of them.
Organization roles
Each member's role in the organization — owner, editor or member.
Docker does not expose team-to-repository permissions for reading, so repository-level access is not extracted.
Integration Scopes
Member Read — organization members, their email addresses, roles and team membership
N/A
Group Read — the organization's teams
N/A
Last updated
Was this helpful?

