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. Click New > App Services > Web App.
3. In the Basics tab, enter a name for your web app and select a region.
4. Under Runtime stack, if required, select Windows and PHP > 7.4.
5. Click Next and then Create.

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 Configuration page for the AzureOAuthSMTP plugin.

alt text

1. Enter the Client ID, Client Secret, and Tenant ID values that you copied from Azure Portal.

alt text

1. 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. Save
4. Click Test to send a test email.

alt text

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.