Customer Portal Deployment
The QLM Customer Portal requires user authentication to allow access to manage license keys. A user who logs in to the QLM Customer Portal can manage license keys associated with his/her email address.
Additionally, if a user is the primary or secondary contact of an organization, this user can manage all license keys associated with the organization.
Before enabling the QLM Customer Portal and providing your customers access to it, it is highly recommended to review the security measures listed in this article to ensure that customers are not given access to license keys that do not belong to them.
There are 2 steps required to set up the QLM Customer Portal:
Authentication Configuration
Deployment of the QLM Customer Portal
Authentication Configuration
The QLM Customer Portal can authenticate users in 4 different ways:
QLM User Authentication
Google Authentication
Facebook Authentication
Microsoft Azure Authentication
QLM User Authentication
To allow users to log in to the QLM Customer Portal, create a user as follows:
Launch the QLM Management Console
Go to the Manage Keys tab
In the ribbon bar Portal section, click User Accounts
Click Add and enter the user's information then click Ok
In the User Type drop-down, select Customer.
Google Authentication
To configure Google Authentication, you must acquire a Google Client ID from the Google API Console
In the Google API Console
Click Credentials
Create a Project or pick an existing project
Click Create Credentials and select OAuth Client ID
Set the Application Type to Web application
Set the Name to "QLM Customer Portal" or any name of your choice
Set Authorized JavaScript origins to the domain when the QLM Customer Portal is hosted. Example: https://qlm3.net
Set the Authorized redirect URIs to the same value as above
Take note of the generated Client ID.
Facebook Authentication
To configure Facebook Authentication, you must acquire a Facebook App ID from the Facebook Developers page.
Log in to the Facebook for Developers site
Click My Apps
Click Create App
Select "For Everything Else"
Set the App Display Name to "QLM Customer Portal" or any name of your choice
Set the other options as required and click Create App ID
In the Add a Product section, click Setup in the Facebook Login panel
When prompted for a platform, select "Web"
Set the Site URL to the URL to the domain when the QLM Customer Portal is hosted. Example: https://qlm3.net
Click Continue then click Next a few times until
Once the App is created, click Settings / Basic
Take note of the generated App ID.
Azure Authentication
To configure Azure Authentication, you must acquire an Azure App Client ID from the Azure Portal.
Log in to the Azure Portal
Click App Registrations
Create New Registration
Set the Name to "QLM Customer Portal" or any name of your choice
Set account types to: Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)
Set Redirect URI to "Web and enter the domain when the QLM Customer Portal is hosted. Example: https://qlm3.net
Click Register
In the Overview tab, take note of the generated Application Client ID.
Deployment of the QLM Customer Portal
The QLM Customer Portal can be deployed in 3 different ways:
Using the QLM License Server Installer
By manually deploying it
Azure App Service Deployment
QLM License Server Installer
When you use the QLM License Server installer, the QLM Customer Portal is automatically deployed to the system when the License Server is deployed in a folder called QlmCustomerPortal.
Authentication Configuration
With a text editor, open the QlmCustomerPortal/qlm-portal-app/assets/appsettings.json file:
Set the googleLoginKey field to the ClientID acquired above.
Set the facebookLoginKey field to the App ID acquired above.
Set the azureAuth / clientId field to the ClientID acquired above.
Set the resetPasswordUrl to the QlmCustomerSite reset password page.
Set the updatePasswordUrl to the QlmCustomerSite udpate password page.
Save the file.
Example:
API Endpoint Configuration
With a text editor, open the QlmCustomerPortal/qlm-portal-app/assets/appsettings.json file:
Set the apiEndpoint to the URL of the QLM Customer Portal API site and append /api to the URL. Example: https://quicklicensemanager.com/qlm/qlmcustomerportal/qlm-portal-api/api
Additional Configuration
With a text editor, open the QlmCustomerPortal/qlm-portal-app/index.html file:
Set the <base> tag to the path of the customer portal app (excluding the domain)
Example: <base>/qlm/qlmcustomerportal/qlm-portal-app/</base>
Manual Installation
Instructions for manually deploying the QLM License Server components, including the QLM Customer Portal, can be found here.
Azure App Service Installation
Instructions for deploying the QLM License Server components, including the QLM Customer Portal, can be found here.
Last updated