Backward Compatibility¶
This document covers configuration adjustments to support older clients that may not be compatible with modern cipher defaults on RansNet Gateway, and the SSH client requirements for RansNet devices.
Apache2 SSLCipherSuite¶
Newer versions of Apache2 default to TLS 1.3 with a restricted cipher set. Older browsers or HTTP clients may fail to establish a connection if they only support legacy ciphers.
To broaden compatibility, edit /etc/apache2/sites-available/default and add or update the following directives:
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:AES256-SHA256
SSLCipherSuite TLSv1.3 TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256
SSLHonorCipherOrder on
After updating the configuration, reload Apache2:
Note: Manual patch is required for this; and the typical use case is to let mFusion supports HSA500 devices. For other cases, please contact our supports.
VPN data-ciphers¶
OpenVPN 2.5 and later replaced the deprecated cipher directive with data-ciphers, which accepts a colon-separated list of acceptable ciphers negotiated during the handshake. Older OpenVPN clients (2.4 and below) only understand the legacy cipher directive and will fail to connect if the server requires a negotiated cipher they do not recognize.
To support a mix of old and new clients, add both directives to the server-side VPN configuration:
On RansNet Gateway, in CLI command, please add the following under vpn server instance for HSA500 devices:
Note:
DES-EDE3-CBCorAES-256-CBCis included only as a fallback for legacy clients. PreferAES-256-GCMorCHACHA20-POLY1305wherever possible, as they provide authenticated encryption.
SSH Clients¶
The SSH server on RansNet devices offers only strong algorithms: Curve25519 or DH group 16/18 key exchange, Ed25519 or RSA-SHA2 host keys, AES-GCM/CTR ciphers, and SHA-2 Encrypt-then-MAC MACs, with compression off. See Device Hardening — SSH Algorithms for the full list.
SSH clients and libraries that support these algorithms connect without changes:
| Client | Minimum Version |
|---|---|
| OpenSSH (Linux, macOS, Windows 10/11) | 7.4 |
| PuTTY | 0.75 |
| Python Paramiko | 5.0 (tested) |
For other clients and libraries, check that they support at least one algorithm of each type in the list above, including an Encrypt-then-MAC (-etm) MAC.
Older clients fail with a message such as no matching key exchange method found, no matching host key type found, no matching cipher found, or no matching MAC found. Upgrade the client, the SSH library, or the automation tool that uses it. The device does not support re-enabling the weak algorithms.
Host Key Change After Upgrade¶
After the firmware upgrade, the device offers its Ed25519 host key first. A client that saved the device's previous key warns once:
Confirm the new fingerprint with the device administrator, then remove the old entry and connect again:
In PuTTY, accept the new key when prompted.