catalystwan 0.41.2__py3-none-any.whl → 0.41.2.dev0__py3-none-any.whl

catalystwan/integration_tests/feature_profile/sdwan/test_system.py

@@ -0,0 +1,368 @@
+# Copyright 2024 Cisco Systems, Inc. and its affiliates
+import unittest
+from typing import List
+
+from catalystwan.api.configuration_groups.parcel import Global
+from catalystwan.integration_tests.base import IS_API_20_12, TestCaseBase, create_name_with_run_id
+from catalystwan.models.configuration.feature_profile.sdwan.system import (
+    BannerParcel,
+    BasicParcel,
+    BFDParcel,
+    DeviceAccessIPv4Parcel,
+    DeviceAccessIPv6Parcel,
+    GlobalParcel,
+    LoggingParcel,
+    MRFParcel,
+    NtpParcel,
+    OMPParcel,
+    SecurityParcel,
+    SNMPParcel,
+)
+from catalystwan.models.configuration.feature_profile.sdwan.system.aaa import DEFAULT_USER_PRIVILEGE, AAAParcel
+from catalystwan.models.configuration.feature_profile.sdwan.system.security import IntegrityType
+
+
+class TestAAAParcel(TestCaseBase):
+    def setUp(self) -> None:
+        self.api = self.session.api.sdwan_feature_profiles.system
+        self.profile_id = self.api.create_profile("TestProfileService", "Description").id
+        self.config_id = self.session.api.config_group.create("TestConfigGroup", "Descr", "sdwan", [self.profile_id]).id
+
+    def test_simple_create(self):
+        # Arrange
+        parcel = AAAParcel.new("aaa-name", ["local"])
+        parcel.add_user("admin", "admin")
+        parcel_id = self.api.create_parcel(self.profile_id, parcel).id
+        parcel = self.api.get_parcel(self.profile_id, AAAParcel, parcel_id).payload
+
+        assert parcel.parcel_name == "aaa-name"
+        assert parcel.server_auth_order.value == ["local"]
+        assert len(parcel.user) == 1
+        assert parcel.user[0].name.value == "admin"
+        assert parcel.user[0].privilege.value == DEFAULT_USER_PRIVILEGE
+
+    def test_adding_user_to_existing_parcel(self):
+        # Arrange
+        parcel = AAAParcel.new("aaa-test", ["local"])
+        parcel.add_user("admin", "admin")
+        parcel_id = self.api.create_parcel(self.profile_id, parcel).id
+
+        parcel = self.api.get_parcel(self.profile_id, AAAParcel, parcel_id).payload
+
+        assert len(parcel.user) == 1
+
+        # Act
+        parcel.add_user("user1", "pass1")
+
+        self.api.update_parcel(self.profile_id, parcel, parcel_id)
+        parcel = self.api.get_parcel(self.profile_id, AAAParcel, parcel_id).payload
+
+        assert len(parcel.user) == 2
+
+    def test_set_server_auth_order_to_exitsing_parcel(self):
+        # Arrange
+        parcel = AAAParcel.new("aaa-test", ["local"])
+        parcel.add_user("admin", "admin")
+        parcel_id = self.api.create_parcel(self.profile_id, parcel).id
+
+        parcel = self.api.get_parcel(self.profile_id, AAAParcel, parcel_id).payload
+
+        # Act
+        parcel.set_server_auth_order(["local", "test"])
+
+        self.api.update_parcel(self.profile_id, parcel, parcel_id)
+        parcel = self.api.get_parcel(self.profile_id, AAAParcel, parcel_id).payload
+
+        # Assert
+        assert len(parcel.server_auth_order.value) == 2
+
+    def tearDown(self) -> None:
+        self.session.api.config_group.delete(self.config_id)
+        self.api.delete_profile(self.profile_id)
+
+
+class TestSystemFeatureProfileModels(TestCaseBase):
+    @classmethod
+    def setUpClass(cls) -> None:
+        super().setUpClass()
+        cls.api = cls.session.api.sdwan_feature_profiles.system
+        cls.profile_uuid = cls.api.create_profile(create_name_with_run_id("TestProfileService"), "Description").id
+
+    @classmethod
+    def tearDownClass(cls) -> None:
+        cls.api.delete_profile(cls.profile_uuid)
+        super().tearDownClass()
+
+    def test_when_default_values_banner_parcel_expect_successful_post(self):
+        # Arrange
+        banner_parcel = BannerParcel(
+            parcel_name="BannerDefault",
+            parcel_description="Banner Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, banner_parcel).id
+        # Assert
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, BannerParcel, parcel_id)
+
+    def test_when_fully_specified_banner_parcel_expect_successful_post(self):
+        # Arrange
+        banner_parcel = BannerParcel(
+            parcel_name="BannerFullySpecified",
+            parcel_description="Banner Parcel",
+        )
+        banner_parcel.add_login("Login")
+        banner_parcel.add_motd("Hello! Welcome to the network!")
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, banner_parcel).id
+        # Assert
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, BannerParcel, parcel_id)
+
+    def test_when_default_values_logging_parcel_expect_successful_post(self):
+        # Arrange
+        logging_parcel = LoggingParcel(
+            parcel_name="LoggingDefault",
+            parcel_description="Logging Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, logging_parcel).id
+        # Assert
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, LoggingParcel, parcel_id)
+
+    def test_when_fully_specified_logging_parcel_expect_successful_post(self):
+        # Arrange
+        logging_parcel = LoggingParcel(
+            parcel_name="LoggingFullySpecified",
+            parcel_description="Logging Parcel",
+        )
+        logging_parcel.set_disk(
+            enable=True,
+            disk_file_rotate=10,
+            disk_file_size=10,
+        )
+        logging_parcel.add_tls_profile(
+            profile="TLSProfile",
+            version="TLSv1.2",
+            ciphersuite_list=[
+                "aes-256-cbc-sha",
+                "aes-128-cbc-sha",
+                "ecdhe-ecdsa-aes-gcm-sha2",
+                "ecdhe-rsa-aes-cbc-sha2",
+            ],
+        )
+        logging_parcel.add_ipv4_server(
+            name="Server1",
+            vpn=0,
+            source_interface="fastethernet1/0",
+            priority="debugging",
+            enable_tls=True,
+            custom_profile=True,
+            profile_properties="TLSProfile",
+        )
+        logging_parcel.add_ipv6_server(
+            name="Server2",
+            vpn=0,
+            source_interface="fastethernet1/1",
+            priority="debugging",
+            enable_tls=True,
+            custom_profile=True,
+            profile_properties="TLSProfile",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, logging_parcel).id
+        # Assert
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, LoggingParcel, parcel_id)
+
+    def test_when_default_values_bfd_parcel_expect_successful_post(self):
+        # Arrange
+        bfd_parcel = BFDParcel(
+            parcel_name="BFDDefault",
+            parcel_description="BFD Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, bfd_parcel).id
+        # Assert
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, BFDParcel, parcel_id)
+
+    def test_when_fully_specified_bfd_parcel_expect_successful_post(self):
+        # Arrange
+        bfd_parcel = BFDParcel(
+            parcel_name="BFDFullySpecified",
+            parcel_description="BFD Parcel",
+        )
+        bfd_parcel.set_muliplier(1)
+        bfd_parcel.set_poll_interval(700000)
+        bfd_parcel.set_default_dscp(51)
+        bfd_parcel.add_color(color="lte", hello_interval=300000, multiplier=7, pmtu_discovery=False)
+        bfd_parcel.add_color(color="mpls", pmtu_discovery=False)
+        bfd_parcel.add_color(color="biz-internet")
+        bfd_parcel.add_color(color="public-internet")
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, bfd_parcel).id
+        # Assert
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, BFDParcel, parcel_id)
+
+    def test_when_default_values_basic_parcel_expect_successful_post(self):
+        # Arrange
+        basic_parcel = BasicParcel(
+            parcel_name="BasicDefault",
+            parcel_description="Basic Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, basic_parcel).id
+        # Assert
+        assert parcel_id
+
+    def test_when_default_values_security_parcel_expect_successful_post(self):
+        # Arrange
+        security_parcel = SecurityParcel(
+            parcel_name="SecurityDefault",
+            parcel_description="Security Parcel",
+            integrity_type=Global[List[IntegrityType]](value=["ip-udp-esp"]),
+        )
+
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, security_parcel).id
+        # Assert
+        assert parcel_id
+
+    def test_when_default_values_ntp_parcel_expect_successful_post(self):
+        # Arrange
+        ntp_parcel = NtpParcel(
+            parcel_name="NTPDefault",
+            parcel_description="NTP Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, ntp_parcel).id
+        # Assert
+        assert parcel_id
+
+    def test_when_default_values_global_parcel_expect_successful_post(self):
+        # Arrange
+        global_parcel = GlobalParcel(
+            parcel_name="GlobalDefault",
+            parcel_description="Global Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, global_parcel).id
+        # Assert
+        assert parcel_id
+
+    @unittest.skipIf(
+        IS_API_20_12,
+        "Region is not allowed to be configured when the setting"
+        "(Administration -> Settings -> Multi-Region Fabric) is disabled."
+        "Once Multi-Region Fabric is enabled, it cannot be disabled but "
+        "all the configuration related to that can be removed manually.",
+    )
+    def test_when_default_values_mrf_parcel_expect_successful_post(self):
+        # Arrange
+        mrf_parcel = MRFParcel(
+            parcel_name="MRFDefault",
+            parcel_description="MRF Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, mrf_parcel).id
+        # Assert
+        assert parcel_id
+
+    def test_when_default_values_snmp_parcel_expect_successful_post(self):
+        # Arrange
+        snmp_parcel = SNMPParcel(
+            parcel_name="SNMPDefault",
+            parcel_description="SNMP Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, snmp_parcel).id
+        # Assert
+        assert parcel_id
+
+    def test_when_default_values_omp_parcel_expect_successful_post(self):
+        # Arrange
+        omp_parcel = OMPParcel(
+            parcel_name="OMPDefault",
+            parcel_description="OMP Parcel",
+        )
+        # Act
+        parcel_id = self.api.create_parcel(self.profile_uuid, omp_parcel).id
+        # Assert
+        assert parcel_id
+
+    def test_when_default_values_device_access_parcel_expect_successful_post(self):
+        device_access_parcel = DeviceAccessIPv4Parcel(
+            parcel_name="DeviceAccessDefault",
+            parcel_description="DeviceAccessDefault",
+        )
+
+        parcel_id = self.api.create_parcel(self.profile_uuid, device_access_parcel).id
+
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, DeviceAccessIPv4Parcel, parcel_id)
+
+    def test_when_fully_specified_device_access_parcel_expect_successful_post(self):
+        device_access_parcel = DeviceAccessIPv4Parcel(
+            parcel_name="DeviceAccessDefault",
+            parcel_description="DeviceAccessDefault",
+        )
+        for i in range(2):
+            sequence = device_access_parcel.add_sequence(
+                id_=i + 1,
+                name=f"sequence_{i+1}",
+                destination_port=22,
+                base_action="accept",
+            )
+            sequence.match_destination_data_prefixes(["10.0.0.1/32", "10.0.0.0/16"])
+            sequence.match_source_data_prefixes(["10.0.0.1/32", "10.0.0.0/16"])
+            sequence.match_source_ports([1, 2, 3])
+
+        parcel_id = self.api.create_parcel(self.profile_uuid, device_access_parcel).id
+
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, DeviceAccessIPv4Parcel, parcel_id)
+
+    def test_when_default_values_device_access_ipv6_parcel_expect_successful_post(self):
+        device_access_ipv6_parcel = DeviceAccessIPv6Parcel(
+            parcel_name="DeviceAccessDefault",
+            parcel_description="DeviceAccessDefault",
+        )
+
+        parcel_id = self.api.create_parcel(self.profile_uuid, device_access_ipv6_parcel).id
+
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, DeviceAccessIPv6Parcel, parcel_id)
+
+    def test_when_fully_specified_device_access_ipv6_parcel_expect_successful_post(self):
+        device_access_ipv6_parcel = DeviceAccessIPv6Parcel(
+            parcel_name="DeviceAccessDefault",
+            parcel_description="DeviceAccessDefault",
+        )
+        for i in range(2):
+            sequence = device_access_ipv6_parcel.add_sequence(
+                id_=i + 1,
+                name=f"sequence_{i+1}",
+                destination_port=22,
+                base_action="accept",
+            )
+            sequence.match_destination_data_prefixes(["::250/100", "::54a/64"])
+            sequence.match_source_data_prefixes(["::250/100", "::54a/64"])
+            sequence.match_source_ports([1, 2, 3])
+
+        parcel_id = self.api.create_parcel(self.profile_uuid, device_access_ipv6_parcel).id
+
+        assert parcel_id
+
+        self.api.delete_parcel(self.profile_uuid, DeviceAccessIPv6Parcel, parcel_id)

catalystwan/integration_tests/feature_profile/sdwan/test_tracker.py

@@ -0,0 +1,127 @@
+# Copyright 2025 Cisco Systems, Inc. and its affiliates
+from catalystwan.api.configuration_groups.parcel import Global
+from catalystwan.api.feature_profile_api import ServiceFeatureProfileAPI, TransportFeatureProfileAPI
+from catalystwan.integration_tests.base import TestCaseBase, create_name_with_run_id
+from catalystwan.models.configuration.feature_profile.common import RefIdItem
+from catalystwan.models.configuration.feature_profile.sdwan.trackers import Tracker, TrackerGroup
+from catalystwan.models.configuration.feature_profile.sdwan.trackers.tracker_group import TrackerRefs
+
+
+class TestTransportFeatureProfileTracker(TestCaseBase):
+    api: TransportFeatureProfileAPI
+
+    @classmethod
+    def setUpClass(cls) -> None:
+        super().setUpClass()
+        cls.api = cls.session.api.sdwan_feature_profiles.transport
+        cls.profile_uuid = cls.api.create_profile(create_name_with_run_id("TestTransportModels"), "Description").id
+
+    def test_create_tracker(self):
+        tracker = Tracker(
+            parcel_name="TestTracker",
+            parcel_description="Test Tracker Description",
+            tracker_name=Global[str](value="TestTracker"),
+            interval=Global[int](value=100),
+            endpoint_api_url=Global[str](value="https://example.com/api"),
+        )
+
+        response = self.api.create_parcel(self.profile_uuid, tracker)
+
+        assert response
+
+    def test_create_tracker_group(self):
+        tracker1 = Tracker(
+            parcel_name="TestTracker1",
+            parcel_description="Test Tracker Description",
+            tracker_name=Global[str](value="TestTracker1"),
+            interval=Global[int](value=100),
+            endpoint_api_url=Global[str](value="https://example.com/api"),
+        )
+
+        tracker2 = Tracker(
+            parcel_name="TestTracker2",
+            parcel_description="Test Tracker Description",
+            tracker_name=Global[str](value="TestTracker2"),
+            interval=Global[int](value=100),
+            endpoint_api_url=Global[str](value="https://example.com/api"),
+        )
+
+        tracker1_uuid = self.api.create_parcel(self.profile_uuid, tracker1).id
+        tracker2_uuid = self.api.create_parcel(self.profile_uuid, tracker2).id
+        tracker_group = TrackerGroup(
+            parcel_name="TestTrackerGroup",
+            parcel_description="Test Tracker Group Description",
+            tracker_refs=[
+                TrackerRefs(tracker_ref=RefIdItem(ref_id=Global[str](value=str(tracker1_uuid)))),
+                TrackerRefs(tracker_ref=RefIdItem(ref_id=Global[str](value=str(tracker2_uuid)))),
+            ],
+        )
+
+        response = self.api.create_parcel(self.profile_uuid, tracker_group)
+
+        assert response
+
+    @classmethod
+    def tearDownClass(cls) -> None:
+        cls.api.delete_profile(cls.profile_uuid)
+        super().tearDownClass()
+
+
+class TestServiceFeatureProfileModels(TestCaseBase):
+    api: ServiceFeatureProfileAPI
+
+    @classmethod
+    def setUpClass(cls) -> None:
+        super().setUpClass()
+        cls.api = cls.session.api.sdwan_feature_profiles.service
+        cls.profile_uuid = cls.api.create_profile(create_name_with_run_id("TestProfileService"), "Description").id
+
+    def test_create_tracker(self):
+        tracker = Tracker(
+            parcel_name="TestTracker",
+            parcel_description="Test Tracker Description",
+            tracker_name=Global[str](value="TestTracker"),
+            interval=Global[int](value=100),
+            endpoint_api_url=Global[str](value="https://example.com/api"),
+        )
+
+        response = self.api.create_parcel(self.profile_uuid, tracker)
+
+        assert response
+
+    def test_create_tracker_group(self):
+        tracker1 = Tracker(
+            parcel_name="TestTracker1",
+            parcel_description="Test Tracker Description",
+            tracker_name=Global[str](value="TestTracker1"),
+            interval=Global[int](value=100),
+            endpoint_api_url=Global[str](value="https://example.com/api"),
+        )
+
+        tracker2 = Tracker(
+            parcel_name="TestTracker2",
+            parcel_description="Test Tracker Description",
+            tracker_name=Global[str](value="TestTracker2"),
+            interval=Global[int](value=100),
+            endpoint_api_url=Global[str](value="https://example.com/api"),
+        )
+
+        tracker1_uuid = self.api.create_parcel(self.profile_uuid, tracker1).id
+        tracker2_uuid = self.api.create_parcel(self.profile_uuid, tracker2).id
+        tracker_group = TrackerGroup(
+            parcel_name="TestTrackerGroup",
+            parcel_description="Test Tracker Group Description",
+            tracker_refs=[
+                TrackerRefs(tracker_ref=RefIdItem(ref_id=Global[str](value=str(tracker1_uuid)))),
+                TrackerRefs(tracker_ref=RefIdItem(ref_id=Global[str](value=str(tracker2_uuid)))),
+            ],
+        )
+
+        response = self.api.create_parcel(self.profile_uuid, tracker_group)
+
+        assert response
+
+    @classmethod
+    def tearDownClass(cls) -> None:
+        cls.api.delete_profile(cls.profile_uuid)
+        super().tearDownClass()