AzureOAuthSMTP Plugin

Tutorial: How to use the AzureOAuthSMTP plugin for LimeSurvey

Prerequisites

• Access LimeSurvey over HTTPS.

Instructions

Set up the OAuth 2.0 Web Application in Azure Portal.

1. Go to the Azure Portal and sign in.
2. Under Azure Services, click on App Registrations
3. Click New Registration.
4. Enter a name for your web app and select Who will have access to the Application.
5. Click Register.

Once your web app is created, go to the Authentication tab.

1. Click Add a provider and select Azure Active Directory.
2. Click Create and then Create a new tenant.
3. Follow the instructions to create a new tenant and Azure Active Directory application.
4. Once you have created the application, copy the Client ID and Client Secret values.

Activate the AzureOAuthSMTP plugin in LimeSurvey.

1. Go to the Plugins page in LimeSurvey.
2. Find the AzureOAuthSMTP plugin and click Activate.

Configure the AzureOAuthSMTP plugin in LimeSurvey.

1. Go to the Settings page for the AzureOAuthSMTP plugin.
2. Please notice the Help section on the top.
3. Enter the Client ID, Client Secret, and Tenant ID values that you copied from Azure Portal.
4. Notice the Tenant ID usually shall be set to consumers, still that depends on the Azure Application.
5. Click Save.

Get a new OAuth token.

1. At plugin's overview page, click the Get new token link to open Azure's consent screen in a new window.
2. Follow the steps in the consent screen and check the requested permissions.
3. Once you have granted permission, you will be redirected back to LimeSurvey.

Test the AzureOAuthSMTP plugin.

1. Go to Global Settings
2. In the Email settings, select Plugin as the Email Method.
3. Scroll down and select the the Plugin that will be used for sending emails.
4. Save
5. Click Test to send a test email.

Additional notes

• If you are using a self-hosted version of LimeSurvey, you will need to configure your web server to allow HTTPS traffic.
• If you are using a cloud-hosted version of LimeSurvey, such as Limesurvey Cloud, you will not need to configure HTTPS traffic.