GitHub configuration

This page describes how to set up and configure a third-party configuration before creating the GitHub data store.

Set permissions and obtain client ID and client secret

To register a GitHub app and obtain the client ID and client secret, do the following:

1. Sign in to your GitHub account.
2. Go to Settings > Developer Settings.
3. In the Developer Settings page, click GitHub apps.

4. Click New GitHub app.

   

   GitHub app

5. In the app registration page, do the following:

   1. In the GitHub app name field, enter a label to identify the app.
   2. In the Homepage URL field, enter the full URL to your application homepage.
   3. In the Callback URL field, enter https://vertexaisearch.cloud.google.com/oauth-redirect.
   4. To ensure tokens expire regularly and to receive a refresh_token that can be used to request a new access token, select the Expire user authorization tokens checkbox.
   5. To prompt users to authorize your app when they install it, select the Request user authorization (OAuth) during installation checkbox.

   6. In the Permissions section, enable the following permissions:

      Permission Name	Permission Type	Reason for Access
      Repository: Contents	Read-only	Read files, commits, branches, tags, releases, and search code
      Repository: Issues	Read-only	Read issues, labels, comments, and search issues
      Repository: Pull requests	Read-only	Read pull requests, diffs, PR comments, and search PRs
      Repository: Metadata	Read-only (Mandatory)	Search for repositories and users
      Organization: Members	Read-only	View organization teams and their members
      Account: Profile	Read/Write	Access user profile information
      Organization: Issue Types	Read-only	View available organization issue types

   7. In the section asking where to install the app, select Only on this account.

   8. Click Create GitHub app.

6. In the navigation menu, select Install app.

7. Select an account to install the newly created app and click Install.

8. Select All repositories and click Install & authorize.

9. In the navigation menu, select General.

10. Click Generate a new client secret. Copy the Client ID and the generated Client secret values, and store them securely for later use.

    

    GitHub app General tab