This guide shows you how to integrate GitHub as a login option for your application with Entrypage. Once you’re done, your users can sign in with their GitHub accounts, making the sign-in process quick and easy.

Prerequisites:

Step 1: Configuring GitHub

To integrate GitHub login with Entrypage, the first step is to configure a GitHub OAuth App. This process is handled through your GitHub account settings.

  1. Create a New OAuth App:
    • Sign in to your GitHub account and navigate to Settings > Developer settings > OAuth Apps.
    • Click the New OAuth App button.
  2. Fill in the App Details:
    • Application name: Choose a descriptive name for your application. This is what users will see when they authorize it.
    • Homepage URL: Enter the main URL of your application (e.g., https://auth.yourserver.com).
    • Authorization callback URL: This is the most crucial part. Enter the callback URL provided by Entrypage, which follows this format: https://{your-auth-server}/account/redirect. For example, https://auth.yourserver.com/account/redirect.
  3. Register the Application:
    • Click Register application.
    • On the next page, GitHub will provide you with a Client ID. Copy this value.
    • Click Generate a new client secret and copy the resulting secret. You’ll need both the Client ID and Client Secret in the next step to configure the connection in Entrypage.

Step 2: Configure the Connection in Entrypage

Sign in to your account at https://portal.entrypage.io.

  1. Go to Settings > External Identity-Providers and enable the Google connection.
  2. Paste the Client ID and Client Secret you copied from GitHub, then click Save.
  3. Navigate to the Clients section and select the client where you want to enable GitHub authentication.
  4. Scroll down to the Authentication methods section, enable GitHub, and then click Update.

Testing and Troubleshooting Now, navigate to the login page for that client. You should see a Sign in with GitHub button. Test it to confirm the configuration works correctly.

If you run into any trouble, double-check your Client ID, Client Secret, and Authorization callback URL for any typos. You can also review the Diagnostics section for helpful information.