Uživatelský návod.

Nástroj pro Windows 64 bit pro vyčtení SNMPv3 stromu a porovnání vyčtených instancí s definicemi nahrané MIB. Spusťte jediný soubor SNMPv3-Tool-1.2.2.exe; Python, instalátor ani rozbalování ZIP nejsou potřeba. EXE je určen pro Windows 10 (1809 a novější) nebo Windows 11 x64. První spuštění rozbalí přibalené knihovny do dočasné složky a může chvíli trvat. Licence najdete a uložíte přes Nápověda → O aplikaci a licence.

Tabulky mají jemnou mřížku a oddělená záhlaví, aktivní záložku označuje modrá horní linka. Rozbalovací a číselná pole mají samostatnou plochu se šipkami; tlumené prvky nejsou právě dostupné. Šipkou u větve rozbalíte potomky, tlačítkem Kontext a limity čtení otevřete další nastavení.

Načtení MIB

Klikněte na Načíst MIB… a vyberte textový ASN.1 soubor (.mib, .txt, .my, .asn1, .smi nebo soubor bez přípony). Lze vybrat několik souborů najednou. Závislosti uvedené v IMPORTS ponechte ve stejné složce nebo je vyberte společně z dalších složek. Soubory se rozpoznávají podle jména modulu v obsahu, takže název souboru může být libovolný.

Základní standardní MIB, IF-MIB, IANAifType-MIB a další jsou součástí aplikace. Načítání nepotřebuje internet. Pokud chybí vendor modul, nástroj zobrazí jeho název. Nahrajte jeho původní ASN.1 definici. Pythonové .py MIB nejsou přijímány.

Ukázková MIB načte pouze ukázkovou strukturu; nečte vaše zařízení. V Nápověda → Vyčíst místní testovací zařízení lze vyzkoušet celý postup na místním SNMPv3 agentovi, který aplikace sama vytvoří a po testu ukončí. Výsledek je označen jako místní test.

Připojení SNMPv3

Vyplňte IP adresu nebo DNS název, UDP port (obvykle 161) a SNMPv3 uživatele. Podporována je IPv4 a číselná IPv6 adresa.

Algoritmy musí odpovídat zařízení. Autentizace: MD5, SHA-1, SHA-224, SHA-256, SHA-384, SHA-512. Šifrování: AES-128, AES-192, AES-256, AES-192/256 (Blumenthal) a DES. U AES-192/256 výchozí varianta používá rozšíření klíče Reeder; některé přístroje potřebují variantu Blumenthal. Výchozí volba je SHA-256 a AES-128. Autentizační a šifrovací heslo musí mít alespoň 8 bajtů.

Kontext a limity čtení umožní nastavit název kontextu, volitelné hexadecimální engine ID kontextu, timeout, opakování, počet hodnot v dávce GETBULK a limity celého čtení. Automatické zjištění engine ID zařízení a časová synchronizace SNMPv3 probíhají automaticky.

Profily ukládají pouze parametry připojení a kořenový OID. Hesla se nikdy neukládají a při načtení profilu je zadáte znovu.

Seznam OID z CSV

Načíst OID z CSV… načte přesné hodnoty nebo kořeny podstromů a zapne Číst celý CSV seznam. Povinný sloupec je oid, volitelné jsou mode, name a description. get (výchozí) přečte přesnou instanci včetně indexu, walk celý podstrom. Oddělovačem může být středník, čárka nebo tabulátor, kódování UTF-8 nebo Windows-1250. Potom vyplňte připojení a stiskněte Vyčíst CSV seznam. MIB není nutná; nahraná MIB doplní skutečné typy a DESCRIPTION.

Podrobný formát CSV obsahuje příklady, limity a interpretaci výsledku. Šablonu lze uložit přes Nápověda → Uložit ukázkové CSV…. Import probíhá celý najednou; chyba zachová předchozí seznam a výsledky. CSV seznam se neukládá do profilu připojení. Časový limit a limit hodnot platí pro celý seznam, překrývající se výsledky se neduplikují. Pokrytí MIB se vztahuje pouze na požadované cíle; export zachovává jejich seznam a stav dokončení.

Vyčtení a ověření

Klikněte na větev ve stromu nebo zadejte číselný Kořenový OID. Výchozí větev se zvolí podle čitelných objektů MIB. Potom klikněte na Vyčíst strom. GETBULK čte více hodnot v jedné odpovědi; GETNEXT je pomalejší, ale vhodný pro zařízení, která GETBULK odmítají. U známého přesného OID instance (například skalár s .0) nástroj nejprve přečte danou instanci pomocí GET, aby ji nepřeskočil.

Ověřit spojení provede krátký čtecí dotaz. Ověří odpověď SNMPv3, včetně zabezpečení; neověřuje celý strom.

• Hodnoty: skutečně vrácené instance, číselný OID, název z MIB, typ a hodnota. Názvy enumerací se doplňují, binární řetězce jsou dostupné také jako raw hex v detailu a JSON.
• Pokrytí MIB: počet vyčtených čitelných definic / celkový počet čitelných definic ve zvolené větvi. Více instancí stejného sloupce se počítá jako jedna pokrytá definice.
• Bez instance: čitelné definice, pro které se nevrátila žádná hodnota. Tabulky, řádky, nepřístupné indexy a notifikace se do pokrytí nepočítají.
• Průběh: dokončení, chybové zprávy a doba čtení.

