Connecting to GitHub using device authorization

Connect your GitHub account to Che using the device authorization flow directly from the Dashboard. Device authentication tokens are GitHub OAuth tokens stored as Kubernetes Secrets. They enable Git operations in your workspaces without requiring a personal access token.

Prerequisites
Procedure

  1. In the Che dashboard, go to User Preferences > Device Auth Tokens.

  2. Click Connect to GitHub.

    A modal opens displaying a one-time code.

  3. Click the copy button next to the code to copy it to your clipboard.

  4. Click github.com/login/device to open the GitHub device activation page.

  5. Paste the one-time code on the GitHub page and click Continue.

  6. Authorize the application when prompted by GitHub.

    After successful authorization, the modal closes and the new token appears in the Device Auth Tokens table.

Verification

  • Verify that the new token is listed in the Device Auth Tokens table with a valid status.

Deleting device auth tokens

Deleting a device auth token removes the Kubernetes Secret and revokes the GitHub authorization.

Procedure

  • To delete a single token:

    1. Click the actions menu (⋮) on the token row.

    2. Click Delete.

    3. Select the confirmation checkbox and click Delete.

  • To delete multiple tokens:

    1. Select the checkboxes next to the tokens you want to delete.

    2. Click Delete in the toolbar.

    3. Select the confirmation checkbox and click Delete.

Additional resources