TLS Version Report
These are step by step instructions to quickly and easily report the TLS Versions of a list of email addresses.
It is very important that you check for TLS on every email addresses that you send to.
The rule that "confidential information must be protected" makes you, the sender, responsible for the security of every email you send. And your emailer will send in "plain text" if a recipient doesn't do TLS. Don't believe us? Prove it here: .
Create a Batch
All email addresses to the same Domain (the part after the "@" in an email address) have the same security so you only need to list each Domain once. CheckTLS calls a list of email addresses a "Batch" and each unique Domain a "Target".
Batches are controlled by a Batch Input XML file, which can be complicated, so CheckTLS offers an Excel workbook to make the input easier. We encourage you to use the workbook as is for your first time through, then make changes and run it as often as you want. Common sources for your own Targets are your address book, a send log on an email server, an export from your CRM system, etc.
Create the Excel Workbook
Download this Excel workbook.
Enter your Targets (email address domains) one per row on the Targets tab of the Excel workbook. Our example uses:
Choose The Settings You Want To Extract
Fill in the Settings tab of the Excel workbook:
|BatchID||use "new" to create a batch, then put the batch number here when you want to update it|
|Description||type a description to remind you what the batch is|
|RunNow||use "Y" to run the batch right away, "N" to just save it for later|
|BatchTest-Attribute||leave this as "TestType="receiverquick""|
|Delivery-To||put your email address here (where you want the results sent)|
|Delivery-Format||leave this as "csv" (another option is "xml-detail")|
|Delivery-OnlyNode||list the "Node" names you want to extract (see below)|
|Target-Attribute||leave this as "SMTPTimeOut="30""|
Our example extracts the Target, score, and TLS Version (Nodes "eMailAddress", "ConfidenceQFactor", and "SSLVersion" respectively).
Here are the Settings from the example Excel workbook:
|Description||My First Extract Batch|
Upload the Excel Workbook
Browse to . Use the Excel File: choice to navagate to your saved Excel workbook. You can turn on Show XML if you want to see the underlying XML that your workbook creates. It is not necessary and can be confusing.
When you click the Update/Run button, your workbook is uploaded to our servers. It is checked for errors, and if all the Settings are good it creates (or updates) the Batch and optionally runs it:
Batch #1 Created | Batch #1 Queued (Estimated finish: 04-08 07:54)
Your results will be emailed to you in a few minutes. The entire Batch should take about 4 seconds per Target.
You can use the and/or buttons into monitor your Batch and see your results.
See the Results
If you put "csv" in the Delivery-Format row on the Settings tab, your results will look like:
"eMailAddress","ConfidenceQFactor","SSLVersion" "CheckTLS.com","121","TLSv1_3" "RefuseTLS.CheckTLS.com","0", "NoDNS.CheckTLS.com","50", "TLSv1.CheckTLS.com","71","TLSv1"
If you put "xml-detail" in the Delivery-Format row on the Settings tab, your results will look like:
<CheckTLS> <Results test="BatchTest_receiver" version="V03.19.02" format="xml-detail" id="1" description="My First Extract Batch"> <Result origin="www11-do.CheckTLS.com"> <eMailAddress>CheckTLS.com</eMailAddress> <ConfidenceQFactor>121</ConfidenceQFactor> <SSLVersion>TLSv1_3</SSLVersion> </Result> <Result origin="www11-do.CheckTLS.com"> <eMailAddress>RefuseTLS.CheckTLS.com</eMailAddress> <ConfidenceQFactor>0</ConfidenceQFactor> </Result> <Result origin="www11-do.CheckTLS.com"> <eMailAddress>NoDNS.CheckTLS.com</eMailAddress> <ConfidenceQFactor>50</ConfidenceQFactor> </Result> <Result origin="www11-do.CheckTLS.com"> <eMailAddress>TLSv1.CheckTLS.com</eMailAddress> <ConfidenceQFactor>71</ConfidenceQFactor> <SSLVersion>TLSv1</SSLVersion> </Result> </Results> </CheckTLS>