If you're having trouble at any stage please contact us at support@skyformation.com. 

Preface

The goal of this guide is to add SkyFormation's GitHub Connector to your SkyFormation Platform to monitor either:

• Your Enterprise GitHub server
• Your Cloud based GitHub service (entire cloud editions supported)

The GitHub connector supports two authentication methods. Basic (BasicAuth) and OAuth2.
We highly recommend using OAuth2 authentication over Basic authentication due to its improved security measures. Additionally, Github recently announced it will be deprecating the basic authentication method by Nov 13 2020. If already have an existing github connector with basic authentication configuration, follow the steps below to change to auth2. 

Prerequisites

- Allow access to your  GitHub server/service (*.github.com) addresses over SSL from
  the SkyFormation VM

- personal token. To get your personal token please follow How-to: Get an OAuth2 "personal token" in GitHub

Steps

1. Logon to your SkyFormation Platform

2. Navigate via the left navigation panel to "Settings" section

3. Navigate via New Settings left navigation panel to "Accounts" section

4. Click the "Add Account" bottom

5. At the "SELECT SERVICE TO ADD" choose "GitHub" 

You will see the below screen:

5. Choose from the list the tenant to attach the connector to

    e.g. "default-tenant"

6. Fill in the following information:

    - Account Name
        Give the GitHub connector a meaningful name for you. This will become your
        connector's name displayed in the SkyFormation platform and added to the entire events
        retrieved from the connector and sent to your SIEM/Log server.

        e.g. "corp-source-control"     

    - Description
      Add any text that describes the specific service/connector's function and meaning for the 
      business.

      e.g. "Cloud service GitHub for corporate source control "

7. Choose oauth2 as the authentication method to use. Basic authentication is deprecating on Nov 13,      2020 so is not recommended.

    - Fill in the "Personal Token" field  With the token provided by your GitHub admin.

     8. Fill in your GitHub server/service "Host Name" 

    If you are using an Enterprise GitHub server put your GitHub server address
    (e.g. mygithub.myorg.com)

    If you are using a cloud based edition of GitHub put github.com

9. Test the settings correctness: 

    Press the "TEST CONNECTION" button

    If you see a green OK sign appears as above you have completed the onboard successfully.

- Click "SAVE" button

10. Start the new connector

     When a new cloud connector is added its default state is STOPPED.

     To start it press its START button. 

DONE !