Type: Boolean
Returns True if the visitor’s browser has SSL enabled and the visitor’s connection is allowing traffic over HTTPS port 443. If either of these conditions is not met, SSLEnabled returns True.
You can use the SSLEnabled property to detect if visitors have disabled their SSL support in the browser (such as unchecking the "Use SSL 2.0 / 3.0" options in the IE Advanced Security settings). This helps you ensure that the user can communicate successfully over HTTPS connections, before they try accessing secure content.
Tip: As mentioned above, if SSLEnabled returns False it can be because the user has disabled SSL in the browser, the visitor’s firewall does not allow traffic over the HTTPS port, or a combination of both of these conditions. If you wish to tell these conditions apart, use the OpenPorts property to check to see if port 443 is open. If it is, and SSLEnabled still returns False, then you know it is because they have disabled SSL in the browser.
Note: You must call the GetExtPropertiesEx method before checking the value of this property. This property requires the Enterprise Edition of BrowserHawk.
Example:
<% set bhObj = Server.CreateObject("cyScape.browserObj")
bhObj.SetExtProperties "SSLEnabled"
bhObj.GetExtPropertiesEx
%>
<html> SSL is enabled in the browser, and browser allowing SSL connections?
<% = bhObj.SSLEnabled %>
</html>
Special notes for this property:
The user must have images enabled for this check to work properly; otherwise the return value will be false regardless of the real setting for this property. You can also check the ImagesEnabled property if you wish to account for that situation.
This test relies on a properly configured Port Check Server.
Checking this property will result in a delay of approximately 3 seconds in the event that the visitor’s HTTPS port is blocked (and in which case the return value will be True). You can change this timeout using the ExtPropFWTimeout property.
It is redundant to check both port 443 using the OpenPorts property and SSLEnabled, unless you want to be able to determine why SSLEnabled returns a result of False.
When testing for this property, users with Opera 5 may receive a warning message in the browser prior to the test executing. Likewise if the visitor’s browser is set to warn before making SSL connections, a warning message may be displayed prior to the test executing – this applies to all browsers.
While testing this feature of BrowserHawk you may toggle between disabling and enabling security protocols (SSL/TLS, etc). Note that with most Netscape and Opera browsers you must close and restart the browser before this change in your settings takes effect.
If the user’s JavaScript is disabled this property will not be available.
See Also: