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
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.
3.3 KiB
3.3 KiB
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-secondconn_timeout, so every other connection failed and the switch flapped between online and offline.diffie-hellman-group14-sha256takes 1.5 seconds. Adisabled_algorithmsinoptional_argsstill 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.typedand 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 tooptional_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 inshow snmp community.
Removed
- Breaking:
fix_snmpandrun_device_action;fix_snmpset the communitypublicand 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 inget_interfaces(), and fingerprints for discovery.
Changed
- The driver no longer collects over SNMP:
SNMP_HEALTH_PROFILEdeclares 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_jetstreamdriver for TP-Link Jetstream switches over SSH: facts, interfaces and their addresses, configuration, ARP and MAC tables, LLDP neighbours and VLANs.