Files
napalm-tplink-jetstream/CHANGELOG.md
T
Christian Manivong d14c11e991
driver / lint (pull_request) Successful in 14s
driver / standard (pull_request) Successful in 19s
driver / types (pull_request) Successful in 1m9s
driver / test (3.13) (pull_request) Successful in 58s
driver / test (3.12) (pull_request) Successful in 1m7s
driver / lowest (pull_request) Successful in 28s
driver / build (pull_request) Successful in 33s
driver / security (pull_request) Successful in 1m8s
CI / driver (pull_request) Successful in 2m25s
driver / publish (pull_request) Skipped
fix(ssh): keep the key exchange off DH group16
The switch offers diffie-hellman-group14-sha256 and group16-sha512 only,
and paramiko picks group16. On an SG2210P with firmware 5.30 that 4096-bit
exchange takes 9 to 16 seconds, against netmiko's 10-second conn_timeout:
paramiko then tries to log in on a transport whose key exchange has not
finished and fails with "No existing session", so every other poll failed
and netOrk flapped the switch between online and offline. group14 takes
1.5 seconds.

group16 is now disabled by default; a disabled_algorithms passed in
optional_args still wins. The netmiko arguments move into _ssh.py, so
tplink_jetstream.py keeps its recorded length.
2026-10-30 09:17:48 +01:00

3.3 KiB
Raw Blame History

Changelog

All notable changes to this driver. The format follows Keep a Changelog, versions follow Semantic Versioning.

[Unreleased]

Fixed

  • The SSH key exchange no longer uses diffie-hellman-group16-sha512. On an SG2210P with firmware 5.30 its 4096-bit exchange took 9 to 16 seconds, against netmiko's 10-second conn_timeout, so every other connection failed and the switch flapped between online and offline. diffie-hellman-group14-sha256 takes 1.5 seconds. A disabled_algorithms in optional_args still takes precedence.

Changed

  • Python 3.12 is the floor (requires-python = ">=3.12"): netOrk runs every driver on 3.12, so 3.10 and 3.11 are no longer tested (NAPALM/driver-standard#6).
  • The floor on napalm is 5.1: older releases import pkg_resources, which a Python 3.12 venv no longer has.

[0.5.0] - 2026-10-23

The first release on PyPI through the shared workflow; 0.1.0 and 0.1.1 there are an old upload.

Changed

  • The driver follows the NAPALM driver standard (https://git.netork.io/NAPALM/driver-standard): CI on Gitea runs ruff, mypy, the tests on Python 3.10–3.13 and at the lowest declared versions, bandit, pip-audit and a build check, and a release tag publishes to PyPI. The package now ships py.typed and a LICENSE file. It requires Python 3.10 and napalm-device-types 4.21.1.
  • A failure to read the current VLANs before set_interface() moves a port to another access VLAN is now logged at debug level.

[0.4.0] - 2026-10-18

Changed

  • The SSH host key is verified: with a known key in optional_args["ssh_host_keys"] any other key is refused before login, and every key seen is reported to optional_args["ssh_host_key_observer"]. Without either argument the driver connects as before. Requires napalm-device-types 4.19.0.

[0.3.0] - 2026-10-17

Added

  • configure_snmp_agent(): the caller's community (read-only), the source interface set to the VLAN whose address is exactly the listen or management address, saved and checked in show snmp community.

Removed

  • Breaking: fix_snmp and run_device_action; fix_snmp set the community public and could pick the wrong VLAN.

[0.2.0] - 2026-10-16

Added

  • SNMP configuration (get_snmp_config()), PoE status and configuration (get_poe_status(), set_poe()), interface enable and description, LAG membership in get_interfaces(), and fingerprints for discovery.

Changed

  • The driver no longer collects over SNMP: SNMP_HEALTH_PROFILE declares where the switch publishes uptime, CPU and memory, and interface counters come from the 64-bit ifXTable.
  • get_config() drops the timestamped event-log lines the switch embeds in the running configuration.
  • set_interface() uses the switch's own commands for the access VLAN and the native VLAN of a trunk.
  • Requires Python 3.10 and paramiko 5.0.0 or newer (CVE-2026-44405).

[0.1.2] - 2026-05-29

Added

  • VLAN and interface configuration; TL-SG3210 support.

[0.1.1] - 2026-05-12

Fixed

  • VLAN membership is read correctly when the switch wraps it over several lines.

[0.1.0] - 2026-05-09

Added

  • tplink_jetstream driver for TP-Link Jetstream switches over SSH: facts, interfaces and their addresses, configuration, ARP and MAC tables, LLDP neighbours and VLANs.