---
title: "Connect Clarity Security to Github"
slug: "github"
description: "Learn how to connect Clarity Security to Github to automate your identity life cycle management and user access reviews."
tags: ["connectors", "marketplace", "application", "How-To"]
updated: 2023-05-03T16:36:09Z
published: 2023-05-03T16:36:09Z
canonical: "help.claritysecurity.com/github"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.claritysecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

This guide will teach you how to set up the connector between [Github](https://github.com/) and [Clarity Security](https://claritysecurity.io/).

**Estimated time to complete:** 10 minutes

If you encounter any problems, please contact your support team or [support@claritysecurity.io](mailto:support@claritysecurity.io).

## Supported Connector Capabilities

## 

Below are capabilities supported by the connector at this time.

| **Method** | **Supported** |
| --- | --- |
| Provision User | Yes |
| List Groups, Policies, and Roles | Yes |
| Add User to Groups, Policies, and Roles | Yes |
| Remove User from Groups, Policies, and Roles | Yes |
| Deactivate User | No |
| Delete User | No |

## How to Setup the Connector

### Step 1: Navigate to Connector

Head to the following link to connect Github with your Clarity Security tenant.

> [https://github.com/apps/clarity-security-github-connector](https://github.com/apps/clarity-security-github-connector)

### Step 2: Click Install

Click the install button to install the application to your GitHub organization.

![Clarity Security Github Connector](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Screenshot%202023-01-30%20at%207.39.27%20AM.png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 3: Select your GitHub Organization

Choose the organization that you wish to connect to your clarity tenant.

![Choose your Organization](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679692308037.png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 4: Determine your app installation id

If you are not redirected automatically to a page listing the installation id for the application (see link below), you will want to navigate to the settings page for your organization, and click on the **Third-party Access**, then **GitHub Apps.**

> https://github.com/organizations/YOUR_ORG_NAME/settings/installations/XXXXXXXXX

If you already got your installation id (example in the URL above), you can skip to **Step 7**.

![Organization > Third-party Access > GitHub Apps](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/github%20third-party%20access(1).png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 5: Click Configure

Click the **Configure** button for the Clarity Security GitHub Connector.

![Installed GitHub Apps > Clarity Security GitHub Connector](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/github%20installed%20apps.png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 6: Grab the installation id

Once you click configure, the URL at the top of the page should look similar to the one listed below, where the "XXXXXXXXX" represents the series of numbers for your app installation id. **Copy this value** for use in a later step.

> https://github.com/organizations/YOUR_ORG_NAME/settings/installations/XXXXXXXXX

### Step 7: Log in to Clarity

Login to your Clarity Security tenant.

> https://your_tenant.claritysecurity.io

### Step 8: Click on Applications, then Marketplace

![Applications > Marketplace](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679588491503.png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 9: Find GitHub

Scroll to or search for **Github** in the list of applications from the marketplace, then click **Connect**.

![Marketplace > Github](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/github%20marketplace.png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 10: Connect App

Complete the App Settings form. Details for fields common to all applications can be found in the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-1-connect-app).

- **app_installation_id**: Paste the value obtained from either **Step 4** or **Step 6**.

![Configure App > Connect App - Github](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679942355365.png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 11: App Settings

Complete the App Settings form. Details for each field can be found in the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-2-app-settings).

![Configure App Step 2 - App Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%202(3).png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 12: User Settings

Complete the User Settings form, check the table at the top to see if any features are unsupported. Details for each field can be found in the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-3-user-settings).

![Configure App Step 3 - User Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%203(2).png?sv=2026-02-06&spr=https&st=2026-11-12T19%3A37%3A48Z&se=2026-11-12T20%3A37%3A48Z&sr=c&sp=r&sig=qV5zj4yr03g6L7MIAnemBEnfC9WRf7xMwDFzCHcojLo%3D)

### Step 13: Validate Your Selections and Save

SaveClicking the Save button will trigger the first full sync for your application (even if you selected Manual syncing).  This includes Service Users, Entitlements, Service User Entitlements, Service User Attributes.  

## Need Help?

If you have any problems, contact your customer success team. You can also get in touch with our general support [via email](mailto:support@claritysecurity.io), open a [support ticket](https://support.claritysecurity.com/home). Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST.

A Service User is a user, or service account, discovered by Clarity in a downstream application.

An Entitlement is an assignable permission found in a downstream application. Common examples include licenses, groups, and policies.

Service User Entitlements are the pairings of users and active entitlement access in downstream applications.

An attribute is a piece of information used to describe a service user, entitlement, or identity. Common examples include First Name, Last Name, Job Title, Department, etc.