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

# GitHub

> Configure GitHub OAuth for your Customer Portal.

## Overview

Offering a sign in with GitHub in your Customer Portal can be great if you target a developer audience. It allows your users to sign in with their Github account and provides you with their email and profile picture.

To support Sign in with GitHub you need to configure the GitHub provider in the Kobble dashboard for your project.

Once configured, the GitHub sign-in button will automatically be added on your Kobble Customer Portal.

## Configuration

1. Navigate to the [Authentication](https://app.kobble.io/p/authentication) section and choose the GitHub provider.
2. Copy the provided Redirect URI. Note this URI will change if you configure a custom domain later.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/github-configuration-1.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=36d2d05e14897a201d915919927e9931" alt="GitHub Configuration 1" width="1944" height="1705" data-path="images/settings/auth/github-configuration-1.png" />

3. Open [your GitHub account](https://github.com).
4. Click on your profile picture and select Settings.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/github-configuration-2.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=35dce5f13aebbbb5c161896f748c4cfa" alt="GitHub Configuration 2" width="1600" height="1455" data-path="images/settings/auth/github-configuration-2.png" />

5. Then, on the left menu, choose Developer settings.
6. Select OAuth App and click on Register new OAuth App.
7. Fill in the form with the information of your application and the Redirect URI provided by Kobble.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/github-configuration-3.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=48bce2e99d26abd0dc3569c252fc6362" alt="GitHub Configuration 3" width="1618" height="1514" data-path="images/settings/auth/github-configuration-3.png" />

8. Once created, click on Generate a new client secret and copy the Client ID and Client Secret provided by GitHub.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/github-configuration-4.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=5afe6ef7a05a2a11f0c434dcec7cb42e" alt="GitHub Configuration 4" width="1600" height="860" data-path="images/settings/auth/github-configuration-4.png" />

9. Paste them into your Kobble settings, turn on the Enabled switch and save.

<img src="https://mintcdn.com/kobble/hy82n-p3NucxH50S/images/settings/auth/github-configuration-5.png?fit=max&auto=format&n=hy82n-p3NucxH50S&q=85&s=b0ec948489f055a37c1dca601fbececd" alt="GitHub Configuration 5" width="1610" height="1710" data-path="images/settings/auth/github-configuration-5.png" />

🎉 Et voilà! Your customer can now use GitHub to sign-in in your authentication portal. No further action is required on your end.

<Warning>In case you change your Customer Portal domain later, you will have to go through this process again and update your Authorized Redirect URI in your GitHub configuration.</Warning>
