What it’s about

Single sign-on (SSO) is an access management function that enables users to log in with a single set of identity credentials to multiple accounts, software, systems, and resources.

XCALLY gives its users the possibility to access XCALLY using Google credentials (gmail and password).
For agents, SSO feature is available only for WebRTC Agents (and not for Phonebar Agents)

How to set up

XCALLY Configuration

Please check in the General Settings the Single Sign-On property has been turned on:

From General Setting Menu, access the SSO section
Enable Google SSO

In order to make the Google SSO work, XCALLY users (agents, users, admin) must login to Google with the same GMAIL configured in the XCALLY Staff Settings.

If they are already logged into the Chrome browser, they need just to click on the red button.

Google Configuration

Access to the Google Developers Console (https://console.developers.google.com) with Google credentials

Create a new Google API Console project

From the Navigation Menu, choose IAM & Admin and select Create a Project

Fill the required fields and click on Create

Generate Credentials

Select the specific Project you want to generate the credentials for, in the Google Cloud top bar
From the Navigation Menu, choose APIs & Services and select Credentials

Remember to configure the OAuth consent screen with information about your application.

Click on Create Credentials

Select OAuth client ID

Choose Web Application as app type

Enter the Redirect URI related to your Motion server: https://{{MOTION_IP}}/api/auth/google/callback

Click on Add URI and Create
Google will generate the credentials:

Save these values:

CLIENT ID
CLIENT SECRET
REDIRECT URI

Server Configuration

Access the SSH Console
Run the following commands:

su motion

cd /var/opt/motion2

nano .env

Uncomment (remove the # ) the Google-related rows:

Insert the required values with those generated in the Google Configuration:

GOOGLE ID='CLIENT ID'

GOOGLE SECRET= 'CLIENT SECRET'

DOMAIN: 'REDIRECT URI'

Press CRTL+X
Press Y to save changes
Press Enter

Re-initialize the Xcally Motion V3 application for the variables changes to take effect, using the following commands:

npm run initialize

Remember that this command restart Motion Services!

Make sure that services are up by running the command:

pm2 list

The Google SSO is ready to be used!