testssl icon

Update Ktag Clone From 225 To 270 New


testssl.sh

is a free command line tool which checks a server's service on any port for the support of TLS/SSL ciphers, protocols as well as recent cryptographic flaws and more.

Update Ktag Clone From 225 To 270 New

Updating a KTAG clone from version 2.25 to 2.70 primarily involves updating the internal protocols to support a wider range of vehicles and ECU types. While the core working interface for reading and writing often remains the stable 2.25 version, the 2.70 software is used as a bridge to "unlock" newer families and communication protocols. Prerequisites & Preparation

Necessary Files: You will typically need a software bundle containing K-Suite 2.23, 2.25, and 2.70 folders.

Safety Measures: Disable your internet connection before starting the initial installation to prevent the clone from attempting an official online update, which can brick the device.

Hardware Check: Ensure your KTAG has stable firmware (commonly FW 7.020 for these software versions) and a high-quality SD card for storing the updated protocols. The Update Process Initial Driver Setup: Disconnect the KTAG hardware.

Install K-Suite 2.23 first, including any required Visual C++ components and drivers. Connect the KTAG to verify it is recognized by the system. Protocol Syncing with 2.70:

Disconnect the hardware and install the K-Suite 2.70 drivers. Reconnect the KTAG and open the 2.70 software.

The software will automatically begin "Updating Protocols" or "Updating Families." This process syncs the newer data to the device's internal SD card. Finalizing the Working Version:

Once the update finishes, you can switch back to using K-Suite 2.25 as your main operating interface.

The 2.25 version should now show the expanded list of vehicles and protocols inherited from the 2.70 update. Key Features of the 2.70 Update

Extended Vehicle Coverage: Adds support for newer ECU models and vehicles not present in older versions like 2.23 or standard 2.25.

Protocol Support: Includes updated communication standards for BDM Motorola, J-TAG Nexus, Bootloader Infineon Tricore, and more.

Interface Options: Version 2.70 often provides refined language selections and display settings, though the 2.25 interface remains the preferred stable environment for many clone users.

Updating a K-Tag clone from KSuite 2.25 to 2.70 unlocks optimized software speeds, better wake-up protocols, and resolved error reporting AliExpress France

Because K-Tag clones rely on specific cracked software ecosystems, performing this update requires strict adherence to offline protocols to avoid "bricking" (permanently damaging) the hardware. ⚠️ Critical Pre-Update Warnings Disconnect from the Internet:

Always disable Wi-Fi and unplug ethernet cables before opening any clone KSuite software unless the specific vendor explicitly states an "online version" is supported. Auto-updates from official servers will lock your clone device. Disable Antivirus Software:

Crack files and keygens are frequently flagged as false positives. Keep real-time protection off during installation. Power Stability:

Ensure your laptop is plugged into a wall outlet and your K-Tag hardware is receiving stable 12V power where required. 🛠️ Step-by-Step Update Process

Follow this sequence to cleanly transition your protocols and software files: 1. Backup and Prep Go to your current C: drive and locate the folder labeled Rename it to KSuite_2.25_Old or copy it to an external drive as a functional backup. 2. Install Intermediate or New Software

Download your KSuite 2.70 software package provided by your vendor (often delivered via a Mega link or on a provided CD/USB). Extract the compressed folder directly to your directory. This creates a fresh folder containing the 2.70 executable. AliExpress France 3. Update Protocols & Families update ktag clone from 225 to 270 new

Navigate to your older, functional folder (like 2.25) and locate the

Copy the SD card files and protocol files provided with your 2.70 package into the designated directory to overwrite the older families. 4. Driver Synchronization

Connect your K-Tag clone device to the PC using the USB cable.

Open the Windows Device Manager. If there is a yellow warning triangle next to the device, manually point the driver installer to the C:\KSuite\Drivers 5. Execute the Firmware Link Open your new KSuite 2.70 software.

The software should automatically recognize the connected K-Tag hardware and initiate a local protocol update to match the software database. This takes about 2 to 5 minutes. Do not disconnect the USB cable during this process. 🛑 Troubleshooting Common Issues "Communication Error" Drivers not loaded or bad USB cable.

Check Device Manager and reinstall drivers from the KSuite directory. Try a shorter, high-quality USB lead. Greyed out protocols

SD card files in the K-Tag hardware do not match the software version.

