Admin Guide

Google+ setup


If you want to enable users/agents to log in with their Google account credentials, you should use the Deskpro Google+ Sign-In app.

Note

Google Authentication is an older app which relies on an old system which Google has now withdrawn. If you are still using this app on your helpdesk, you should switch over to Google+ Sign-In as soon as possible.

Warning

Deskpro On-Premise users: before installing Google+ Sign-In, you must update your helpdesk to the latest version to avoid a possible issue which will prevent users from logging in.

To configure Google+ Sign-In:

  1. In Deskpro, go to Admin > Agents > Auth & SSO or CRM > Auth & SSO, depending on whether you want Google+ sign-in for agents or users.

  2. Click on the Google+ Sign-In app.

  3. Log in to a Google account and go to the Google Developers Console athttps://console.developers.google.com

  4. Click Create Project and enter a name and ID.

    ../_images/acme-dp-auth.png

    This project will only be used to obtain OAuth 2.0 credentials.

  5. Follow Google’s instructions for Setting up OAuth 2.0, including customizing the user consent screen.

    • You don’t need to enable any APIs.
    • Select the Web application type.
    • Set Authorized Javascript origins to the URL of your helpdesk.
    • Leave Redirect URI as the example value for now.../_images/google-create-client-id.png
  6. In Deskpro, enter the Client ID and Client Secret from step 3.

  7. Set the Google Apps domain if the Google account you are using is a Google Apps account, and you only want to allow login from Google Apps accounts on the same domain.

    Warning

    If you install Google+ authentication for agents, and don’t set a Google Apps domain, anyone with a Google account will be able to log in to your helpdesk as an agent.

  8. (Agent authentication only) Set the Auto agent option. This controls which permissions are granted to agents who log in through OneLogin and don’t have an existing Deskpro account.

  9. (User authentication only) Set the Grant usergroup option. This controls the usergroup granted to users who log in through OneLogin and don’t have an existing DeskPRO account.

  10. Click Install app.

  11. Deskpro will show you the redirect URI to enter into the project you created. Go back to the Developers Console, and under the APIs & auth section, select the Credentials and then Edit settings to enter the correct redirect URI.

  12. Click Save and Google authentication is now enabled.

If you want to enable Google+ login for both users and agents, install the Google+ app again in CRM/Agents.

Comments (0)

Add a comment

Add a comment

You need to log in before you can submit a comment.

Need a password reminder?