Skip to main content

Custom Google SSO Integration

If you are using branded Ringotel Shell portal (under your own domain), you will need your own Google SSO integration because the default one will result with the Invalid redirect URL error.

Written by Alex Brainin

In order to create a custom Google SSO integration, you will firstly need to sign in to your Google Cloud Console (https://console.cloud.google.com) or create a new account if not yet created.

  1. Once you logged into your Google Cloud Console, navigate to "API & Services" > "OAuth consent screen" > "Branding".

Here, you firstly need to specify your OAuth consent screen branding, which is where users will be navigated to once they enable your custom integration in the admin portal or softphone app.

After that, specify your top-level domain in the Authorised domains field, which will then need to be verified by adding CNAME records to your domain's DNS provided in your Google Cloud Console.

Important:

Your custom Ringotel admin portal domain must match with the authorized domain or be its sub domain.

2. Once you complete the branding section and verify your authorised domains, navigate to the "Data Access" section and add the following scopes to your application:

Non-sensitive scopes:

  • ./auth/userinfo.email

  • ./auth/userinfo.profile

3. Navigate to the "Clients" menu to create a new OAuth 2.0 Client ID.

Click on + Create client and in the Application type select "Web application".

Then, provide a client ID name and in the Authorized redirect URIs specify your custom Ringotel admin portal URL with the following path "/services/<Ringotel Account ID>/GoogleSSO".

For example:

Tip:

You can find your Ringotel Account ID in your Ringotel admin portal > Menu > Account.

Click Create button to create a new client ID. Once created, you should see a pop-up with your Client ID and Client secret details:

4. Lastly, note these details and send them over to the Ringotel team so we can add your custom Google SSO integration to your integrations list.


​

Did this answer your question?