You may need to remove the physical SD card inside the K-Tag, format it, and rewrite the V7.020 / 2.70 SD files directly to it using an external card reader. Wake-up error Unstable voltage.

Ensure the K-Tag is connected to external 12V power when working with ECUs that demand it (like Bosch EDC17). directly or locating the correct Windows compatibility settings for KSuite 2.70? AI responses may include mistakes. Learn more

For tuning enthusiasts and professional technicians, the K-TAG Master clone remains a staple for bench-flashing ECUs. However, the standard K-Suite 2.25 software often lacks support for newer vehicle protocols. Upgrading your setup to K-Suite 2.70 is the preferred way to unlock new "families" and vehicle protocols without needing to replace your existing 7.020 firmware hardware. Why Update to K-Suite 2.70?

The jump from 2.25 to 2.70 is primarily about protocol expansion. While 2.25 is stable, it cannot communicate with many newer ECUs, particularly those requiring updated GPT (Guided Parameter Tuning) algorithms used in modern Tricore microcontrollers.

New Vehicle Support: Adds coverage for later model cars, trucks, and tractors.

Updated Protocols: Refreshes "grayed out" or inactive protocols from older versions.

Better Interface: 2.70 offers a more optimized user experience and faster communication speeds on some systems. Pre-Update Requirements Before starting, ensure you have the following:

Hardware: A K-TAG clone with Firmware 7.020 (6.070 units may require a hardware firmware update first).

Software Files: A package containing K-Suite 2.23 (for driver installation) and the K-Suite 2.70 folder.

OS: Windows XP or Windows 7 (32-bit) are often recommended for maximum driver stability, though some 2.70 versions work on Windows 10. Step-by-Step Update Guide 1. Prepare Your Environment

Disable your internet connection before starting the software. This is critical for clone devices; if the software tries to "call home" to Alientech servers, it can brick the device or damage the software license. 2. Install "Bridge" Software (K-Suite 2.23) Updating a KTAG clone from version 2

Most update paths require installing K-Suite 2.23 first to establish correct Visual C++ components and device drivers.

Run the 2.23 installer and allow it to install all requested drivers.

Connect your K-TAG via USB and ensure it is recognized in your PC's Device Manager. 3. Update the Protocols via 2.70 Extract your K-Suite 2.70 folder to your C: drive. Ensure the K-TAG is connected. Open the 2.70 version.

The software will typically begin a "Protocol Update" or "Updating Families" process automatically.

Wait Patiently: This process can take 5–15 minutes depending on your SD card's speed. Do not disconnect the cable or turn off your computer during this phase. 4. The "Dual Launch" Method

Interestingly, many users find that while 2.70 updates the protocols, the most stable version for actually reading and writing remains 2.25. After the update, you can often use the 2.25 executable to perform your tuning while benefiting from the newly unlocked 2.70 protocols. Troubleshooting & Risks

Checksum Errors: If you encounter a checksum error after updating, ensure you are using a clean power supply for your ECU. Low voltage during the "Read" process often causes these errors.

Greyed-Out Protocols: If protocols remain unavailable after the update, your internal SD card may be corrupted or full. You may need to format or replace the SD card with a high-quality 4GB Class 10 card.

Bricked ECUs: Always take a Full Backup (including Micro and EEPROM) before attempting any write operations with updated protocols.

To update a KTAG Clone from version 2.25 to 2.70 , the process primarily involves installing the new K-Suite 2.70 software

, which automatically triggers a protocol and firmware update when the device is first connected. Update Steps for KTAG 2.70 Software Installation : Install the KSUITE 2.70 software package on your computer. Hardware Connection

: Connect your KTAG tool to the computer using the provided USB cable. Automatic Update

: Launch the K-Suite 2.70 software. The program will recognize the connected device and start an automatic update process, which typically takes about 2 minutes. Protocol Synchronization : During the first launch, the software will update the .CRP families

, which includes downloading and integrating new protocols into the device's library. Key Improvements in v2.70 Expanded Protocol Library

: New vehicle protocols are added, allowing communication with newer generation ECUs.

: Often includes fixes for grayed-out buttons and improved checksum calculations. No Internet Required

: Most clone-specific 2.70 versions are designed to work offline or are "online-ready" without risk of locking the tool, though you should confirm this with your specific hardware supplier. AliExpress France Important Considerations Hardware Compatibility : Ensure your hardware (typically KTAG 7.020 ) is compatible with software version 2.70. SD Card Speed

