Aller au contenu

La version 0.1.0 est une première version, à l'essai. Voir ce qui n'est pas prouvé →

bogolang
EN

← Documentation

Non prouvé

Ce qui n'a jamais été essayé sur du vrai matériel, dit simplement.

Toutes les pages de documentation

Cette page liste, simplement, ce qui n'a jamais été essayé sur du vrai matériel ou sur d'autres machines. Chaque partie de Bogolang a des tests automatiques, mais la plupart des tests s'exécutent sur des réponses enregistrées écrites pour eux, ou sur la machine elle-même (127.0.0.1). Un test prouve que le code fait ce que son auteur attendait ; seul un essai prouve qu'un équipement répond comme prévu. Lisez cette page avant de faire confiance à une commande sur un réseau qui compte.

La version 0.1.0 est une première version, à l'essai.

Ce qui a été essayé sur du vrai matériel

Pour que les listes ci-dessous se lisent dans leur juste proportion, voici ce qui a rencontré le monde réel :

  • Un commutateur Cisco IOS-XE 17.8.1 : show version par une session, des requêtes get SNMPv3 et un walk (SHA et AES), deux instantanés comparés, une recherche de route, des événements de journal et des voisins CDP lus.
  • Un vrai changement, sur un commutateur d'accès IOS-XE 03.06 : une description sur un port inutilisé, avec un verify faux exprès (le retour arrière a été envoyé), puis un ajout et une suppression.
  • Une organisation Meraki lue par l'API Dashboard, et un inventaire lu depuis l'API d'un système de supervision.
  • Junos 26.2 sur des commutateurs virtuels : collecte en lecture seule, les lecteurs, et un bloc change avec commit confirmed.
  • ping, trace et « ne pas fragmenter » vers une adresse publique, depuis Windows et depuis Linux, avec des routeurs sur le chemin qui répondent ; marquages DSCP vérifiés à l'arrivée.

Équipements et sessions

  • Plateformes jamais rencontrées pour de vrai : NX-OS, AireOS, ASA, IOS 15, et Junos sur du vrai matériel. Leurs sorties dans les tests ont été écrites à la main.
  • Non essayé sur un équipement : l'étape enable, .table() sur une réponse en direct, une boucle parallèle sur plusieurs vrais équipements.
  • L'hôte de rebond (ssh(d, via=jump)) n'a pas rencontré de vrai serveur de rebond.
  • La console série n'a pas rencontré de vrai port console.
  • RESTCONF n'a pas rencontré de vrai équipement. NETCONF n'est pas construit.
  • optics n'a pas lu de vrai émetteur-récepteur, ni sur IOS ni sur Junos. Son lecteur a été écrit d'après la forme connue de la commande ; une autre version peut formuler son tableau autrement et ne donner aucun relevé.
  • snapshot et compare n'ont pas trouvé de vrai changement sur un équipement, ni lu un ASA, un équipement avec CDP désactivé, ou un routeur avec des VRF (la commande simple ne lit que la table globale).
  • SNMP version 2c n'a pas été essayé sur un équipement.
  • L'objet de configuration et les règles d'audit ont été testés sur des configurations écrites pour les tests. Surveillez une bannière dont le texte contient sa propre marque de fin, de longues listes de VLAN coupées sur plusieurs lignes, et les mises en page d'ASA et de NX-OS.
  • Aucun programme sous la forme de classe ne s'est exécuté contre un équipement. Les treize exemples se sont exécutés sur des réponses enregistrées écrites à la main.

Changements

  • revert_after : les commandes de minuterie de l'équipement n'ont jamais été acceptées par un vrai équipement IOS. Vérifiez-les sur la version exacte avant de leur faire confiance.
  • Pas vu pour de vrai : un équipement qui refuse une ligne, une session perdue pendant un changement, Ctrl+C sur un vrai équipement, un changement sur ASA ou NX-OS.
  • Quand un équipement refuse une ligne parmi plusieurs, le journal d'exécution marque toutes les lignes apply comme échouées. Il ne montre pas lesquelles sont passées avant celle qui a été refusée. Le retour arrière est envoyé dans tous les cas.
  • Un avertissement de l'équipement qui n'est pas un refus n'est pas remarqué. Les lignes verify sont le vrai test.
  • Sur IOS, les lignes apply sont envoyées sans test de leur premier mot.
  • Sur Junos : une seule version, sur un commutateur virtuel seulement. La garde de 30 secondes, une session perdue et Ctrl+C n'ont été essayés que dans les tests.
  • Les règles arrêtent les accidents. Elles ne sont pas un mur de sécurité. La vraie limite est ce que le compte de l'équipement a le droit de faire.

Joignabilité

