Prerequisites
Installation & Setup
API
Config File
Developer Mode
Developer Tools
Enable Debug Mode
Events
Extensions
Features
Integrations
License System Extension
Permissions
Updating FaxStore
Weblutions Documentation > FaxStore > Installation & Setup > 5. Login Configuration
5. Login Configuration
Now that we have configured everything else, there is one more major task before we're on the home stretch of installing FaxStore.
FaxStore comes with four login methods you can pick from.
- Discord
- GitHub
There is a section below for each login method and how to obtain the API tokens to login with these services.
Discord
Although the most common Discord offers a range of out of app features which echo into the Discord platform that other services don't provide.
First things first, create a Discord application through the Discord developer portal
Now on the OAuth2 page you will need to add the following as a redirect and replace the domain with yours. This is used in our login callback to actually log the user in.
https://example.com/auth/discord/callback
Change example.com to represent your domain name.
Now, copy the Client ID and place it in the config file of FaxStore under the tokens section. Also copy the Client Secret from the Discord page into your FaxStore config.
oAuth2ClientId = Client ID
oAuth2ClientToken = Client Secret
Save file. Completed.
GitHub
Adding GitHub is actually a lot easier than you might think!
Simply start by navigating to your GitHub Developer Settings.
Once there, click on the "New OAuth App" button in the top right corner of the section.
Fill out the form so it might look something like this
https://example.com/auth/github/callback
Change example.com to represent your domain name.
Once done, copy the Client ID, and generate a new Client Secret, copy both of them.
Now edit the GitHub related tokens in the FaxStore config file.
Save, and completed.
This is likely the most difficult login method to set up. However, a major pro with this login method is that everyone has a Google account!
First off, head to the Google Developers Console.
Create a project using the button on the right hand side or via the Blue dropdown.
Create a project name and click create (usually a location isn't required). This might take up to a minute to create the application.
Once created click on Credentials on the left side bar, then click Create Credentials (using the OAuth client ID method) which is located at the top of the page.
You may be required to set up a 'consent screen', follow through the instructions for this. You will want an External consent screen.
Consent Screen
You will be asked for some details. When it asks you for scopes, you want to select the top two scopes (userinfo.email and userinfo.profile).
When you get back around to creating the OAuth client ID, set it as a Web application
Under Authorized redirect URIs add the below callback for our login to function.
https://example.com/auth/google/callback
Change example.com to represent your domain name.
Once, the client is created copy the Client ID and Client Secret and add it to the tokens section for the Google flows in the FaxStore config.
Related Articles
Review this page
faxstore setup
1 recommend this page