: The update speed of the .CRP families depends heavily on your computer's speed and the quality of the SD card inside the KTAG unit. Risk of Locking Review Title: Successful Update: KTAG Clone 7

: For clone devices, it is generally advised to only use software versions specifically provided by the vendor to avoid accidental locking through official Alientech server checks. link to download the K-Suite 2.70 software or a guide on how to fix grayed-out buttons after an update?


Review Title: Successful Update: KTAG Clone 7.020 (225) to FW 270 – Works Perfectly!

Rating: ⭐⭐⭐⭐⭐

Review: I just finished updating my old KTAG clone from firmware 225 (the common 7.020 version) to the new 270 firmware, and I have to say, I am pleasantly surprised. For anyone sitting on the fence about pulling the trigger on this update, here is my experience.

The Process: I was worried about bricking the unit since it’s a clone, but the update process was straightforward. I used the provided firmware update files and the K-Suite software provided by the seller. It took about 15 minutes to flash the new firmware. You do need to be careful to follow the instructions exactly—especially regarding the USB drivers—but if you have experience with these tools, it’s standard procedure.

Build & Stability: The hardware remained stable throughout the process. Post-update, the device boots up noticeably faster. I tested the connection on a Bosch EDC17C19 and a Delphi DCM6.1, both of which were hit-or-miss on the older 225 firmware. The connection is now rock solid.

Vehicle Coverage: The main reason for the update was the expanded vehicle coverage. The FW 270 definitely adds support for newer protocols that the old 225 simply couldn't handle. I successfully read/wrote a 2021 model that my previous setup refused to touch. The checksums calculated correctly, and the car started right up after writing the file back.

Value: For the price, this is a no-brainer. It essentially gives the old hardware a new lease on life without having to buy a whole new tool. It feels like a legitimate upgrade rather than just a cosmetic change.

Cons: Just a small warning: make sure you back up your tokens/ksuite setup before updating, as some versions of the software can be finicky with clone activation after a firmware bump.

Verdict: Highly recommended for anyone running the older 7.020 hardware. It breathes new life into the tool and expands coverage significantly. A solid 5/5 for value and functionality.


Key highlights included in this review:


Part 6: Common Failures & How to Revive a Bricked Clone

Even with perfect steps, things go wrong. Here is the recovery ladder:

"Device not recognized" after update:

"Firmware update stuck at 99%":

"Software says 2.70 but hardware test fails":


1) Prepare

  1. Backup current software and drivers:
    • Copy your current KTag installation folder (e.g., C:\K-TAG) to a safe location.
    • Export any saved tokens, firmware dumps, or configuration files.
  2. Create system restore point on Windows and close antivirus/firewall (they often block tools).
  3. Download required files (place in a single folder, e.g., C:\KTag_Update):
    • KTag v270 installer package (software + services).
    • USB drivers compatible with your clone (CP210x/FTDI/CLONE-specific driver).
    • Firmware file for the KTag PCB (if provided with the v270 pack).
    • Activation/token patch or loader for clone (if needed for your unit).
    • USB to ECU adapter, cables, and a stable 12V power supply for the vehicle/bench.

Important: Only use files from sources you trust. Many clone packs include patched installers and firmware.

Part 3: Pre-Update Checklist – What You Will Need

Do not proceed without these items:


Verification & Testing

  1. Connect to PC and confirm device is detected.
  2. Open KTAG software v2.70 and check Firmware/Bootloader version displayed.
  3. Perform a simple read of a known ECU (supported model) to ensure functionality.
  4. Test read/write speed and check for error messages.

Key features

License

testssl.sh is free and open source software. You can use it under the terms of GPLv2, please review the License before using it.

Attribution is important for the future of this project -- also in the internet. Thus if you're offering a scanner based on testssl.sh as a public and/or paid service in the internet you are strongly encouraged to mention to your audience that you're using this program and where to get this program from. That helps us to get bugfixes, other feedback and more contributions.

Donations

If you like this software, you or your company uses it a lot or even your company makes money from any service around testssl.sh, why not support the project with a donation? It helps keeping the project alive and kicking.

Dirk setup a paypal account for it, keeps track of the money and makes sure it is spend on project related activities.

