Create a GitHub App for OpenShift Dev Spaces

Create a GitHub App as an alternative to an OAuth App so that OpenShift Dev Spaces can authenticate your developers with finer-grained repository permissions. .Prerequisites

About this task

  • You are logged in to GitHub.

Procedure

  1. Register a GitHub App. See Registering a GitHub App.
  2. Enter the following values:
    1. GitHub App name: <application_name>
    2. Homepage URL: https://<openshift_dev_spaces_fqdn>/
    3. Callback URL: https://<openshift_dev_spaces_fqdn>/api/oauth/callback
    4. Deselect the Active check box in the Webhook section.
    5. Under Permissions & events, set the Contents repository permission to Read and Write.
  3. Click Create GitHub App.
  4. Click Generate a new client secret.
  5. Copy and save the GitHub App Client Secret for use when applying the GitHub App Secret.
  6. Copy and save the GitHub App Client ID for use when applying the GitHub App Secret.
  7. Install the GitHub App. See Installing your own GitHub App.

Results

  • Verify that the GitHub App appears in your GitHub account under Settings Developer settings GitHub Apps.