Objekt bez instance sám o sobě nedokazuje závadu. Tabulka může být prázdná, funkce nemusí být implementována nebo ji uživateli skrývá SNMP pohled. Tento nástroj ověřuje čtení a mapování hodnot podle MIB, nikoli povinnou implementaci všech volitelných objektů ani kompletní soulad hodnot s každým omezením ASN.1.

Pokud je dosažen limit hodnot či času, dojde k chybě nebo použijete Zastavit, výsledky jsou výslovně označeny jako částečné. Při zavření okna se běžící čtení bezpečně zastaví. Na chybu opakovaného nebo klesajícího OID nástroj reaguje ukončením čtení.

Procházení stromu a detail MIB

Po vyčtení můžete klikáním procházet strom. U definic jsou vidět hodnoty nebo počet instancí; pod nimi vzniknou skutečné instance (skalár obvykle .0, sloupec tabulky podle indexu). Kliknutí zobrazí spodní Detail objektu:

• Skalár nebo konkrétní instance: hodnota, úplný OID instance a DESCRIPTION odpovídající definice.
• Sloupec: všechny vyčtené instance tohoto sloupce; na kartě Instance jsou hodnoty seřazené podle číselného OID. Kliknutím na řádek zobrazíte konkrétní hodnotu.
• Tabulka, řádek nebo nadřazená větev: přehled vyčtených hodnot pod zvoleným OID a metadata samotné větve, pokud je MIB obsahuje.

Karta DESCRIPTION a parametry ukazuje celý popis bez zkrácení, modul, druh objektu, SYNTAX, přístup, STATUS, jednotky, rozsahy, délku SIZE, výčet hodnot, INDEX, AUGMENTS, DEFVAL, REFERENCE a údaje modulu, pokud jsou v přeložené definici dostupné. Úplná definice MIB zpřístupňuje všechny položky definice přeložené z nahrané MIB do JSON, včetně dalších údajů nezobrazených v přehledu. U textových nebo binárních hodnot je dostupný také raw hex. Text DESCRIPTION zachovává jazyk původní MIB.

Zobrazená hodnota pochází z posledního spuštěného čtení; kliknutí samo nevysílá nový SNMP dotaz. V přehledu je uveden zdroj a čas tohoto čtení. Pro novou hodnotu použijte Vyčíst strom. Během běžícího čtení se vybraný detail automaticky doplňuje novými hodnotami.

Stav Dosud nevyčteno znamená, že ještě nejsou načtené hodnoty. Bez vyčtené instance uvádí absenci hodnoty v posledním čtení; Mimo čtenou větev upozorňuje, že daný OID nebyl do čtení zahrnut. U neúplného čtení je detail označen jako částečný. Metadata jsou k dispozici i bez připojení. Při novém čtení nebo načtení jiné MIB se původní hodnoty a instance vymažou.

Kliknutí do stromu při neprobíhajícím čtení nastaví také Kořenový OID pro další čtení. Výšku spodního detailu a šířku stromu lze upravit tažením oddělovacích lišt. Dlouhé popisy a parametry lze posouvat; hodnotu i text lze označit a kopírovat.

Export

Export výsledků… uloží celý výsledek (i řádky skryté filtrem):

• JSON obsahuje parametry připojení bez hesel, stav a kompletnost čtení, všechny hodnoty a přehled definic bez instance.
• CSV používá UTF-8 s BOM a středníky pro snadné otevření v českém Excelu. Obsahuje i definice bez instance a stav čtení. Hodnoty připomínající vzorec jsou uložené jako text.

Pravým tlačítkem myši lze kopírovat OID či hodnotu. Hledání ve stromu a filtr výsledků pracují s názvem i číselným OID.

Pokud spojení nefunguje

Zkontrolujte adresu a UDP port, povolení SNMPv3 na přístroji, shodu uživatele, úrovně zabezpečení, algoritmů, obou hesel a kontextu. Pokud zařízení vrátí tooBig, snižte velikost dávky nebo zvolte GETNEXT. Timeout může způsobit také firewall nebo agent, který nesprávnou autentizaci zahodí bez odpovědi.

V Nápověda → Ověřit aplikaci proběhne místní test pěti variant zabezpečení, MIB a CSV. Jeho úspěch potvrzuje funkčnost aplikace; dostupnost konkrétního fyzického zařízení tím není ověřena.

Distribuce a ověření

EXE je přenosný a nevyžaduje oprávnění správce. Nevytváří se instalace ani trvale běžící služba. Distribuční ZIP obsahuje tento návod, ukázkovou MIB, výsledek testu konkrétního EXE, náhled rozhraní a licence. Aplikace není podepsána certifikátem pro podpis kódu.

Zdrojový projekt obsahuje aktuální dokumentaci, testy a postup nového sestavení. Žádné fyzické zařízení ani jeho přihlašovací údaje nebyly při vývoji poskytnuty; síťové ověření probíhá proti místnímu SNMPv3 agentovi přes skutečné UDP.