Google G Suite, OAuth, & Less Secure Apps
UPDATE:
June 15th, 2020 has come and gone. This means that if you wish to use Gmail or Google G Suite to send email from your Joomla! website you must do so using an "Application Specific Password". Keep reading to learn how to do this.
Most likely, if you are reading this, it is because you use G Suite for your domain email and you received an email from Google stating that they "will be turning off access to less secure apps (LSA)" in 2 stages. The first stage will be June 15th, 2020 so users who try to connect to an LSA for the first time will not be able to. The email also said "Starting February 15, 2021, G Suite accounts will only allow access to apps using OAuth. Password-based access will no longer be supported". Now, you're probably left wondering if your Joomla website will still be able to send mail through your G Suite account because there is no interface in Joomla's Global Configuration for OAuth.
You're not alone. The wording of the email G Suite sent has left many people confused, particularly due to the fact that it says it will "only allow access to apps using OAuth" and that "Password-based access will no longer be supported". What they do not mention in the email is that an App Password uses a sub-protocol of OAuth. So even though an Application Specific Password is a password, and they say "password-based access will no longer be supported", sending mail from your Joomla website via G Suite with an App Password will work.
The solution is to create an App Password. The ability to create an App Password is only available if you turn on Two-Step Verification (2-SV), also know as two-factor authentication (2FA). It is important to note that once you have enabled 2-SV, it will automatically turn off access to Less Secure Apps which means the contact form will fail to send messages. This means that before you enable 2-SV in your G Suite account you need to be ready to enter the App Password in "Global Configuration > Server > Mail Settings > SMTP Password". Failure to do so will cause the contact form to stop working.
When enabling 2-SV you have the option to receive prompts on your smartphone as well as receive 2-SV codes via text message. However, you can also use an "Authenticator App". We recommend using the Authy App over Google Authenticator. You can read our knowledge base article covering this topic called Two-Factor Authentication for more information.
If you need to know how to setup Google G Suite as your mail server for Joomla! you can follow the instructions outlined in the Joomla! documentation linked below. The link describes how to use Gmail as your mail server but the instructions work for G Suite as well.
How to use Gmail as your mail server
For reference, we have included the email from Google's G Suite department. Click the slider below to read the original email.
{slider title="Email from Google regarding Less Secure Apps" open="false"}
Dear Administrator,
We’re constantly working to improve the security of your organization’s Google accounts. As part of this effort, and in consideration of the current threat landscape, we’ll be turning off access to less secure apps (LSA) — non-Google apps that can access your Google account with only a username and password, without requiring any additional verification steps. Access through only a username and password makes your account more vulnerable to hijacking attempts. Moving forward, only apps that support a more modern and secure access method called OAuth will be able to access your G Suite account.
Access to LSAs will be turned off in two stages:
- June 15, 2020 - Users who try to connect to an LSA for the first time will no longer be able to do so. This includes third-party apps that allow password-only access to Google calendars, contacts, and email via protocols such as CalDAV, CardDAV and IMAP. Users who have connected to LSAs prior to this date will be able to continue using them until usage of all LSAs is turned off.
- February 15, 2021 - Access to LSAs will be turned off for all G Suite accounts.
What do I need to do?
To continue using a specific app with your G Suite accounts, users in your organization must switch to a more secure type of access called OAuth. This connection method allows apps to access accounts with a digital key instead of requiring a user to reveal their username and password. We recommend that you share the user instructions (included below) with individuals in your organization to help them make the necessary changes. Alternatively, if your organization is using custom tools, you can ask the developer of the tool to update it to use OAuth. Developer instructions are also included below.
MDM configuration
If your organization uses a mobile device management (MDM) provider to configure CalDAV, CardDAV, and Exchange ActiveSync (Google Sync) profiles, these services will be phased out according to the timeline below:
- June 15, 2020 - MDM push of IMAP, CalDAV, CardDAV, and Exchange ActiveSync (Google Sync) will no longer work for new users.
- February 15, 2021 - MDM push of IMAP, CalDAV, CardDAV, and Exchange ActiveSync (Google Sync) will no longer work for existing users. Admins will need to push a Google Account using their MDM provider, which will re-add their Google accounts to iOS devices using OAuth.
Other less secure apps
- For any other LSA, ask the developer of the app you are using to start supporting OAuth.
- If you use other apps on iOS or MacOS that access your G Suite account information through only a password, most access issues can be resolved by removing then re-adding your account. When you add it back, make sure to select Google as the account type to automatically use OAuth.
Scanners and other devices
No change is required for scanners or other devices using simple mail transfer protocol (SMTP) or LSAs to send emails. If you replace your device, look for one that sends email using OAuth.
User instructions
If you are using an app that accesses your Google account with only a username and password, take one of the following actions to switch to a more secure method and continue to access your email, calendar, or contacts. If you do not take one of the following actions, when LSA access is discontinued after February 15, 2021, you will begin receiving an error message that your username-password combination is incorrect.
- If you are using stand-alone Outlook 2016 or earlier, move to Office 365 (a web-based version of Outlook) or Outlook 2019, both of which support OAuth access. Alternatively you can use G Suite Sync for Microsoft Outlook.
- If you are using Thunderbird or another email client, re-add your Google Account and configure it to use IMAP with OAuth.
- If you are using the mail app on iOS or MacOS, or Outlook for Mac, and use only a password to login, you’ll need to remove and re-add your account. When you add it back, select “sign in with Google” to automatically use OAuth.
| Mac OS | iOS |
|
|
Calendar
- If you use CalDAV to give an app or device access to your calendar, switch to a method that supports OAuth. We recommend the Google Calendar app [Web/iOS/Android] as the most secure app to use with your G Suite account.
- If your G Suite account is linked to the calendar app in iOS or MacOS and uses only a password to login, you’ll need to remove and re-add your account to your device. When you add it back, select “sign in with Google” to automatically use OAuth. Read more
Contacts
- If your G Suite account is syncing contacts to iOS or MacOS via CardDAV and uses only a password to login, you’ll need to remove your account. When you add it back, select “sign in with Google” to automatically use OAuth. Read More
- If your G Suite account is syncing contacts to any other platform or app via CardDAV and uses only a password to login, switch to a method that supports OAuth.
Note: If the app you are using does not support OAuth, you will need to switch to an app that offers OAuth, or ask your admin to contact the supplier of your app and request that they add OAuth as a way of connecting your Google account.
Developer instructions
To maintain compatibility with G Suite accounts, update your app to use OAuth 2.0 as a connection method. To get started, follow our developer guide on using OAuth 2.0 to access Google APIs. You can also refer to our guide on OAuth 2.0 for mobile & desktop apps.
How can I get help?
If you have additional questions or need assistance, please contact G Suite support. When you call or submit your support case, reference your issue number.
Thanks for choosing G Suite.
—The G Suite Team
© 2019 Google LLC 1600 Amphitheatre Parkway, Mountain View, CA 94043
{/sliders}