Set up the GitHub spoke

Integrate your ServiceNow instance with the GitHub and GitHub Enterprise Server to automate flows and perform actions on GitHub and GitHub Enterprise Server. For example, create a flow that creates a branch on GitHub and retrieves its details.

Before you begin

• Request an Integration Hub subscription.
• Activate the GitHub spoke.
• An account with GitHub to create personal access tokens.
• If you are using GitHub Enterprise server, an account to create personal access tokens.
• Role required: admin.

Procedure

1. Generate a personal access token in GitHub account.
   1. Log in to https://github.com/.
   2. On the dashboard, select your profile icon.
      
   3. Select Settings.
   4. In the Settings page, on the left panel, select Developer settings.
   5. In the Developer settings page, on the left panel, navigate to Personal access tokens > Tokens (classic).
   6. Select Generate new token > Generate new token (classic).
   7. In Note, enter a description or purpose of the personal access token.
   8. In Expiration, set the expiry period of the token or select No expiration.
   9. Under the Select scopes heading, select the scopes that define the access for the personal access token you’re generating.
   10. Select Generate token.
       The personal access token is generated.
   11. To copy the personal access token, select the copy button.
       

       Important:

       Keep the personal access token at a secure place. You’ll need it when you create a connection record for GitHub.
2. Configure the connection record that connects your ServiceNow instance with GitHub.
   1. Log in to your ServiceNow.
   2. Navigate to All > Process Automation > Workflow Studio.
   3. Click the Integrations tab.
   4. Under Connections, toggle and enable the Outbound connections.
   5. Locate the GitHub connection alias and click View Details.
      If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.
   6. On the form, fill the details.

      Table 1. Configure Connection form

      Field	Description
      Connection Name	Name of the connection. Note: The default and read-only name of the first connection record is GitHub.
      Connection URL	URL to connect to GitHub. Enter https://api.github.com.
      Use Mid Server	Enter 1 if your ServiceNow instance requires a MID Server to connect with GitHub. Enter 0 if your ServiceNow instance does not require a MID Server to connect with GitHub. Important: To enable this option, you must already have a MID Server set up on your instance. See MID Server for detailed instructions.
      API Key	Personal access token that you had generated on GitHub.

   7. Select Create Connection.
      The GitHub connection record is created.
3. If you are using GitHub Enterprise server, configure the GitHub Server connection.
   Important:

   Generate a personal access token on the GitHub Enterprise server.

   To learn to generate a personal access token on the GitHub Enterprise server, see Integrate with GitHub Enterprise Server.

   1. Select the GitHub Server connection card.
   2. Select View Details.
   3. Fill the form.

      Table 2. Configure Connection form

      Field	Description
      Connection Name	The name of the connection. Note: The default and read-only name of the first connection record is GitHub Server. To create a connection with your custom name, select Add Connection and fill the form.
      Connection URL	URL of your GitHub instance.
      Use Mid Server	Enter 1 if your ServiceNow instance requires a MID Server to connect with the GitHub Enterprise server. Enter 0 if your ServiceNow instance does not require a MID Server to connect with the GitHub Enterprise server. Important: To enable this option, you must already have a MID Server set up on your instance. See MID Server for detailed instructions.
      API Key	Personal access token that you had generated on the GitHub Enterprise Server.

   4. Select Create Connection.
      The GitHub Enterprise Server connection record is configured.