Merge pull request #173 from cisco-en-programmability/develop

Develop

changelogs/changelog.yaml

@@ -880,6 +880,7 @@ releases:
           - site_workflow_manager - Updated changes in Site updation.
           - network_settings_workflow_manager - Added attributes 'ipv4_global_pool_name'.
           - template_workflow_manager - Removed attributes 'create_time', 'failure_policy', 'last_update_time', 'latest_version_time', 'parent_template_id', 'project_id', 'validation_errors', 'rollback_template_params' and 'rollback_template_content'.
+          - ise_radius_integration_workflow_manager - Removed the attributes 'port' and 'subscriber_name'. Added the attribute 'ise_integration_wait_time'.
           - Changes in inventory and swim workflow manager modules.
           - application_policy_application_set_count_info - new module
           - application_policy_application_set_info - new module
@@ -914,4 +915,20 @@ releases:
       changes:
         release_summary: Fix module name.
         minor_changes:
-          - Fix module name from network_device_config__info to configuration_archive_details_info.
+          - Fix module name from network_device_config__info to configuration_archive_details_info.
+  6.16.0:
+      release_date: "2024-06-07"
+      changes:
+        release_summary: Code changes in workflow manager modules. 
+        minor_changes:
+          - Added example playbooks in device_provision_workflow.yml
+          - Added API to validate the server address
+          - Minor bug fixes in device_credential_workflow_manager.py module
+          - Checking SNMP versions in events_and_notifications_workflow_manager.py module
+          - Added new attribute 'ise_integration_wait_time' in ise_radius_integration_workflow_manager.py
+          - Added example playbooks in network_compliance_workflow_manager.py
+          - Added detailed documentation in network_settings_workflow_manager.py
+          - Added the code for creating/updating/deleting events subscription notification with specified destination and added the playbook and documentation with examples
+          - provision_workflow_manager.py - Added attribute 'provisioning'
+          - template_workflow_manager.py - Added attributes 'choices', 'failure_policy'
+          - events_and_notifications_workflow_manager.py - Added attributes 'webhook_event_notification', 'email_event_notification', 'syslog_event_notification'

galaxy.yml

@@ -1,7 +1,7 @@
 ---
 namespace: cisco
 name: dnac
-version: 6.15.0
+version: 6.16.0
 readme: README.md
 authors:
   - Rafael Campos <rcampos@altus.cr>

playbooks/device_provision_workflow.yml

@@ -16,18 +16,31 @@
       dnac_port: "{{ dnac_port }}"
       dnac_version: "{{ dnac_version }}"
       dnac_debug: "{{ dnac_debug }}"
+      dnac_log_level: "{{ dnac_log_level }}"
 
   tasks:
-    - name: Provision a wired device to a site
+    - name: Assign a wired device to a site
       cisco.dnac.provision_workflow_manager:
         <<: *dnac_login
         dnac_log: True
         state: merged
         config_verify: True
         config:
-          - site_name_hierarchy: Global/USA/San Francisco/BGL_18
-            management_ip_address: 204.1.2.2
+          - site_name_hierarchy: Global/USA/New York/NY_BLD1
+
+            management_ip_address: 204.192.3.40
+            provisioning: false
 
+    - name: Provision a wired device to a site
+      cisco.dnac.provision_workflow_manager:
+        <<: *dnac_login
+        dnac_log: True
+        dnac_log_level: DEBUG
+        state: merged
+        config_verify: True
+        config:
+          - site_name_hierarchy: Global/USA/SAN JOSE/BLD23/BLD20_FLOOR2
+            management_ip_address: 204.192.3.40
 
     - name: Unprovision a wired device from a site
       cisco.dnac.provision_workflow_manager:
@@ -36,3 +49,16 @@
         state: deleted
         config:
           - management_ip_address: 204.1.2.2
+
+    - name: Provision a wireless device to a site
+      cisco.dnac.provision_workflow_manager:
+        <<: *dnac_login
+        dnac_log: True
+        dnac_log_level: DEBUG
+        state: merged
+        config_verify: True
+        config:
+          - site_name_hierarchy: Global/USA/RTP/BLD11
+            management_ip_address: 204.192.12.201
+            managed_ap_locations:
+              - Global/USA/RTP/BLD11/BLD11_FLOOR1

playbooks/events_and_notifications_workflow_manager.yml

@@ -21,13 +21,7 @@
         config_verify: true
         state: merged
         config:
-        - syslog_destination:
-            name: "{{item.syslog_destination.name}}"
-            description: "{{item.syslog_destination.description}}"
-            server_address: "{{item.syslog_destination.server_address}}"
-            protocol: "{{item.syslog_destination.protocol}}"
-            port: "{{item.syslog_destination.port}}"
-          webhook_destination:
+        - webhook_destination:
             name: "{{item.webhook_destination.name}}"
             description: "{{item.webhook_destination.description}}"
             url: "{{item.webhook_destination.url}}"
