Configuring Google SSO Single Sign-On
Introduction
Set up Google integration to allow single sign-on (SSO) using Google email accounts.
Step 1: Create a Google Project
- Navigate to the Google Console and log in with your organization or personal account.
- Click on “CREATE PROJECT” and complete the project information.
- Project name - enter the project's name, e.g. pbx-integration.
- Location - select the correct organization (if applicable).
- Click “Create”.
Step 2: Setup OAuth Consent Screen App
Now set up the OAuth Consent Screen App in this project.
- Go to “APIs & services > OAuth consent screen”.
- Select the appropriate ‘User Type’ and click “CREATE”.
- Internal - In this mode, sign-on is limited to Google Workspace users within your organization.
- External - users can use Google Accounts external to your organization to log in to their client.
- Under ‘App information’, enter your app name (e.g PBX Integration) and use the drop-down box to select a user for the designated support email address.
- Scroll down to ‘Developer’ contact information and enter an email address.
- Click “Save and Continue”.
- On the next ‘Scopes’ screen, scroll down and click “Save and Continue”.
- On ‘Test users’, click “Save and Continue”. Click “Back to Dashboard”.
- If you selected the ‘User Type’ as ‘External’, click “PUBLISH APP” and “CONFIRM”
Step 3: Obtain Your 3CX URI
- Navigate to the 3CX Admin Console
- You must have either ‘System Administrator’, or ‘System Owner’. Read more about security roles.
- Navigate to “ Integrations > Google”.
- Copy the integration URI to a notepad.
Step 4: Complete Google URI Set Up
- Navigate back to the Google Console and select “Credentials”
- Click “+ Create Credentials” and select “OAuth client ID” from the list.
- Use the drop-down list for the ‘Application type’ and select “Web application”.
- Enter a name (e.g PBX Integration), scroll down to the ‘Authorized redirect URIs’ section, and click “+ ADD URI”
- Paste your previously copied 3CX URI and click “CREATE”.
- Copy your ‘Client ID’ and ‘Client Secret’ to a notepad and click “OK”.
Step 5: Finalize Your 3CX Configuration
- Navigate back to your 3CX Admin Console and paste your ‘Client ID’ and ‘Client Secret’ into the appropriate fields.
- Click Save.
- Google SSO will automatically be enabled for all users.
- If you want to disable it for certain users you can do so from the User > Options page.
See also
- Read more about setting up your team
- Configure SSO for Microsoft
Last Updated
This document was last updated 27 February 2024