The Google Auth security module requires a specific set of system components to operate as intended. These include PHP 5.6 or higher, WHMCS version 7.x, OpenSSL or equivalent with TLS 1.1 and above, ionCube Loader version 10.1.x or higher, and the cURL extension compiled with TLS 1.1+ support. The module has been tested exclusively in these environments by our developers. Your setup must also meet all standard WHMCS system requirements.

Adhering to these specifications prevents runtime errors during token validation and ensures secure HTTPS communication with Google services. The module is ionCube-encoded, demands current TLS capabilities for its authentication flows, and integrates directly with WHMCS hooks and client-area logic. While it may run under untested conditions, limiting deployment to validated configurations eliminates unnecessary troubleshooting in production environments.

#System Requirements

  • Clear understanding of using WHMCS as well as uploading, installing and configuring addons and gateways
  • PHP 5.6 or higher
  • WHMCS 7.x (we do not support alpha, beta or release candidate builds)
  • OpenSSL (or any SSL library) w/ TLS 1.1+ support
  • Ioncube loader v10.1.x or higher

#PHP Extension Requirements

  • cURL w/ TLS 1.1+ support

#Using the Requirements Test Script

We offer a PHP script that will quickly and easily check your PHP and WHMCS installation for any missing requirements. The tool can be downloaded here – https://billing.aspnix.com/dl.php?type=d&id=138. Upload the script to your WHMCS root directory, then access it directly via browser. It performs an automated scan of PHP version, loaded modules, ionCube status, cURL TLS capabilities, OpenSSL support, and WHMCS build compatibility, returning a clear pass/fail summary with remediation guidance where needed.

php 
<?php
if (extension_loaded('ionCube Loader')) {
    echo "ionCube Loader detected.\n";
} else {
    echo "ionCube Loader NOT found.\n";
}
if (extension_loaded('curl')) {
    $curl = curl_version();
    echo "cURL version: " . $curl['version'] . "\n";
    echo "SSL Version: " . $curl['ssl_version'] . "\n";
} else {
    echo "cURL extension NOT loaded.\n";
}
phpinfo();

#Common Pitfalls

  • Deploying on WHMCS alpha, beta, or release candidate builds that introduce untested API changes
  • Using PHP versions below 5.6 or ionCube Loader releases older than v10.1
  • cURL compiled without TLS 1.1 or higher protocol support, blocking Google API calls
  • Servers with disabled or outdated OpenSSL libraries that reject modern cipher suites

The test script identifies these problems immediately. Always cross-check against the official WHMCS requirements at https://docs.whmcs.com/System_Requirements first. Resolve every flagged item before uploading the module files.

After verification, install and configure the module following the bundled instructions. Running the test script first avoids wasted time on incompatible servers and ensures your two-factor authentication layer activates without errors.