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)

Open

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

Open

• 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:

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:

• 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

• Make sure that services are up by running the command:

pm2 list

The Google SSO is ready to be used!