Articles in this section
Creating App-specific Password for Gmail Outgoing Server
Table of Contents
Introduction
When you configure Gmail as the email outgoing server for Vtiger CRM, you may encounter an SMTP connection failure error in the CRM’s Email Settings page.
To avoid this error, you need to create an app-specific password for your Gmail account.
In this article, you will learn about configuring a two-step verification (authorization) process that includes creating app-specific passwords for Gmail.
Creating App-Specific Passwords
This process consists of the following two steps:
- Step 1: Set up Gmail as an outgoing server
- Step 2: Create an app-specific password for Gmail
Follow these steps to set up Gmail as an outgoing server and create an app-specific password:
Step 1: Setting up Gmail as an outgoing server
- Log in to the CRM.
- Go to the Email Settings page in Vtiger CRM.
- Select the Server Type as Gmail under Mail Server Settings (SMTP).
- Click the Create App-Specific password option to create an app-specific password to configure Gmail as the email outgoing server for Vtiger CRM.
Step 2: Create an app-specific password
Using app-specific passwords is a more secure method of enabling Gmail as the out-going server. To create an app-specific password, you will have to enable the Gmail 2-step verification process first.
Step 2a: Enabling 2-Step Verification
Follow these steps to enable the 2-step verification for your Gmail account:
- Login to your Gmail account.
- Click the Profile icon.
- Click Manage your Google Account.
- Select Security on the left-hand side of the screen. You will be directed to the Gmail Security page.
- Look for Signing into Google.
- Click 2-Step Verification. You will be directed to the 2-step Verification process.
- Click Get Started. The Gmail verification screen appears.
- Enter your Gmail password.
- Click Next.
- Under Let’s set up your phone, enter your phone number.
- Choose the method you want to get the code: Text message or Phone call.
- Click Next.
- Enter the verification code that you have received on your given phone number (or email).
- Click Next.
- Click Turn On.
The 2-Step Verification field will now show as enabled on the Security page on your Gmail.
Step 2b: Create an app-specific password
Note: Once the 2-Step Verification field for your Gmail Account is enabled, the App passwords field will appear under Security settings on your Gmail.
Follow these steps to create an app-specific password for your Gmail account.
- Login to your Gmail account.
- Click the Profile icon.
- Click Manage your Google Account.
- Select Security on the left-hand side of the screen. You will be directed to the Gmail Security page.
- Look for Signing into Google.
- Click App passwords. The Gmail verification screen appears.
- Enter your Gmail password.
Or
- Go to Mail Server Settings (SMTP).
- Click Create App-Specific password. The Gmail login screen appears.
- Login to your Gmail account.
- You will be directed to the App passwords screen.
- Select the app and device you want to generate the app password for.
- The Generate app password window opens, where the app password is generated.
- Copy the app password that is generated.
- Click Done.
- Go back to Mail Server Settings (SMTP) on the Email Settings page in the CRM.
- Paste the generated app password in the Password field.
You have now successfully created an app-specific password for your Gmail account. You will now be able to successfully select Server Type as Gmail and configure it as the email outgoing server for Vtiger CRM.
Note: The Create App-Specific password method is recommended to be chosen when you have specific domains or websites to be configured.