OAuth2 Guide

OAuth Authentication allows Agents/Users the ability to use Single Sign-on to log into the helpdesk through the provider you set up. The most commonly used providers are Microsoft and Google.

Authentication

OAuth Authentication allows Agents/Users the ability to use Single Sign-on to log into the helpdesk through the provider you set up. The most commonly used providers are Microsoft and Google.

Guides:

Microsoft Authentication (SSO) Guide

Google Authentication (SSO) Guide

Authorization

OAuth2 Authorization allows emails the ability to authenticate against a mail server using the OAuth2 protocol. This eliminates the need to store the password locally and instead redirects you directly to the provider to login. Most provider’s are phasing out Basic Authentication (username + password) for Modern Authentication (OAuth2) but if you host your own mailserver you may not have OAuth2 available. The most commonly used providers are Microsoft and Google.

Guides:

Microsoft Authorization Guide

Google Authorization Guide

Setting Up The Plugin

First you will need to download the plugin from our website. Make sure you have selected v1.17 or higher and select the ‘Authentication :: Oauth2’ plugin. Once the file is downloaded, copy the plugin file into the include/plugins folder and add the plugin:

Admin Panel | Manage | Plugins

Add Plugin


Install Plugin


Installed


Change the Status from ‘Disabled’ to ‘Active’ and click ‘Save Changes’

oauth10_plugin_active


Go to the Instances tab and click ‘Add New Instance’ to see the options for which OAuth provider you want to set up.

oauth11_add_instance