Configuring Mail Server

You can configure Remote Access Plus server to automatically notify you via e-mails on various important events. Follow the below steps to configure your third-party mail service such as Google Apps to send you e-mail notifications. Mail Server Settings can be configured in two ways:

• OAuth Authentication
• Basic Authentication

OAuth Authentication

OAuth is a standard authorization protocol that uses web tokens instead of passwords to allow delegated access to a protected resource. OAuth allows limited access to the users data, that is, the ability to share data for users without disclosing personal information. Therefore, we can choose to configure using OAuth authentication for sending mails from Remote Access Plus server securely.

How to Configure OAuth Authentication for Mail server?

To configure OAuth Authentication,

1. Navigate to Admin tab->Mail Server Settings.
2. Choose OAuth under authentication type.
3. Specify the name and port of the mail server.
4. Provide the name of the sender, along with the sender's mail address and a test mail address.
5. Choose the email type. (Note: SMTPS is recommended since the connection to the mail server is encrypted.)
6. Enable TLS if required.
7. Obtain Client ID, Client Secret, Authorize URL, Access Token URL and Scope from the authorization server using the Redirect URL.
8. You may choose to connect to the authorization server using a proxy if required.
9. Click Save. The user consent window of the mail server pops up.
10. Enter your login credentials and consent to the permissions requested.
11. You have configured OAuth authentication for mail server successfully.

Basic Authentication

To configure Basic Authentication, open Remote Access Plus server navigate to Admin tab -> Mail Server Settings and specify the following information:

1. Server Name : smtp.gmail.com
2. Port : 465 (SSL) / 587 (TLS)
3. Sender Name: The name in which you want to send the mail
4. Sender Email Address: Your e-mail address
5. Test Email Address: e-mail address to receive test mails.
6. Email Type: SMTP / SMTPS
7. Enable TLS: Yes / No. If you choose No, then SSL will be set as default.
8. You need to enable authentication for configuring the Gmail account.
9. Username: Specify your email address.
10. Password: Specify your password.

Frequently Asked Questions

Why should I move to OAuth2.0?

Google and Microsoft will soon withdraw basic authentication support for mail servers by 30 May 2022 and 1 October 2022, respectively. Therefore, it is advisable for users to switch to OAuth authentication.

What are the supported mail servers in OAuth?

We have tested OAuth authentication with Microsoft Outlook(office365) and Gmail(Gsuite).

Can I configure OAuth for an existing mail account?

Yes. You can configure OAuth for an existing account.

What is Redirect URL and where should I configure it?

Redirect URL or Reply URL is the URL to which the Authorization Server sends confidential response data. Copy-paste the Redirect URL to the application details in the Authorization Server and save it.

On clicking Save, I am getting an error stating "Redirect URL or reply URL invalid/mismatch". What should I do?

Check if you have added the application server's redirect URL to your authorization server's list of redirect URLs. Ensure that you have saved the settings.

What will happen if my access token expires?

When your access token gets expired, a new access token will be automatically generated using the refresh token.