Donate with PayPal


If you want a deductable commercial invoice in return please get in touch with me before using paypal.

Development

github Development takes place at github. We're now @ 3.2.3 (stable) and 3.3dev.
There was a last release of 3.0.10 (oldstable) but that was the last one in the 3.0.x branch.



Support status

Supported will always be the current dev version and the version before (n-1 rule). As soon as the dev version becomes the stable release, this will be the n-1 version and receives bugfixes only. The dev version has historically not delivered really broken software (no facebook paradigm). Consider it like a rolling release: It'll definitely change-- that is the point of development-- things might break for you if you e.g. expect the output or features all to be the same. But other than that: The dev version itself won't break (TM).

3.2 is the stable branch. There was one final 3.0.10 release, a.k.a the old stable. If you need longer support for 3.0.x there's a possibility for paid maintenance support. We are focussing on 3.3dev, further development will take place in that branch. We aim to not break things badly but, as said, things will change. If you want to make use of new features like QUIC, TLS 1.3 0-RTT, newer SSLlabs rating, check for the Opossum vulnerability and more, you should consider this branch.

-

February 13, 2026: Prerelease/snapshot of 3.3dev, see github or here (signature) .

February 12, 2026: Release of bugfixed version 3.2.3, see 3.2.3 github or here (signature) .

September 18, 2025: Release of bugfixed version 3.2.2, see 3.2.2 github or here (signature) .

June 15, 2025: Start of new development branch 3.3dev, see 3.3dev github.

June 15,2025: Release of final bugfixed version 3.0.10, see 3.0.10 github or here (signature) .

June 13, 2025: Release of bugfixed version 3.2.1, see 3.2.1 @ github or here (signature) .

April 23, 2025: Release of final stable version 3.2.0, after several release candidates. see 3.2.0 @ github or here (signature) .

Jun 13, 2024: Version 3.0.9, see 3.0.9 @ github or here(signature) .

Oct 10, 2023: After several non-tagged and not labelled rc versions a now version 3.2rc3 was released, see 3.2rc3 @ github

Sep 19, 2022: Version 3.0.8, see 3.0.8 @ github or here(signature) .

Feb 19, 2022: Version 3.0.7, see 3.0.7 @ github or here(signature) .
[..]
Jan 23, 2020: Version 3.0 release, see 3.0 @ github. It's been a long rolling release candidate phase since the first 3.0 RC version.

Dec 12, 2017: ROBOT / Bleichenbacher check has been implemented. . Read more about this old+new attack @ robotattack.org. Please checkout 2.9dev @ github. I compiled also some info here, including an Alexa Top 10k scan and some background information.

Sep 19, 2017: Version 2.9.5 has been released. Please checkout 2.9.5 @ github or download it from here, you need the etc tar ball as well.

Screenshots /Pictures here

The pictures are still from an older version of testssl.sh. This will be updated later. It should suffice to get a picture though.

Longer read

testssl.sh is pretty much portable/compatible. It is working on every Linux, Mac OS X, FreeBSD distribution, on MSYS2/Cygwin (slow). It is supposed also to work on any other unixoid systems. A newer OpenSSL version (1.0) is recommended though. /bin/bash is a prerequisite – otherwise there would be no sockets.

Speaking of it: Since version 2.4 some of the checks were done with bash sockets. This improved gradually and from 2.9.5 on almost every check is done with bash sockets. Still OpenSSL is needed for some core functions like openssl <verify|ocsp|pkey> . In principle any OpenSSL or even LibreSSL can be used as a helper. It's recommended to use the one supplied as it makes sure special tests or features like IPv6, proxy support, STARTTLS MySQL or PostgreSQL are supported. (The one supplied stems originally from github.com/PeterMosmans/openssl. openssl-1.0.2k-chacha.pm.ipv6.Linux+FreeBSD.tar.gz is a Linux- and FreeBSD-only tarball. The directory openssl-1.0.2i-chacha.pm.ipv6.contributed/ contains contributed builds for ARM7l and Darwin binaries).

Download shortcuts

Note the following features are supported by the webserver configuration: – each to standard output. Please note however that from 2.9dev on you need the mandatory files in etc/ though, see https://github.com/testssl/testssl.sh/tree/3.0/etc.

Usage

The normal use case is probably just testssl.sh <hostname>, see first picture right hand above (a deliberately bad configuration).

Starting testssl.sh with no params will give you a general idea how to use it:
userid@somehost:~ % testssl.sh

     "testssl.sh [options] <URI>"    or    "testssl.sh <options>"


"testssl.sh <options>", where <options> is:

     --help                        what you're looking at
     -b, --banner                  displays banner + version of testssl.sh
     -v, --version                 same as previous
     -V, --local                   pretty print all local ciphers
     -V, --local <pattern>         which local ciphers with <pattern> are available? If pattern is not a number: word match

     <pattern>                     is always an ignore case word pattern of cipher hexcode or any other string in the name, kx or bits

"testssl.sh <URI>", where <URI> is:

     <URI>                         host|host:port|URL|URL:port   port 443 is default, URL can only contain HTTPS protocol)

"testssl.sh [options] <URI>", where [options] is:

     -t, --starttls <protocol>     Does a default run against a STARTTLS enabled <protocol,
                                   protocol is <ftp|smtp|lmtp|pop3|imap|xmpp|telnet|ldap|nntp|postgres|mysql>
     --xmpphost <to_domain>        For STARTTLS enabled XMPP it supplies the XML stream to-'' domain -- sometimes needed
     --mx <domain/host>            Tests MX records from high to low priority (STARTTLS, port 25)
     --file/-iL <fname>            Mass testing option: Reads one testssl.sh command line per line from <fname>.
                                   Can be combined with --serial or --parallel. Implicitly turns on "--warnings batch".
                                   Text format 1: Comments via # allowed, EOF signals end of <fname>
                                   Text format 2: nmap output in greppable format (-oG), 1 port per line allowed
     --mode <serial|parallel>      Mass testing to be done serial (default) or parallel (--parallel is shortcut for the latter)
     --warnings <batch|off>        "batch" doesn't continue when a testing error is encountered, off continues and skips warnings
     --connect-timeout <seconds>   useful to avoid hangers. Max <seconds> to wait for the TCP socket connect to return
     --openssl-timeout <seconds>   useful to avoid hangers. Max <seconds> to wait before openssl connect will be terminated

single check as <options>  ("testssl.sh URI" does everything except -E and -g):
     -e, --each-cipher             checks each local cipher remotely
     -E, --cipher-per-proto        checks those per protocol
     -s, --std, --standard         tests certain lists of cipher suites by strength
     -p, --protocols               checks TLS/SSL protocols (including SPDY/HTTP2)
     -g, --grease                  tests several server implementation bugs like GREASE and size limitations
     -S, --server-defaults         displays the server's default picks and certificate info
     -P, --server-preference       displays the server's picks: protocol+cipher
     -x, --single-cipher <pattern> tests matched <pattern> of ciphers
                                   (if <pattern> not a number: word match)
     -c, --client-simulation       test client simulations, see which client negotiates with cipher and protocol
     -h, --header, --headers       tests HSTS, HPKP, server/app banner, security headers, cookie, reverse proxy, IPv4 address

     -U, --vulnerable              tests all (of the following) vulnerabilities (if applicable)
     -H, --heartbleed              tests for Heartbleed vulnerability
     -I, --ccs, --ccs-injection    tests for CCS injection vulnerability
     -T, --ticketbleed             tests for Ticketbleed vulnerability in BigIP loadbalancers
     -BB, --robot                  tests for Return of Bleichenbacher's Oracle Threat (ROBOT) vulnerability
     -R, --renegotiation           tests for renegotiation vulnerabilities
     -C, --compression, --crime    tests for CRIME vulnerability (TLS compression issue)
     -B, --breach                  tests for BREACH vulnerability (HTTP compression issue)
     -O, --poodle                  tests for POODLE (SSL) vulnerability
     -Z, --tls-fallback            checks TLS_FALLBACK_SCSV mitigation
     -W, --sweet32                 tests 64 bit block ciphers (3DES, RC2 and IDEA): SWEET32 vulnerability
     -A, --beast                   tests for BEAST vulnerability
     -L, --lucky13                 tests for LUCKY13
     -F, --freak                   tests for FREAK vulnerability
     -J, --logjam                  tests for LOGJAM vulnerability
     -D, --drown                   tests for DROWN vulnerability
     -f, --pfs, --fs, --nsa        checks (perfect) forward secrecy settings
     -4, --rc4, --appelbaum        which RC4 ciphers are being offered?

tuning / connect options (most also can be preset via environment variables):
     --fast                        omits some checks: using openssl for all ciphers (-e), show only first preferred cipher.
     -9, --full                    includes tests for implementation bugs and cipher per protocol (could disappear)
     --bugs                        enables the "-bugs" option of s_client, needed e.g. for some buggy F5s
     --assume-http                 if protocol check fails it assumes HTTP protocol and enforces HTTP checks
     --ssl-native                  fallback to checks with OpenSSL where sockets are normally used
     --openssl <PATH>              use this openssl binary (default: look in $PATH, $RUN_DIR of testssl.sh)
     --proxy <host:port|auto>      (experimental) proxy connects via <host:port>, auto: values from $env ($http(s)_proxy)
     -6                            also use IPv6. Works only with supporting OpenSSL version and IPv6 connectivity
     --ip <ip>                     a) tests the supplied <ip> v4 or v6 address instead of resolving host(s) in URI
                                   b) arg "one" means: just test the first DNS returns (useful for multiple IPs)
     -n, --nodns <min|none>        if "none": do not try any DNS lookups, "min" queries A, AAAA and MX records
     --sneaky                      leave less traces in target logs: user agent, referer
     --ids-friendly                skips a few vulnerability checks which may cause IDSs to block the scanning IP
     --phone-out                   allow to contact external servers for CRL download and querying OCSP responder
     --add-ca <cafile>             path to <cafile> or a comma separated list of CA files enables test against additional CAs.
     --basicauth <user:pass>       provide HTTP basic auth information.

output options (can also be preset via environment variables):
     --quiet                       don't output the banner. By doing this you acknowledge usage terms normally appearing in the banner
     --wide                        wide output for tests like RC4, BEAST. PFS also with hexcode, kx, strength, RFC name
     --show-each                   for wide outputs: display all ciphers tested -- not only succeeded ones
     --mapping <openssl|           openssl: use the OpenSSL cipher suite name as the primary name cipher suite name form (default)
                iana|rfc             -> use the IANA/(RFC) cipher suite name as the primary name cipher suite name form
                no-openssl|          -> don't display the OpenSSL cipher suite name, display IANA/(RFC) names only
                no-iana|no-rfc>      -> don't display the IANA/(RFC) cipher suite name, display OpenSSL names only
     --color <0|1|2|3>             0: no escape or other codes,  1: b/w escape codes,  2: color (default), 3: extra color (color all ciphers)
     --colorblind                  swap green and blue in the output
     --debug <0-6>                 1: screen output normal but keeps debug output in /tmp/.  2-6: see "grep -A 5 '^DEBUG=' testssl.sh"

file output options (can also be preset via environment variables)
     --log, --logging              logs stdout to '${NODE}-p${port}${YYYYMMDD-HHMM}.log' in current working directory (cwd)
     --logfile|-oL <logfile>       logs stdout to 'dir/${NODE}-p${port}${YYYYMMDD-HHMM}.log'. If 'logfile' is a dir or to a specified 'logfile'
     --json                        additional output of findings to flat JSON file '${NODE}-p${port}${YYYYMMDD-HHMM}.json' in cwd
     --jsonfile|-oj <jsonfile>     additional output to the specified flat JSON file or directory, similar to --logfile
     --json-pretty                 additional JSON structured output of findings to a file '${NODE}-p${port}${YYYYMMDD-HHMM}.json' in cwd
     --jsonfile-pretty|-oJ <jsonfile>  additional JSON structured output to the specified file or directory, similar to --logfile
     --csv                         additional output of findings to CSV file '${NODE}-p${port}${YYYYMMDD-HHMM}.csv' in cwd or directory
     --csvfile|-oC <csvfile>       additional output as CSV to the specified file or directory, similar to --logfile
     --html                        additional output as HTML to file '${NODE}-p${port}${YYYYMMDD-HHMM}.html'
     --htmlfile|-oH <htmlfile>     additional output as HTML to the specified file or directory, similar to --logfile
     --out(f,F)ile|-oa/-oA <fname> log to a LOG,JSON,CSV,HTML file (see nmap). -oA/-oa: pretty/flat JSON.
                                   "auto" uses '${NODE}-p${port}${YYYYMMDD-HHMM}'. If fname if a dir uses 'dir/${NODE}-p${port}${YYYYMMDD-HHMM}'
     --hints                       additional hints to findings
     --severity <severity>         severities with lower level will be filtered for CSV+JSON, possible values <LOW|MEDIUM|HIGH|CRITICAL>
     --append                      if (non-empty) <logfile>, <csvfile>, <jsonfile> or <htmlfile> exists, append to file. Omits any header
     --outprefix <fname_prefix>    before  '${NODE}.' above prepend <fname_prefix>


