Skip to main content
Skip table of contents

Authorize a Group in Github

These pages refer to DKP Enterprise and DKP Gov Advanced products.

Install GitHub as an identity provider and grant access to all developers.

Authorize Access to Your Clusters

Ensure every developer in your GitHub organization has access to your Kubernetes clusters. To authorize all developers to have read access to your clusters:

  1. Set up GitHub as an identity provider. Start by creating a new OAuth Application in our GitHub Organization by filling out this form.

    Important: Use your cluster URL followed by /dex/callback as the Authorization callback URL.

  2. After you create the application, you will be taken to a settings page. You will need the Client ID and Client Secret from this page for the DKP UI. Select the Generate a new client secret button if you do not already have a Client Secret for the application.

  3. From the top menu bar in the DKP UI, select the Global workspace.

  4. Select Identity Providers in the Administration section of the sidebar menu.

  5. Select the Identity Providers tab, and then select the + Add Identity Provider button.

  6. Ensure GitHub is selected as the identity provider type, and copy the Client ID and Client Secret values into the form.

  7. Select Save to create your Identity Provider.

D2iQ configured the identity provider to load all groups, so you must map these groups to the Kubernetes groups.

Map the Identity Provider Groups to the Kubernetes Groups

  1. Select the Groups tab, and then select the Create Group button.

  2. Give your group a descriptive name and add the groups from your GitHub provider under Identity Provider Groups.

  3. Click Save to create the group, which creates it on the management cluster and federated to all target clusters, and also describes the developers for your organization.

To enable this group, you need to first create a role which allows you to view every resource.

Create a “Read Everything” Role

  1. Select Access Control in the Administration section of the sidebar menu.

  2. Select the Cluster Roles tab, and then select the + Create Role button.

  3. Give the role a descriptive name, and ensure that Cluster Role is selected as the type.

  4. For a read-only role, select + Add Rule, then select All Resource Types in the Resources input, and select the get, list, and watch verbs.

Now you can assign the “Read Everything” role to the developers group.

Assign the Role to the Developers Group

  1. Select the Cluster Role Bindings tab, and then select the Add roles button for your group.

  2. Select “Read Everything” role from the Roles drop-down.

Lastly, follow the example in the Access Control documentation to grant users access to Kommander routes on your cluster.

When you check your attached clusters and login as a user from your matched groups, you can see every resource, but neither delete or edit them, as intended.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.