Non prouvé, car chacun demande un vrai chemin :

  • une trace en IPv6 au-delà de ::1 ;
  • un routeur qui répond « ne peut pas être atteint » ;
  • des réponses venant d'une autre machine à travers le pare-feu Windows ;
  • un ping marqué DSCP sous Windows sur un autre PC que celui où il a été essayé (il a besoin d'une socket brute, que Windows peut refuser à un utilisateur ordinaire) ;
  • « ne pas fragmenter » sous Windows au-delà du fait que Windows l'accepte (Windows ne dit pas la limite du chemin) ;
  • l'étape de l'installateur Linux pour le réglage du ping avec une vraie personne au clavier. Elle a été essayée avec un outil qui tapait les réponses. Le chemin où un conteneur ne prend que la valeur plus étroite n'a pas été exécuté en entier.

Journaux, écouteurs et surveillance

  • Aucun équipement n'a envoyé de message syslog, de trap ou d'enregistrement NetFlow à Bogolang. Les paquets des tests suivent les formes publiées ; les vrais fabricants les tordent.
  • Aucun programme n'a écouté sur le port 514 ou 162 ; les tests utilisent des ports hauts.
  • La vitesse de NetFlow face à un exportateur chargé n'est pas mesurée.
  • watch n'a pas dessiné sur un vrai terminal (la console Windows, Windows Terminal). Ctrl+C sur un programme qui écoute ou surveille n'a pas été pressé sur un vrai clavier.
  • Les événements de journal, les recherches de route et la topologie ont lu un seul vrai équipement. D'autres versions peuvent montrer des formes que les tests n'ont pas, surtout les horodatages des journaux et les noms de ports qu'annoncent les voisins LLDP.
  • Aucun fichier de capture fait par un vrai outil n'a été lu. Les fichiers de test ont été construits à partir des documents de format.

Courriel, rapports et autres services

  • mail n'a pas parlé à un vrai serveur de courriel.
  • Aucun rapport PDF n'a été fait. La conversion a besoin de Microsoft Word ou de LibreOffice.
  • Aucun webhook n'a été posté vers un vrai service.
  • Les vérifications de services (dns_check, ntp_check, http_check, cert_check, sip_check) n'ont pas rencontré de vrai serveur, de vrai magasin de certificats ni de vrai équipement SIP.
  • mos est une estimation tirée d'un modèle simplifié, pas une mesure.

Installation et outils

  • Un PC sans aucun Python. Les deux installateurs ont été prouvés sur des machines qui ont d'autres Python, ce qui est le cas le plus difficile pour l'isolation. Un PC vierge n'a pas été essayé.
  • Les pages de l'installateur Windows telles qu'une personne les voit. L'installateur a été exécuté sans ses fenêtres. Les entrées de menu ont été lues et leurs commandes exécutées, pas cliquées.
  • Un Linux de la famille Red Hat. Seuls Ubuntu et Debian ont été essayés.
  • Un Linux plus ancien que les systèmes de test. Les objdump et objcopy embarqués n'ont besoin de rien du système, mais le moteur a besoin de sa bibliothèque C.
  • L'installateur Linux sur une machine sans réseau, et son entrée de menu sur un vrai bureau.
  • Les exemples et ces pages dans un installateur construit. La construction les embarque ; personne ne les a ouverts dans une copie installée.
  • bogo shell à un vrai clavier. Il a été essayé avec des lignes qu'on lui fournissait : l'édition de ligne et Ctrl+C sur une ligne en cours ne sont pas prouvés.
  • bogo pack : un programme empaqueté qui ouvre une vraie session ; --login tapé au clavier dans un fichier empaqueté ; un projet empaqueté avec des paquets ajoutés par bogo add ; un fichier empaqueté avec des écouteurs, watch, un rapport ou un graphique ; des antivirus autres que celui de Windows.
  • Un projet sur un autre moteur que celui que Bogolang embarque, dans l'organisation installée.
  • bogo pack et le code des ressources propres n'ont pas de tests indépendants, écrits par quelqu'un d'autre que leur auteur.
  • La taille de l'installation Linux (environ 444 MB, contre environ 264 MB sous Windows) n'a pas été examinée.
  • Python 3.15 : la liste de la nouvelle syntaxe qui a été essayée (lazy import, le dépaquetage dans les compréhensions, frozendict) n'a pas été comparée avec le document complet « What's new in Python 3.15 ».

Limites connues, pas des défauts

Ce ne sont pas des lacunes dans les essais ; c'est ainsi que Bogolang fonctionne aujourd'hui :

  • Le test de liste d'accès lit la liste, pas l'équipement : il ne sait pas où une liste est appliquée ni dans quel sens. Il ne sait rien des listes ASA, des listes IPv6 et des groupes d'objets.
  • Les écouteurs ne prennent qu'IPv4 et UDP, pas de trap version 3, pas de sFlow.
  • == entre deux unités différentes vaut False, et n'est pas refusé avant l'exécution (types-and-units.md).