Custom Github Identity Provider

Last updated 11/23/2021

Step 1

Log in to GitHub: https://github.com/


Step 3

  • For the Application name, we recommend using your organization or company name.
  • For the Homepage URL, enter your organization’s homepage.
  • For the Authorization callback URL, enter: https://api.breadbutter.io/callback
  • Click Register application.

Step 4

Take note of the Client ID and Client Secret on the App page for the Bread & Butter setup below.

Step 5

Bread & Butter Setup:

  1. Go to https://app.breadbutter.io/sign-in/
  2. Click Sign In and authenticate (or Sign Up make a new account and authenticate).
  3. Navigate to Providers, then to Default Rules (or Domain Rules and open/create a domain module).
  4. Click "Sign in with Github" button.
  5. Select "Set Github for Production".
  6. Enter a custom name and description.
  7. Enter the Client ID from the Github setup steps above.
  8. Enter the Client Secret from the Github setup steps above.
  9. Click Save & Close.
  10. Click the checkbox next to your new Github provider to enable it.
Step 5