Difference between revisions of "Client Email Verification"

From WHMCS Documentation

(Default Behaviour)
 
(12 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Email Verification is a feature available to validate and ensure that the email address a client registers with is valid and their own.
+
'''Email Verification''' checks to ensure that the email address a client registers with is valid and their own. When a user or admin creates a new client account or changes a client's email address, the system sends an email asking the user to confirm that they intended to register or make the change to the email address.
  
When enabled, upon creation of a new client account or change of email address, an email is sent to the email address provided asking the user to confirm that they intended to register or make the change of email address.
+
This helps protect against signups using incorrectly-typed and unauthorized email addresses. It can also act as part of order review and fraud screening procedures.
 
 
The validation link they receive is valid for 24 hours.  Should it expire, the client can request a new verification email be sent by logging into the client area.
 
 
 
==Why enable it?==
 
 
 
Enabling Email Verification adds an additional layer of protection against signing up using incorrectly typed and unauthorized email addresses, and can also be used as part of order review and fraud screening procedures.
 
  
 
==Enabling Email Verification==
 
==Enabling Email Verification==
  
To enable email verification, navigate to ''Setup >> General Settings >> Security tab''. Tick the '''Email Verification''' checkbox and save the changes.  
+
You can enable email verification in the '''[[Security Tab|Security]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''.
  
[[File:Enable_email_verification.png|center|850x250px|Enable email verification in general settings]]
+
<div class="docs-alert-info">
 
+
Enabling '''Email Verification''' will not send an email verification request to any existing users automatically. Their accounts will display as unverified and continue to operate unaffected.
<div class="docs-alert-info">Enabling Email Verification will not send an email verification request to any existing clients automatically. Their accounts will simply show as unverified and continue to operate unaffected.</div>
+
</div>
  
 
==Default Behaviour==
 
==Default Behaviour==
  
When enabled, the client will be sent an email verification notice when the following events occur:
+
WHMCS sends email verification notices when the following events occur:
 
 
* A new user registration
 
* Change of email address for an existing account
 
 
 
Clients access is not restricted to the client area, services or support resources prior to email verification being completed. This is to allow the client to access the services they have paid for and your support resources.
 
 
 
Upon the client following the link sent in the verification email, the client will be required to log into the client area to complete the verification process.  Once successfully authenticated, a success confirmation message will be displayed on the next page.
 
 
 
[[File:Verified_banner.png|850x250px|Verified email successfully]]
 
 
 
In the admin area, the email verification banner will no longer be present and a Verified badge will display alongside the client's email address.
 
 
 
[[File:Verified_client_profile.png|850x250px|Verified email in client profile view]]
 
 
 
==Resending the Verification Email==
 
 
 
If a client has not verified their email address, they will see the option to resend the verification email in the banner notice displayed within the client area.  Admins also have this ability from the admin client summary page.
 
 
 
Clicking the '''Resend Verification Email''' button sends an email with a link that is valid for 24 hours.  If the link is followed after the 24 hour window or if the button is clicked again (which invalidates the previous link) then an error will be displayed upon attempting to verify using an older link.  Again however, the user will have the option to request a new email verification.
 
  
==Client Area User Interface==
+
* A new user completes registration.
 +
* An existing user's email address changes.
  
When enabled, any client who has not completed the email verification process will be prompted with a banner reminding them to take action when they login.  This banner is displayed on all pages of the client area.
+
<div class="docs-alert-info">
 +
To help reduce the number of emails new clients are sent after signing up, the client will not receive the separate ''Welcome'' email when '''Email Verification''' is enabled.
 +
</div>
  
No functionality is limited in the client area for clients with an unverified email address.
+
User access is not restricted to the client area, services, or support resources prior to email verification completion. This is to allow the user to access the services and support resources they have paid for.
  
[[File:Client_verification_banner.png|center|850x250px|Email verification banner on client side]]
+
After the user follows the link in the verification email, the user must log in to the client area to complete the verification process. Once they successfully authenticate, a success message will display on the next page.
  
==Admin Area User Interface==
+
In the admin area, the email verification banner will no longer display.
  
When enabled, any client who has not completed the email verification process will have a banner shown at the top of their client summary page and when viewing orders submitted by them (pictured below).
+
==The Validation Link==
  
[[File:Client_profile_verification_banner.png|400x150px|Client profile verification banner]]
+
The validation link in each verification email is valid for 60 minutes for WHMCS 8.0 and higher or, prior to WHMCS 8.0, 24 hours. If the link expires, the user can request a new verification email by logging in to the Client Area.
[[File:Manage_orders_verification_banner.png|400x150px|Manage orders client verification status]]
 
  
An option to resend the verification email is also available from both pages.  Be aware that clicking this will invalidate any previous verification links.
+
Users who have not verified their email address will see the option to resend the verification email in the banner notice in the Client Area.  
  
A badge will also display alongside the client's email address throughout the admin backend denoting whether the client's email address is verified or not.
+
Admins can view the client's email verification status from the '''[[Clients:Summary Tab|Summary]]''' tab in the client's profile and a banner will also display when viewing orders from that account. A badge will also display alongside the user's email address, denoting whether the email address is verified.
  
[[File:Unverified_badge.png|right|400x250px|Unverified email badge]]
+
Clicking '''Resend Verification Email''' sends an email with a new link in a new verification email.
[[File:Verified_badge.png|400x250px|Verified email badge]]
 

Latest revision as of 19:10, 19 April 2022

Email Verification checks to ensure that the email address a client registers with is valid and their own. When a user or admin creates a new client account or changes a client's email address, the system sends an email asking the user to confirm that they intended to register or make the change to the email address.

This helps protect against signups using incorrectly-typed and unauthorized email addresses. It can also act as part of order review and fraud screening procedures.

Enabling Email Verification

You can enable email verification in the Security tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.

Enabling Email Verification will not send an email verification request to any existing users automatically. Their accounts will display as unverified and continue to operate unaffected.

Default Behaviour

WHMCS sends email verification notices when the following events occur:

  • A new user completes registration.
  • An existing user's email address changes.

To help reduce the number of emails new clients are sent after signing up, the client will not receive the separate Welcome email when Email Verification is enabled.

User access is not restricted to the client area, services, or support resources prior to email verification completion. This is to allow the user to access the services and support resources they have paid for.

After the user follows the link in the verification email, the user must log in to the client area to complete the verification process. Once they successfully authenticate, a success message will display on the next page.

In the admin area, the email verification banner will no longer display.

The Validation Link

The validation link in each verification email is valid for 60 minutes for WHMCS 8.0 and higher or, prior to WHMCS 8.0, 24 hours. If the link expires, the user can request a new verification email by logging in to the Client Area.

Users who have not verified their email address will see the option to resend the verification email in the banner notice in the Client Area.

Admins can view the client's email verification status from the Summary tab in the client's profile and a banner will also display when viewing orders from that account. A badge will also display alongside the user's email address, denoting whether the email address is verified.

Clicking Resend Verification Email sends an email with a new link in a new verification email.