If you're having trouble at any stage please contact us at firstname.lastname@example.org.
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 July 2020.
- Allow access to your GitHub server/service (*.github.com) addresses over SSL from
the SkyFormation VM
- If you would like to use the connector's "oauth2" authentication method follow the guide at:
How-to: Get an OAuth2 "personal token" in GitHub
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
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.
Add any text that describes the specific service/connector's function and meaning for the
e.g. "Cloud service GitHub for corporate source control "
7. Choose the "Authentication Method" you would like the connector to use
"oauth2" / "basic"
7.1 If you choose "oauth2" as the authentication method to use
- Fill in the "Personal Token" field
With the token provided by your GitHub admin.
7.2 If you choose "basic" as the authentication method to use
- Fill in the "User" field
With the user name provided by your GitHub admin.
- Fill in the "Password" field
With the user's password 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
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.