@@ -40,6 +34,13 @@
             primary_smtp_config:
               server_address: "{{item.email_destination.primary_smtp_config.server_address}}"
               port: "{{item.email_destination.primary_smtp_config.port}}"
+              username: "{{item.email_destination.primary_smtp_config.username}}"
+          syslog_destination:
+            name: "{{item.syslog_destination.name}}"
+            description: "{{item.syslog_destination.description}}"
+            server_address: "{{item.syslog_destination.server_address}}"
+            protocol: "{{item.syslog_destination.protocol}}"
+            port: "{{item.syslog_destination.port}}"
           snmp_destination:
             name: "{{item.snmp_destination.name}}"
             description: "{{item.snmp_destination.description}}"
@@ -59,6 +60,28 @@
               url: "{{item.itsm_setting.connection_settings.url}}"
               username: "{{item.itsm_setting.connection_settings.username}}"
               password: "{{item.itsm_setting.connection_settings.password}}"
+          webhook_event_notification:
+            name: "{{item.webhook_event_notification.name}}"
+            description: "{{item.webhook_event_notification.description}}"
+            sites: "{{item.webhook_event_notification.sites}}"
+            events: "{{item.webhook_event_notification.events}}"
+            destination: "{{item.webhook_event_notification.destination}}"
+          email_event_notification:
+            name: "{{item.email_event_notification.name}}"
+            description: "{{item.email_event_notification.description}}"
+            sites: "{{item.email_event_notification.sites}}"
+            events: "{{item.email_event_notification.events}}"
+            sender_email: "{{item.email_event_notification.sender_email}}"
+            recipient_emails: "{{item.email_event_notification.recipient_emails}}"
+            subject: "{{item.email_event_notification.subject}}"
+            instance: "{{item.email_event_notification.instance}}"
+            instance_description: "{{item.email_event_notification.instance_description}}"
+          syslog_event_notification:
+            name: "{{item.syslog_event_notification.name}}"
+            description: "{{item.syslog_event_notification.description}}"
+            sites: "{{item.syslog_event_notification.sites}}"
+            events: "{{item.syslog_event_notification.events}}"
+            destination: "{{item.syslog_event_notification.destination}}"
 
       with_items: "{{ events_notification }}"
       tags:

playbooks/ise_radius_integration_workflow_manager.yml

@@ -29,7 +29,6 @@
             message_authenticator_code_key: dnacisesolutions1234 # For KEYWRAP, must be 20 char long
             authentication_port: 1800
             accounting_port: 1700
-            port: 40 # For TACACS
             retries: 3 # Range from 1 to 3
             timeout: 4 # Range from 2 to 20
             role: secondary
@@ -77,7 +76,6 @@
             message_authenticator_code_key: dnacisesolutions1234 # For KEYWRAP, must be 20 char long
             authentication_port: 1800
             accounting_port: 1700
-            port: 40 # For TACACS
             retries: 3 # Range from 1 to 3
             timeout: 4 # Range from 2 to 20
             role: primary
@@ -88,9 +86,9 @@
               password: abcd
               fqdn: abc.cisco.com
               ip_address: 10.195.243.59
-              subscriber_name: abcde
               description: CISCO ISE
             trusted_server: True
+            ise_integration_wait_time: 20
 
     - name: Delete an ISE Server.
       cisco.dnac.ise_radius_integration_workflow_manager:

playbooks/network_settings_workflow_manager.yml

@@ -61,16 +61,16 @@
             site_name: Global/Chennai
             settings:
               network_aaa: #works only if we system settigns is set
-                ip_address: 10.0.0.21 #Mandatory for ISE, sec ip for AAA
-                network: 10.0.0.20
+                primary_server_address: 10.0.0.20 #Mandatory for AAA and ISE
+                secondary_server_address: 10.0.0.21
                 protocol: TACACS
-                servers: AAA
+                server_type: AAA
                 # shared_secret: string #ISE
               client_and_endpoint_aaa: #works only if we system settigns is set
-                ip_address: 10.197.156.42 #Mandatory for ISE, sec ip for AAA
-                network: 10.0.0.20
+                primary_server_address: 10.197.156.42 #Mandatory for AAA and ISE
+                secondary_server_address: 10.0.0.21
                 protocol: RADIUS                                     
-                servers: AAA
+                server_type: AAA
                 # shared_secret: string #ISE
               dhcp_server:
               - 10.0.0.1
@@ -83,7 +83,7 @@
               timezone: GMT
               message_of_the_day:
                 banner_message: hello
-                retain_existing_banner: 'true'
+                retain_existing_banner: True
               netflow_collector:
                 ip_address: 10.0.0.4
                 port: 443

playbooks/template_workflow_manager.yml

@@ -29,7 +29,6 @@
             version_description: "{{ item.description }}"
             language: "{{ item.language }}"
             software_type: "{{ item.type }}"
-            software_variant: "{{ item.variant }}"
             device_types:
             - product_family: "{{ item.family }}"
           export: