Aller au contenu

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

bogolang
EN

← Exemples

acl_test

Demande à une liste d'accès si des flux passeraient, avec la ligne qui a décidé. Il ne devine jamais.

Lit la configuration enregistrée edge-rt1.cfg et demande à sa liste d'accès OUTSIDE-IN si certains flux passeraient. Chaque réponse vient avec la ligne qui l'a décidée. Le test ne devine jamais : deux flux rencontrent une ligne qu'il ne peut pas juger avec certitude (established, et un type ICMP), et le tableau le dit et nomme cette ligne. Aucun équipement n'est contacté.

bogo run acl_test.bogo
bogo test acl_test.bogo

Pour l'utiliser sur votre propre réseau :

  • Mettez une configuration enregistrée de votre routeur dans le dossier et son nom dans config_file.
  • Mettez le nom ou le numéro de la liste d'accès dans list_name.
  • Écrivez vos propres flux dans flows. Un port à 0 veut dire que le flux n'en a pas, comme pour ICMP.
  • Les listes IOS et IOS-XE sont lues, standard et étendues, IPv4 seulement.
acl_test.bogo
edition 2027
"""Would the access list on the internet uplink let these flows in? Reads a saved configuration."""


class AclTest:
    """Ask the list OUTSIDE-IN about a few flows and print each answer with the line
    that decided it. When the test cannot be sure, it says so and names the line."""

    config_file: str = "edge-rt1.cfg"
    list_name: str = "OUTSIDE-IN"
    # name, source, destination, protocol, destination port (0 when there is none)
    flows: list[tuple[str, IP, IP, str, int]] = [
        ("web", 203.0.113.50, 198.51.100.10, "tcp", 443),
        ("dns", 203.0.113.50, 198.51.100.20, "udp", 53),
        ("sip from a blocked range", 192.0.2.10, 198.51.100.30, "tcp", 5060),
        ("sip", 203.0.113.60, 198.51.100.30, "tcp", 5061),
        ("voice media", 203.0.113.60, 198.51.100.30, "udp", 16000),
        ("ntp", 203.0.113.60, 198.51.100.99, "udp", 123),
        ("ssh to the web server", 203.0.113.60, 198.51.100.10, "tcp", 22),
        ("ping the web server", 203.0.113.60, 198.51.100.10, "icmp", 0),
    ]

    @staticmethod
    def ask(rules: Acl, src: IP, dst: IP, protocol: str, port: int) -> tuple[str, str]:
        """The answer in one word, and the line that decided or the reason there is no answer."""
        try:
            v: Verdict = rules.permits(src, dst, port=port, protocol=protocol)
        except AclError as e:
            return "CANNOT SAY", str(e)
        return ("permitted" if v else "denied"), (
            f"line {v.number}: {v.line}" if v.number else v.line
        )

    @staticmethod
    def main(args: list[str]) -> None:
        cfg: Config = load_config(AclTest.config_file, platform="iosxe")
        rules: Acl = acl(cfg, AclTest.list_name)
        print(f"{rules.name} on {cfg.hostname}: {len(rules.lines)} lines")
        rows: list[dict[str, str]] = []
        for name, src, dst, protocol, port in AclTest.flows:
            answer, why = AclTest.ask(rules, src, dst, protocol, port)
            service: str = f"{protocol}/{port}" if port else protocol
            rows.append(
                {
                    "flow": name,
                    "from": str(src),
                    "to": str(dst),
                    "service": service,
                    "answer": answer,
                    "why": why,
                }
            )
        table(rows)


class TestAclTest:
    text: str = (
        "hostname t\n!\nip access-list extended T\n"
        " 10 permit tcp any host 192.0.2.10 eq 443\n"
        " 20 permit tcp any any established\n!\nend\n"
    )

    def rules(self) -> Acl:
        cfg: Config = Config(Device(name="t", ip=192.0.2.1, platform="iosxe"), self.text, "")
        return acl(cfg, "T")

    def test_a_permit_names_its_line(self) -> None:
        answer, why = AclTest.ask(self.rules(), 203.0.113.5, 192.0.2.10, "tcp", 443)
        assert answer == "permitted"
        assert why == "line 1: permit tcp any host 192.0.2.10 eq 443"

    def test_a_line_it_cannot_judge_is_never_guessed(self) -> None:
        answer, why = AclTest.ask(self.rules(), 203.0.113.5, 192.0.2.10, "tcp", 22)
        assert answer == "CANNOT SAY"
        assert "established" in why

    def test_other_traffic_meets_the_implicit_deny(self) -> None:
        answer, why = AclTest.ask(self.rules(), 203.0.113.5, 192.0.2.10, "udp", 53)
        assert (answer, why) == ("denied", "implicit deny")