Best Practice for GitHub User Load

The best practice for the GitHub User Load provides you with the information that you need to complete and run the integration successfully, and gain visibility of the data that is ingested by Oomnitza.

The following items are in the package:

• The Integration
  • GitHub Users Load
• The Credentials
  • GitHub User Load
• The Workflow
  • GitHub SaaS Users Role

For the integration to run, information such as authorization and integration values, must be added or updated. 

Best practice
For the integration with Oomnitza, create a dedicated user account.

Update credentials

1. On the AUTHORIZATION tab, complete these actions:
   • Ensure that 0Auth 2.0 is selected.
   • Ensure that GitHub is the selected SaaS application.
2. Enter your client ID and client secret.
3. Ensure that a value is entered for the scope.
4. Enter your tenant ID.
5. Click Authenticate.
6. Click SAVE. 

GitHub: Building OAuth 2.0 apps

GitHub: Authorizing OAuth 2.0 apps 

GitHub: Scopes

Update the integration

1. From the menu click Configuration > Integration, and then click Integration List View  .
2. Click the integration tile for GitHub user integration.
3. Go to the Connect page and make the following changes:
   • Change the value selected for Integration preference. If this is the first time that you have run the integration, select Create & Update.   
   • To identify who made the integration changes, add a valid username in the Integration user field.
   • Enter the GitHub organization ID
4. Click NEXT.
5. On the Mappings page, click Edit Connector. You can add rules to exclude the user records that you don't want to monitor such as system users and bots.
6. When you complete making your changes, click NEXT until you get to the final page and then click FINISH.

Add fields to the People view

New fields that are ingested by Oomnitza are not automatically listed on the People page.

Add new fields

1. Click People.
2. Click Add.
3. Click Configure the view .
4. Click + Add Fields.
5. Select the fields that you want to add and click ADD.
6. Click List View Configs .
7. Select the fields.

Tip
If you want to add multiple new fields that are related, create a group in screen builder and add the fields to the group.