---
title: "SSO - GitHub Settings"
slug: "sso-github-settings"
updated: 2024-08-14T05:07:14Z
published: 2024-08-14T05:07:14Z
canonical: "docs.processmaker.com/sso-github-settings"
---

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

# SSO - GitHub Settings

Configure SSO settings for GitHub.

## Configure GitHub SSO Settings

**Permissions**

Furthermore, your user account or group membership must have the "Settings: Update Settings" permission to edit SSO SAML settings unless your user account has the **Make this user a Super Admin** setting selected.

See the [Settings](/v1/docs/permission-descriptions-for-users-and-groups#settings) permissions or ask your Administrator for assistance.

The following information is required to configure SSO with GitHub:

- Client ID
- Client Secret

To generate or locate your GitHub client ID and client secret, refer to [Authorizing OAuth Apps - GitHub Docs](https://docs.github.com/en/developers/apps/building-oauth-apps/authorizing-oauth-apps).

See an example in the following video showing how to configure GitHub SSO settings.

- **Intended audience:** System administrators and Process designers
- **Viewing time:** 2 minutes; contains narration

[Embedded content](https://cdn.iframe.ly/DrrelP4)

GitHub SSO configuration

Configure the following GitHub SSO settings as necessary:

1. ​[Configure your SSO Settings](/v1/docs/sso-settings#configure-sso-saml-settings).
2. From the list of SSO identity providers, select the **GitHub** option. The **SSO - GitHub** panel displays.

![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/e3fa186e-df01-4610-a0fe-11f8ef626a32.png)
3. Click the **Edit** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/a89d79a7-4765-47e1-bc6e-aa99e7a99e64.png) for the **Client ID** setting. The **Client ID** screen displays.

![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ea4561e9-a632-4a0d-be6c-368bc38fd606.png)
4. Enter your GitHub client ID, and then click **Save.**
5. Click the **Edit** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/a89d79a7-4765-47e1-bc6e-aa99e7a99e64.png) for the **Client Secret** setting. The **Client Secret** screen displays.

![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b459d277-d9bd-42f8-a079-4a9af22a2111.png)
6. Enter your GitHub client secret, and then click **Save**
7. Use the copy icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/4741aa56-9281-4354-9dd2-889661137387.png) to copy the URL from the **Redirect** setting, and then provide it in your GitHub application settings.