For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

SCIM is available on a Docker Business subscription with single sign-on configured. Organization access tokens require a Docker Team or Business subscription, and you must be an owner of the organization.

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

  1. To find the SCIM URL and SCIM API Token, sign in to Docker Home and select Identity & auth, then SSO and SCIM.

  2. In the SSO connections table, select the Actions icon for your connection, then select Setup SCIM.

  3. Copy the SCIM Base URL and API Token values. The base URL is the value BalkanID asks for as SCIM URL.

  4. To create the Organization Access Token, select your organization in Docker Home, then select Identity & auth followed by Access tokens.

  5. 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).

  6. 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.

  7. In BalkanID, go to Integrations and select Add integration.

The Integrations page in BalkanID with the Add integration button in the top right
Integrations
  1. Search for Docker Hub, select it, and click Next.

The Connect a new application step with Docker Hub selected
Connect a new application
  1. 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.

The Direct Configuration fields for Docker Hub: SCIM URL, SCIM API Token, Organization Name and Organization Access Token
Direct Configuration
  1. Fill Optional Configuration, if required.

The Optional Configuration step showing reviewer settings and fulfillment options
Optional Configuration
  1. 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

Type
Description

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

Read Only Scopes
Lifecycle Management 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?