Case study
qss-switch-api: reconstructing QNAP QSS switch control
qss-switch-api reconstructs access to the private REST interface of a QNAP QSS-managed switch from its web UI JavaScript. Its Python CLI logs in, reads port, PoE, sensor and LLDP telemetry, and can send explicit API calls; the documentation records bearer-token authentication and response fields.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 0
- Last commit
- 2026-06-29
- Language
- Python
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence
- Observed
- Code and documentation observed; no download method or demo found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: Python 3.8+; PyYAML is optional for YAML configuration.
- Scope: QNAP QSS-managed switch; documented validation covers QSW-M2106PR-2S2T firmware 1.2.1.
- Limits: Write requests require explicit confirmation and can disrupt switch configuration.
- License: MIT license.
Cite
BibTeX
@misc{qss-switch-api-case,
title = {{qss-switch-api: reconstructing QNAP QSS switch control}},
howpublished = {\url{https://github.com/Gotham-Sound/qss-switch-api}},
url = {https://github.com/Gotham-Sound/qss-switch-api},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/qss-switch-api-case/}}
}Plain text
qss-switch-api: reconstructing QNAP QSS switch control. https://github.com/Gotham-Sound/qss-switch-api (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/qss-switch-api-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · Gotham-Sound/qss-switch-api · Revision 3a89625
More in Protocols
- NameLand: reconstructing Casio KL-A45 serial printing · Case study
- dh360d: reconstructing the Darkflash cooler LCD protocol · Case study
- Sony WH-CH720N: reconstructing headset control over RFCOMM · Case study
- Kosmos CP1: reconstructing the CP2 cassette format · Case study
- ISDT PB40: reconstructing a power bank's BLE protocol · Case study
- Jacuzzi JB1HL: decoding the J185 panel-link bus · Case study