AzureOAuthSMTP Plugin: Difference between revisions
From LimeSurvey Manual
Gabrieljenik (talk | contribs) No edit summary |
Gabrieljenik (talk | contribs) No edit summary |
||
Line 28: | Line 28: | ||
==== Configure the AzureOAuthSMTP plugin in LimeSurvey. ==== | ==== Configure the AzureOAuthSMTP plugin in LimeSurvey. ==== | ||
# Go to the '' | # Go to the ''Settings'' page for the AzureOAuthSMTP plugin. | ||
# Please notice the ''Help'' section on the top. | |||
# Enter the ''Client ID'', ''Client Secret'', and ''Tenant ID'' values that you copied from Azure Portal. | # Enter the ''Client ID'', ''Client Secret'', and ''Tenant ID'' values that you copied from Azure Portal. | ||
# Notice the ''Tenant ID'' usually shall be set to ''consumers'', still that depends on the Azure Application. | |||
# Click ''Save''. | # Click ''Save''. | ||
Line 45: | Line 47: | ||
# Go to Global Settings | # Go to Global Settings | ||
# In the ''Email'' settings, select ''Plugin'' as the ''Email Method''. | # In the ''Email'' settings, select ''Plugin'' as the ''Email Method''. | ||
# Scroll down and select the the ''Plugin'' that will be used for sending emails. | |||
# Save | # Save | ||
# Click ''Test'' to send a test email. | # Click ''Test'' to send a test email. |
Revision as of 15:40, 23 November 2023
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.
- Go to the Azure Portal and sign in.
- Click New > App Services > Web App.
- In the Basics tab, enter a name for your web app and select a region.
- Click Next and then Create.
Once your web app is created, go to the Authentication tab.
- Click Add a provider and select Azure Active Directory.
- Click Create and then Create a new tenant.
- Follow the instructions to create a new tenant and Azure Active Directory application.
- Once you have created the application, copy the Client ID and Client Secret values.
Activate the AzureOAuthSMTP plugin in LimeSurvey.
- Go to the Plugins page in LimeSurvey.
- Find the AzureOAuthSMTP plugin and click Activate.
Configure the AzureOAuthSMTP plugin in LimeSurvey.
- Go to the Settings page for the AzureOAuthSMTP plugin.
- Please notice the Help section on the top.
- Enter the Client ID, Client Secret, and Tenant ID values that you copied from Azure Portal.
- Notice the Tenant ID usually shall be set to consumers, still that depends on the Azure Application.
- Click Save.
Get a new OAuth token.
- At plugin's overview page, click the Get new token link to open Azure's consent screen in a new window.
- Follow the steps in the consent screen and check the requested permissions.
- Once you have granted permission, you will be redirected back to LimeSurvey.
Test the AzureOAuthSMTP plugin.
- Go to Global Settings
- In the Email settings, select Plugin as the Email Method.
- Scroll down and select the the Plugin that will be used for sending emails.
- Save
- 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.