Github - User Guide

In this article, you will understand step by step how to easily integrate with Github

Permissions for Github Integration 

The connection should be established by the owner of the organization. Only read access is required for all the listed scopes:

1. Administration
2. Checks
3. Issues
4. Members
5. Metadata
6. Organization administration
7. Pull requests

Prerequisites for Github Integration

1. Organization Owner in Github - Sign in to your Github account as the owner of the organization you wish to connect with.
   1. To confirm that you are the Organization Owner, visit the following page: https://github.com/settings/organizations.
      Make sure you see at least one organization listed on the page.
2. If you've previously connected Scytale to GitHub organization, you may need to remove the Scytale app before connecting.

How to Connect Scytale and Github

1) In Scytale, go to 'Integrations'.

 2) Search for Github and select 'Connect'.

3) Add a connection name - this will be used to differentiate between your connections - and then select 'Next'.

5) You will now be redirected to Github in a new tab to sign in.

6) You will see a list of your organizations. Select the GitHub organization you wish to have connected with Scytale.

7) On the next page, you will see the list of permissions being requested.

All repositories: Choose this if you want Scytale to monitor all repositories within the selected organization, including any created in the future.

Only select repositories: Choose this if you want Scytale to monitor specific repositories only. Unselected private repositories will not be monitored (public ones remain visible even if not selected).
New repositories created in the future will not be monitored automatically. To include or remove them later, follow these steps.

8) Select 'Install & Authorize'.

You have now successfully connected to Github!

1) Go to the GitHub home page and click on your profile image.

2) Select 'Your organizations'.

3) Find your organization and select 'Settings'.

4) Go to 'GitHub Apps' in the 'Third-party Access' section.

5) Select 'Configure' for the 'Scytale.ai' connection.

6) In the 'Repository access' tab select new repositories from the list / remove old ones.

7) Select 'Save'.