Options requiring a value can also be called with '=' e.g. testssl.sh -t=smtp --wide --openssl=/usr/bin/openssl <URI>.
<URI> always needs to be the last parameter.


userid@somehost:~ % 

Details are in the man page.

You are free to check any port – supposed there's any SSL enabled service (TCP) listening. For the service HTTP you can also supply a full URL. STARTTLS services are those which are plaintext and need some kind of an upgrade command to speak TLS. This is very protocol (see difference between IMAP and SMTP) specific. A STARTTLS check with testssl.sh would be invoked with testssl.sh -t pop3 pop.o2online.de:110. Other examples:
testssl.sh --starttls smtp <smtphost>.<tld>:587 
testssl.sh --starttls ftp <ftphost>.<tld>:21
testssl.sh -t xmpp <jabberhost>.<tld>:5222 
testssl.sh -t xmpp --xmpphost <XMPP domain> <jabberhost>.<tld>:5222 
testssl.sh --starttls imap <imaphost>.<tld>:143
The ports in those examples above are just the standard ports. Also here you're free to check any port. //refactor those, see e.g. https://content-security-policy.com/unsafe-hashes/ or just drop tis shit
If you just want to check the mail exchangers of a domain, do it like this: testssl.sh --mx google.com (make sure port 25 outbound is not blocked by your firewall) – see left hand side picture.

With the output option --wide you get where possible a wide output with hexcode of the cipher, OpenSSL cipher suite name, key exchange (with DH size), encryption algorithm, encryption bits size and maybe the RFC cipher suite name.

If you have the file mapping-rfc.txt in the same directory as testssl.sh it displays in the wide outputs also the corresponding RFC style cipher name. If you don't want this, you need to move mapping-rfc.txt away. Another thing: If you want to find out what local ciphers you have and print them pretty, use testssl.sh -V. Ever wondered what hexcode a cipher is? testssl.sh -V x14 lets you search for the hexcode x14. For hexcodes: If you just specify 14 instead of x14 you will get all ciphers returned which have 14 as a low, middle or high byte. For ciphers: You can also supply a word case pattern, e.g. testssl.sh -V CBC puts out every locally available cipher having the Cipher Block Chaining mode in its name.

testssl.sh -x <pattern> <URI> does the same as testssl.sh -V, it only checks the matched pattern at the server, so e.g. testssl.sh -x ECDH google.com checks google.com for ECDH ciphers (and lists also not available ones at the target), testssl.sh -x DHE smtp.posteo.de:465 does a similar thing for the TLS enabled SMTP service.

testssl.sh --file <myfile> let you do mass testing. The syntax of the file is very easy: one cmdline per line. Use comment signs # as you like, blank lines will be skipped, EOF signals the end of the file – what else? ;-).

You can also specify a proxy since version 2.6: testssl.sh --proxy=<proxyhost>:<proxyport> <your_other_cmds_here> will sneak the openssl and bash sockets requests e.g. out of our corporate environment. Proxy authentication is not supported and the port and protocol has to be allowed in the proxy.

Another neat feature: testssl.sh --header <URI> gives you some information on the HTTP header and marks security features in green (see upper black picture on the right hand side), not so good headers range from yellow over brown to red. It also allows you to fingerprint proxies, see lower black picture.


Changes

3.2




       ... branch is stable github only. Changes relative to 3.0 see changelog.

3.0






















Misc

Feedback, bugs and contributions are welcome! Currently there's one git repo at https://github.com/testssl/testssl.sh. Here @ https://testssl.sh you will always find the latest stable version.

Bugs (and fixes) as well as other PRs can by filed at the git repo or send me a mail to dirk aet testssl dot sh.

I post all significant updates on Mastodon or Bluesky. There was a personal twitter account which is deprecated as we don't like nazis or hate speech.  


Services:  If you need a scanning service or consulting get in touch with me..


Imprint