GitHub authentication

Prerequisites

Depending on the authentication type you select, you need one of the following credentials:

• OAuth 2.0 Authorization code: Organization, Account type, and the username and password associated with your GitHub account.
• Bring your own OAuth 2.0 app: Client ID, Client secret, Organization, Account type.

To learn how to create your own OAuth 2.0 application, refer to the GitHub documentation.

Retrieve your GitHub credentials

1. Log in to your GitHub account.
2. Select your profile image in the upper-right corner of the interface and select Your organizations.

3. The list of organizations is available under Organizations. You can choose any of the organization names displayed and use the exact name in the authentication screen of the GitHub connector.

   
   

   

   
   

If you encounter any issues with choosing the correct organization (in case of multiple organizations), contact your IT department.

If you are not part of an organization, you can easily create one from your GitHub interface:

1. Log in to your GitHub account.
2. Select your profile image in the upper-right corner of the interface and select Your organizations.
3. In the Organizations screen displayed, select New organizations.

4. Select your preferred plan and follow the on-screen instructions.

Note: For more information on how to create an organization and the plans available, refer to the GitHub support website.

Add the GitHub connection

To create a connection to your GitHub instance, you need to perform the following steps:

1. Select Integration Service from Automation Cloud^TM.

2. From the Connectors list, select GitHub. You can also use the search bar to narrow down the connector.

3. Select the Connect to GitHub button.

   You can choose between two authentication types: OAuth 2.0 Authorization code or Bring your own OAuth 2.0 app.

4. Enter the required credentials, select the account type (Organization or Personal), and select Connect.

5. Your connection has been added.

Important: There is a limit of ten tokens that are issued for a user-application-scope combination. For details, refer to Authorizing OAuth Apps.

For more information on authenticating with GitHub, refer to the GitHub support website.

Permissions

The UiPath for GitHub connector asks for the following permissions:

• Full control of organization hooks
• Full control of repository hooks
• Read org and team membership, read org projects
• Full control of private repositories
• Update all user data