github-oauth-setup.md

GitHub OAuth Setup

Using GitHub OAuth requires you to fill in the GitHub Client Id and GitHub Secret

Follow these steps to enable GitHub OAuth on your server.

• Go to your GitHub Developers Settings
• Navigate to OAuth Apps and click on Register a new application

• Fill in the required information and hit Register application

{% hint style="warning" %} If your callback URL is wrong, GitHub does not display any error. Instead of logging in, you receive an error message saying, "No matching login attempt found." {% endhint %}

• After creating your app, a screen is shown with your client id and a button you can use to generate you apps secret

• Click and confirm access to generate a new secret which you will use in setting up the OAuth

• After creating your new GiHub OAuth app, copy the Client Id and Secrete provided
• Head over to the GitHub OAuth section on your Rocket.Chat server by navigating to Administration > Workspace > Settings > OAuth

• Enable GitHub OAuth, fill in the credentials and hit Save Changes to commit

After saving, you will find the GitHub OAuth button on the login and register page

To register with GitHub, just click the button and accept access.