import ConfigDone from '/docs/snippets/u-and-p-provider-config-done.md'

GitHub provider setup for Users & Permissions#

GitHub provider setup enables OAuth authentication for Strapi's Users & Permissions feature, requiring GitHub OAuth app configuration and Strapi provider settings.

The present page explains how to setup the GitHub provider for the Users & Permissions feature.

You have read the Users & Permissions providers documentation.

GitHub configuration#

1. Visit the OAuth Apps list page
2. Click on New OAuth App button
3. Fill the information (replace with your own ngrok url):
   • Application name: Strapi GitHub auth
   • Homepage URL: https://65e60559.ngrok.io
   • Application description: Strapi provider auth description
   • Authorization callback URL: https://65e60559.ngrok.io/api/connect/github/callback

Strapi configuration#

1. Visit the User & Permissions provider settings page at
2. Click on the GitHub provider
3. Fill the information (replace with your own client ID and secret):
   • Enable: ON
   • Client ID: 53de5258f8472c140917
   • Client Secret: fb9d0fe1d345d9ac7f83d7a1e646b37c554dae8b
   • The redirect URL to your front-end app: http://localhost:3000/connect/github/redirect