Metadata-Version: 2.4
Name: lyss
Version: 0.11.1
Summary: LYSS (Lyaazale Switch Security): open, vendor-neutral security standard and read-only audit tool for network switches
Author-email: Mouad Lyaazale <lyaazale@lyss.dev>
License-Expression: AGPL-3.0-only AND CC-BY-4.0
Project-URL: Homepage, https://lyss.dev
Project-URL: Source, https://github.com/lyss-project/lyss
Project-URL: Issues, https://github.com/lyss-project/lyss/issues
Project-URL: Changelog, https://github.com/lyss-project/lyss/blob/main/CHANGELOG.md
Project-URL: Specification, https://github.com/lyss-project/lyss/blob/main/docs/LYSS-Specification.md
Project-URL: Funding, https://ko-fi.com/lyaazale
Keywords: network,switch,security,audit,compliance,cisco,mikrotik,routeros,sonic,aruba,hardening,baseline
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Networking :: Monitoring
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE-SPEC
License-File: NOTICE
License-File: TRADEMARKS.md
Requires-Dist: pyyaml>=6
Requires-Dist: netmiko>=4.8
Requires-Dist: paramiko<4,>=3.5
Requires-Dist: cryptography>=42
Requires-Dist: fastapi>=0.115
Requires-Dist: uvicorn>=0.30
Requires-Dist: jinja2>=3.1
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: aiosmtpd>=1.4; extra == "dev"
Requires-Dist: openpyxl>=3.1; extra == "dev"
Dynamic: description
Dynamic: description-content-type
Dynamic: license-file

# LYSS: Lyaazale Switch Security

