Adding your GitHub credentials to Oomnitza

Best practice
For the integration with Oomnitza, create a dedicated user account in GitHub. The user account that you create must have create, read, update, and delete privileges.

GitHub uses OAuth 2.0 authentication and requires your GitHub Client ID and Secret to be added to Oomnitza. To obtain your Client ID and Secret, complete the following steps:

1. Log in to the GitHub.
2. In the upper-right corner of any page, click your profile photo, then click Settings.
3. In the left sidebar, at the bottom of the page, click Developer settings.
4. Click OAuth Apps > New OAuth App
5. Enter the app name and homepage URL.
6. Set the Authorization callback URL tohttps://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_url
7. Click Register application.
8. When your app is created click Generate a new client secret. 
9. Copy your Client ID and Client Secret for the next step.

Adding your GitHub credentials

To stream GitHub user data into Oomnitza, complete the following steps:

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the integration, and then click the forward arrow > to select the integration. 
4. Enter your client credentials and any other additional information.
5. Click Authenticate. You are prompted to log in to authorize your request.
6. Click CREATE.

1. Add the information details.
2. Click the AUTHORIZATION tab.
3. Ensure that OAuth 2.0 is selected as the Authorization type.
4. Ensure that GitHub is selected from the SaaS list.
5. Enter the Client ID, Client Secret, and Scope. Enter the following scopes: admin:org user
6. Click Authenticate.
7. Important: A pop-up will appear similar to the image below. Ensure that you select Grant and Authorize user otherwise the app will not have full permissions to read private and public users.
8. Enter a Description to help you identify the credential (optional).
9. Click CREATE. 

Documentation:

GitHub Authentication: Creating an OAuth App

GitHub API: Scopes. 

Next steps

 Now that you have added your GitHub OAuth credentials to Oomnitza, you can run the GitHub user integration.