#Overview

You can allow your users to sign up & log in to your web app with their GitHub account.

#Usage

#Prerequisites

• You will need a GitHub account
• You will need to have the Magic SDK installed into your web app
• You will need to have the Magic SDK - OAuth Extension installed into your web app

#GitHub Setup (v1 extension)

After installing the OAuth extension, you can now enable GitHub Login for your Magic app:

1. Follow GitHub's instructions to create an OAuth app
2. Go to your Magic Dashboard
3. Select the Magic app for which you’d like to enable Github Login, or create a new app
4. Navigate to Social Login from the sidebar
5. Click the toggle for GitHub
6. Copy the Redirect URI field from your Magic Dashboard
7. Return to your GitHub Dashboard and paste the Redirect URI you obtained from your Magic Dashboard into the "Authorization callback URL" field
   
8. Click "Register App" to complete your GitHub OAuth app setup.
9. On the next page, obtain the "Client ID" and "Client Secret"
   
10. Return to your Magic Dashboard and input the Client ID and Client Secret for your GitHub OAuth app
11. In Magic Dashboard, click “Save” – Done!

#GitHub Setup (v2 extension)

• Follow above steps, but disregard Magic's Redirect URI in step 6
• In step 7, paste the Redirect URI you are passing in as the redirectURI argument to the loginWithRedirect method

01await magic.oauth2.loginWithRedirect({

02  provider: 'github',

03  redirectURI: 'https://your-app.com/your/oauth/callback', // <== whitelist this with GitHub

04});

#Resources

• GitHub Social Login Demo