[![tests](https://github.com/lyss-project/lyss/actions/workflows/tests.yml/badge.svg)](https://github.com/lyss-project/lyss/actions/workflows/tests.yml)
[![licence: AGPL-3.0](https://img.shields.io/badge/licence-AGPL--3.0-blue)](https://github.com/lyss-project/lyss/blob/main/LICENSE)
[![specification: CC BY 4.0](https://img.shields.io/badge/specification-CC%20BY%204.0-lightgrey)](https://github.com/lyss-project/lyss/blob/main/LICENSE-SPEC)
[![python 3.10+](https://img.shields.io/badge/python-3.10%2B-3776ab)](https://www.python.org/downloads/)
[![made in Morocco](https://img.shields.io/badge/made%20in-Morocco-c1272d)](https://lyss.dev)

**Telnet still on. SNMP "public". Firmware with an exploited flaw. Would you find them on your
switches?**

LYSS is an open, vendor-neutral security standard for network switches, and a free, read-only
tool that checks your switches against it, shows the evidence and gives the fix.

**Try it now, nothing to install:** paste a switch configuration at
**[lyss.dev/audit.html](https://lyss.dev/audit.html)**. LYSS runs in your browser; nothing is uploaded.

![LYSS demo: one-click read-only scan, evidence and fix for every finding, topology, control matrix, low-risk fixes verified by a new scan](https://raw.githubusercontent.com/lyss-project/lyss/main/docs/media/lyss-demo.gif)

<sub>Demo on a fictitious network. Cisco IOS · Cisco Business · HPE Aruba AOS-S · MikroTik RouterOS · SONiC · Website: [lyss.dev](https://lyss.dev) · Try it in your browser: [lyss.dev/audit.html](https://lyss.dev/audit.html)</sub>

LYSS defines **what** a securely managed switch looks like, once, independently of any vendor
(the [specification](https://github.com/lyss-project/lyss/blob/main/docs/LYSS-Specification.md)), and **how to verify it** on each platform
(adapters). Switches are assessed against conformance levels:

- **Level 1, Baseline**: no cleartext management, no default or recoverable credentials,
  supported firmware without known critical or exploited vulnerabilities, automatic backups.
- **Level 2, Hardened**: central authentication, restricted and modern management access,
  remote logging and time synchronization, access-port hygiene.
- **Level 3, Advanced**: access-layer protection against attacks from user ports: DHCP snooping,
  ARP inspection, 802.1X / MAC authentication, storm control, no CDP/LLDP towards users
  (opt-in: `lyss audit --level 3`, or Settings > Assessment).

> Status: **0.11, draft specification 0.6, preview.** The specification and the tool may still change
> before 1.0. Feedback and adapters for other platforms are welcome.
> Author: Mouad Lyaazale (معاد اليازل).

## Try it in two minutes (no switch needed)

```sh
python -m venv lyss-env
lyss-env/bin/pip install lyss           # Windows: lyss-env\Scripts\pip install lyss
lyss-env/bin/lyss demo --open           # Windows: lyss-env\Scripts\python -m lyss demo --open
```

Or from the source code (to contribute, or to read the adapters and the specification next to it):

```sh
git clone https://github.com/lyss-project/lyss.git && cd lyss
python -m venv .venv
.venv/bin/pip install -e .              # Windows: .venv\Scripts\pip install -e .
.venv/bin/python -m lyss demo --open    # Windows: .venv\Scripts\python -m lyss demo --open
```

**No connection to your devices at all?** Audit a configuration you saved yourself (a MikroTik
`/export`, a Cisco or HPE `show running-config`, a SONiC config_db): nothing is sent anywhere.
The platform is recognised from the file.

```sh
lyss audit --level 2 router.rsc      # or a folder of saved configurations
```

Or, without installing anything, paste it into **[lyss.dev/audit.html](https://lyss.dev/audit.html)**:
LYSS runs inside the page and the configuration is not uploaded.

See [docs/OFFLINE.md](https://github.com/lyss-project/lyss/blob/main/docs/OFFLINE.md): how to save the configuration on each platform, what a
configuration alone can and cannot tell, and how to add device state by hand.

An installed LYSS keeps its data (devices, encrypted credentials, results) in `%LOCALAPPDATA%\LYSS`
on Windows and `~/.local/share/lyss` elsewhere; a source checkout in `private/`. `LYSS_DATA_DIR`
overrides both.

This starts a simulated network of nine fictitious switches (Cisco IOS, Cisco Small Business,
HPE Aruba, MikroTik RouterOS, SONiC, Arista EOS, one of them hardened up to Level 3) on 127.0.0.1 and the LYSS web interface on a separate demo data folder. Everything
you see is invented. See [docs/DEMO.md](https://github.com/lyss-project/lyss/blob/main/docs/DEMO.md). On Windows, double-click
`Start-LYSS-Demo.cmd` instead (the first start installs LYSS).

**Testing LYSS on your switches?** Start with [docs/TESTERS.md](https://github.com/lyss-project/lyss/blob/main/docs/TESTERS.md), give LYSS a
read-only account ([docs/ACCOUNTS.md](https://github.com/lyss-project/lyss/blob/main/docs/ACCOUNTS.md)), and tell me what you found in the
[issues](https://github.com/lyss-project/lyss/issues). Website: https://lyss.dev

## Platform support

| Platform | Level 1 | Level 2 | Device state | Remediation | Firmware data |
|---|---|---|---|---|---|
| Cisco IOS / IOS-XE (Catalyst) | yes | yes | yes | yes | Catalyst 1000 |
| Cisco Small Business / Business (SG200-550X, CBS) | yes | yes | yes | yes | SG200/300/500, 350, CBS250/350 |
| HP ProCurve / HPE Aruba AOS-S | yes | yes | yes | basic | AOS-S 16.x |
| MikroTik RouterOS 6.x / 7.x (CRS, RouterBOARD, CHR), preview | yes | yes | yes | no | RouterOS (CISA KEV + critical) |
| SONiC (community builds), preview | yes | yes | yes | no | no |
| Arista EOS (7000 series, cEOS / vEOS), preview | yes | yes | yes | no | no |
| Zyxel GS1900, preview: **firmware only**, offline | no | no | no | no | GS1900 (CVE-2026-7273, CISA KEV) |

Cisco IOS and Cisco Small Business are validated on real switches; HPE Aruba AOS-S on the
simulator and synthetic outputs so far (reports from real AOS-S switches are welcome). MikroTik
RouterOS is validated on CHR 7.25.1: LYSS reads `/export terse` (never `show-sensitive`, so no
secret is collected) and `print terse` state, because RouterOS exports only non-default settings.
Give the LYSS account a read-only group without the "sensitive" policy. SONiC is
validated on the SONiC-VS 202505 virtual switch: LYSS reads its config_db JSON and `show`
commands. Two SONiC controls stay "unknown" by design: the sudo account's password hash
(in /etc/shadow, not readable by a read-only account) and firmware support (no published
end-of-support data for community builds). Arista EOS is validated on cEOS-lab 4.37.0F
(default, insecure and hardened configurations, LLDP topology between two switches); its
firmware check stays "unknown" for now: the one EOS flaw in the CISA KEV catalogue
(CVE-2026-7473, Security Advisory 0137) has no fixed release, only a mitigation ACL.

**Zyxel GS1900** (web-managed; Zyxel's CLI is a troubleshooting shell): LYSS checks the firmware
against CVE-2026-7273, the web-interface flaw exploited on about 1,000 GS1900 switches since
August 2026 (CISA KEV). Paste the output of `show version`, or the text of the web page
*System Information*, into [lyss.dev/audit.html](https://lyss.dev/audit.html) or run
`lyss audit version.txt`. The other controls stay "unknown" until the configuration format is
verified on a real switch: if you own a GS1900, a sanitized configuration export helps.

## What the tool does

- **Read-only collection** over SSH, in parallel, optionally through an SSH jump host.
- **Assessment** with evidence for every verdict (secrets redacted) and recommended fixes.
- **Discovery** of unmanaged switches from LLDP/CDP neighbours and SSH range scans.
- **Topology map** built from neighbour tables.
- **History**: configuration versions with diffs, scan trends, regression alerts.
- **Scheduled scans**, **e-mail alerts**, **CISO Assistant** evidence push (disabled by default).
- **SIEM events** over syslog or a JSON-lines file, with ready Wazuh decoder and rules
  ([integrations/wazuh](https://github.com/lyss-project/lyss/blob/main/integrations/wazuh/README.md)).
- **Oxidized**: assess the configurations Oxidized already backs up, without SSH
  ([integrations/oxidized](https://github.com/lyss-project/lyss/blob/main/integrations/oxidized/README.md)).
- **CISO Assistant library**: the LYSS framework and its ISO 27001:2022 mapping, ready to import
  ([integrations/ciso-assistant](https://github.com/lyss-project/lyss/blob/main/integrations/ciso-assistant/README.md)).
- **Reports**: standalone HTML (printable to PDF) and JSON, with ISO 27001 / NIST / CIS mappings.
- **Optional remediation** (off by default): low-risk fixes only, previewed, applied one switch at
  a time, verified over a new connection, rolled back automatically, saved only after
  verification, and logged.
- **Switch simulator** (`python -m lyss sim`) to test collection, topology and remediation
  without hardware.

## Getting started

Windows: double-click `Start-LYSS.cmd`; http://127.0.0.1:8765 opens. The first start installs LYSS
into `.venv` (needs Python 3.10+) and asks for an administrator password.

From source (any OS):

```sh
python -m venv .venv
.venv/bin/pip install -e .           # Windows: .venv\Scripts\pip install -e .
.venv/bin/python -m lyss ui          # local web interface on 127.0.0.1:8765
```

Docker (Linux): `docker compose up -d`, then http://127.0.0.1:8765. Data lives in the `lyss-data`
volume; back up `/data/master.key`, which encrypts the stored credentials.

Command line:

```sh
python -m lyss collect                 # collect and assess every switch (read-only)
python -m lyss collect --scheduled     # same, from cron / Task Scheduler (automatic backup)
python -m lyss audit --vendor cisco_sb --level 2 path/to/configs/
```

## Repository layout

| Path | Content | Licence |
|---|---|---|
| `spec/lyss-spec.yaml` | The specification (normative source) | CC BY 4.0 |
| `docs/LYSS-Specification.md` | Specification document, generated by `tools/build_spec.py` | CC BY 4.0 |
| `data/firmware.yaml` | Firmware knowledge base, every fact sourced | CC BY 4.0 |
| `adapters/` | Per-platform checks and remediations | AGPL-3.0-only + terms |
| `src/lyss/` | Engine, collector, discovery, topology, history, web interface | AGPL-3.0-only + terms |
| `tests/` | Synthetic test cases and test suite | AGPL-3.0-only + terms |

## Licence and attribution

LYSS is free software: you can use, study, modify and share it. The software is licensed under
the GNU Affero General Public License v3 (AGPL-3.0-only) with additional terms under its section 7,
and the specification under CC BY 4.0. In short:

- Every copy and every modified version, including one offered to users over a network, must keep
  the attribution **LYSS by Mouad Lyaazale · Made in Morocco** where the original shows it: the
  footer of the web interface, the login page and the reports. Keep the `NOTICE` file.
- A modified version must be marked as modified and must publish its source code to its users
  (AGPL).
- The names "LYSS" and "Lyaazale Switch Security" and the LYSS logo are not licensed for modified
  versions: see [TRADEMARKS.md](https://github.com/lyss-project/lyss/blob/main/TRADEMARKS.md).

The exact terms are in [LICENSE](https://github.com/lyss-project/lyss/blob/main/LICENSE), [LICENSE-SPEC](https://github.com/lyss-project/lyss/blob/main/LICENSE-SPEC) and [NOTICE](https://github.com/lyss-project/lyss/blob/main/NOTICE).

## Support LYSS

LYSS is free and built on personal time. If it helps you secure your network, you can support its
development on [Ko-fi](https://ko-fi.com/lyaazale). Reporting wrong verdicts and sharing the
project help just as much.

## Data handling

Real switch configurations contain password hashes, keys and topology. They stay in `private/`
(or `LYSS_DATA_DIR`), which is never committed. See [SECURITY.md](https://github.com/lyss-project/lyss/blob/main/SECURITY.md) for the security
design and [CONTRIBUTING.md](https://github.com/lyss-project/lyss/blob/main/CONTRIBUTING.md) to contribute controls or adapters.
