Skip to content

Setup Your GitHub OAuth Application

mathbook-io edited this page Mar 23, 2018 · 3 revisions

Why do I need to setup a GitHub OAuth Application?

You only need to setup a GitHub OAuth Application if you're looking to get authentication functionality working in your local development environment. You can totally skip this if you're not looking to do anything related to logged in users on Mathbook.

Setup

  1. Visit github.com and Sign In
  2. Navigate to your profile settings page
  3. In the side bar, find and click on Developer Settings
  4. Then click on New OAuth App
  5. You will then be navigated to a page that looks similar to this,

screenshot

  1. Confirm that the Homepage URL and Authorization callback URL you entered match what you see in the screenshot above.
  2. Click Update Application
  3. Now, copy the clientId and clientSecret for your newly created Application into your config/local.json file.

If that didn't work out, you can refer to the official documentation on building an OAuth App on GitHub