Claude 1

2025-12-09 09:33:48 -06:00
parent 228174e541
commit 4f1e8d3add
55 changed files with 4345 additions and 0 deletions
--- a/sophos-xgs-ansible/roles/sophos_network/tasks/dhcp.yml
+++ b/sophos-xgs-ansible/roles/sophos_network/tasks/dhcp.yml
@@ -0,0 +1,52 @@
+---
+# ============================================================================
+# Configure DHCP Servers
+# ============================================================================
+
+- name: Get current DHCP server configuration from firewall
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController?reqxml=<Request><Login><Username>{{ sophos_api_username }}</Username><Password>{{ sophos_api_password }}</Password></Login><Get><DHCPServer/></Get></Request>"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    return_content: true
+    status_code: [200]
+  register: current_dhcp_servers
+  no_log: "{{ sophos_no_log_sensitive }}"
+  tags: ['dhcp']
+
+- name: Parse current DHCP server names
+  ansible.builtin.set_fact:
+    existing_dhcp_servers: "{{ current_dhcp_servers.content | regex_findall('<Name>(.*?)</Name>') }}"
+  tags: ['dhcp']
+
+- name: Display existing DHCP servers
+  ansible.builtin.debug:
+    msg: "Found {{ existing_dhcp_servers | length }} existing DHCP servers: {{ existing_dhcp_servers | join(', ') }}"
+  tags: ['dhcp']
+
+# Loop through each DHCP server and configure it
+- name: Configure DHCP server {{ item.name }}
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    body: "reqxml={{ lookup('template', 'dhcp_server.json.j2') | urlencode }}"
+    status_code: [200, 201]
+    timeout: "{{ sophos_api_timeout }}"
+  loop: "{{ sophos_dhcp_servers }}"
+  loop_control:
+    label: "{{ item.name }} ({{ item.interface }})"
+  register: dhcp_result
+  no_log: "{{ sophos_no_log_sensitive }}"
+  changed_when: "'successful' in dhcp_result.content | lower or '200' in dhcp_result.content"
+  failed_when: "'error' in dhcp_result.content | lower"
+  tags: ['dhcp']
+
+- name: Display DHCP server configuration results
+  ansible.builtin.debug:
+    msg: "Configured {{ sophos_dhcp_servers | length }} DHCP servers successfully"
+  tags: ['dhcp']
--- a/sophos-xgs-ansible/roles/sophos_network/tasks/dns.yml
+++ b/sophos-xgs-ansible/roles/sophos_network/tasks/dns.yml
@@ -0,0 +1,43 @@
+---
+# ============================================================================
+# Configure DNS Settings
+# ============================================================================
+
+- name: Get current DNS configuration from firewall
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController?reqxml=<Request><Login><Username>{{ sophos_api_username }}</Username><Password>{{ sophos_api_password }}</Password></Login><Get><DNS/></Get></Request>"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    return_content: true
+    status_code: [200]
+  register: current_dns_config
+  no_log: "{{ sophos_no_log_sensitive }}"
+  tags: ['dns']
+
+- name: Display current DNS forwarders
+  ansible.builtin.debug:
+    msg: "Current DNS configuration retrieved"
+  tags: ['dns']
+
+- name: Configure DNS settings
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    body: "reqxml={{ lookup('template', 'dns_config.json.j2') | urlencode }}"
+    status_code: [200, 201]
+    timeout: "{{ sophos_api_timeout }}"
+  register: dns_result
+  no_log: "{{ sophos_no_log_sensitive }}"
+  changed_when: "'successful' in dns_result.content | lower or '200' in dns_result.content"
+  failed_when: "'error' in dns_result.content | lower"
+  tags: ['dns']
+
+- name: Display DNS configuration result
+  ansible.builtin.debug:
+    msg: "DNS configuration applied successfully"
+  tags: ['dns']
--- a/sophos-xgs-ansible/roles/sophos_network/tasks/interfaces.yml
+++ b/sophos-xgs-ansible/roles/sophos_network/tasks/interfaces.yml
@@ -0,0 +1,52 @@
+---
+# ============================================================================
+# Configure Physical Interfaces
+# ============================================================================
+
+- name: Get current interface configuration from firewall
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController?reqxml=<Request><Login><Username>{{ sophos_api_username }}</Username><Password>{{ sophos_api_password }}</Password></Login><Get><Interface/></Get></Request>"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    return_content: true
+    status_code: [200]
+  register: current_interfaces
+  no_log: "{{ sophos_no_log_sensitive }}"
+  tags: ['interfaces']
+
+- name: Parse current interface names
+  ansible.builtin.set_fact:
+    existing_interfaces: "{{ current_interfaces.content | regex_findall('<Name>(.*?)</Name>') }}"
+  tags: ['interfaces']
+
+- name: Display existing interfaces
+  ansible.builtin.debug:
+    msg: "Found {{ existing_interfaces | length }} existing interfaces: {{ existing_interfaces | join(', ') }}"
+  tags: ['interfaces']
+
+# Loop through each interface and configure it
+- name: Configure physical interface {{ item.name }}
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    body: "reqxml={{ lookup('template', 'interface.json.j2') | urlencode }}"
+    status_code: [200, 201]
+    timeout: "{{ sophos_api_timeout }}"
+  loop: "{{ sophos_interfaces }}"
+  loop_control:
+    label: "{{ item.name }} ({{ item.zone }})"
+  register: interface_result
+  no_log: "{{ sophos_no_log_sensitive }}"
+  changed_when: "'successful' in interface_result.content | lower or '200' in interface_result.content"
+  failed_when: "'error' in interface_result.content | lower"
+  tags: ['interfaces']
+
+- name: Display interface configuration results
+  ansible.builtin.debug:
+    msg: "Configured {{ sophos_interfaces | length }} interfaces successfully"
+  tags: ['interfaces']
--- a/sophos-xgs-ansible/roles/sophos_network/tasks/main.yml
+++ b/sophos-xgs-ansible/roles/sophos_network/tasks/main.yml
@@ -0,0 +1,83 @@
+---
+# ============================================================================
+# Sophos Network Role - Main Tasks
+# ============================================================================
+# This role configures all network-related settings on Sophos XGS firewalls:
+#   - Physical interfaces
+#   - VLAN interfaces
+#   - DHCP servers
+#   - DNS configuration
+#   - Static routes
+# ============================================================================
+
+- name: Display network configuration overview
+  ansible.builtin.debug:
+    msg:
+      - "======================================"
+      - "Configuring Network Settings"
+      - "======================================"
+      - "Firewall: {{ inventory_hostname }}"
+      - "Interfaces: {{ sophos_interfaces | default([]) | length }}"
+      - "VLANs: {{ sophos_vlans | default([]) | length }}"
+      - "DHCP Servers: {{ sophos_dhcp_servers | default([]) | length }}"
+      - "Static Routes: {{ sophos_static_routes | default([]) | length }}"
+  tags: ['always']
+
+# ============================================================================
+# Configure Physical Interfaces
+# ============================================================================
+
+- name: Configure physical interfaces
+  ansible.builtin.include_tasks: interfaces.yml
+  when: sophos_interfaces is defined and sophos_interfaces | length > 0
+  tags: ['interfaces']
+
+# ============================================================================
+# Configure VLAN Interfaces
+# ============================================================================
+
+- name: Configure VLAN interfaces
+  ansible.builtin.include_tasks: vlans.yml
+  when: sophos_vlans is defined and sophos_vlans | length > 0
+  tags: ['vlans']
+
+# ============================================================================
+# Configure DHCP Servers
+# ============================================================================
+
+- name: Configure DHCP servers
+  ansible.builtin.include_tasks: dhcp.yml
+  when: sophos_dhcp_servers is defined and sophos_dhcp_servers | length > 0
+  tags: ['dhcp']
+
+# ============================================================================
+# Configure DNS Settings
+# ============================================================================
+
+- name: Configure DNS settings
+  ansible.builtin.include_tasks: dns.yml
+  when: sophos_dns is defined
+  tags: ['dns']
+
+# ============================================================================
+# Configure Static Routes
+# ============================================================================
+
+- name: Configure static routes
+  ansible.builtin.include_tasks: routes.yml
+  when: sophos_static_routes is defined and sophos_static_routes | length > 0
+  tags: ['routes']
+
+# ============================================================================
+# Summary
+# ============================================================================
+
+- name: Network configuration completed
+  ansible.builtin.debug:
+    msg:
+      - "======================================"
+      - "Network Configuration Complete"
+      - "======================================"
+      - "Firewall: {{ inventory_hostname }}"
+      - "All network settings have been applied."
+  tags: ['always']
--- a/sophos-xgs-ansible/roles/sophos_network/tasks/routes.yml
+++ b/sophos-xgs-ansible/roles/sophos_network/tasks/routes.yml
@@ -0,0 +1,52 @@
+---
+# ============================================================================
+# Configure Static Routes
+# ============================================================================
+
+- name: Get current static route configuration from firewall
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController?reqxml=<Request><Login><Username>{{ sophos_api_username }}</Username><Password>{{ sophos_api_password }}</Password></Login><Get><StaticRoute/></Get></Request>"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    return_content: true
+    status_code: [200]
+  register: current_routes
+  no_log: "{{ sophos_no_log_sensitive }}"
+  tags: ['routes']
+
+- name: Parse current route names
+  ansible.builtin.set_fact:
+    existing_routes: "{{ current_routes.content | regex_findall('<Name>(.*?)</Name>') }}"
+  tags: ['routes']
+
+- name: Display existing static routes
+  ansible.builtin.debug:
+    msg: "Found {{ existing_routes | length }} existing static routes: {{ existing_routes | join(', ') }}"
+  tags: ['routes']
+
+# Loop through each static route and configure it
+- name: Configure static route {{ item.name }}
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    body: "reqxml={{ lookup('template', 'static_route.json.j2') | urlencode }}"
+    status_code: [200, 201]
+    timeout: "{{ sophos_api_timeout }}"
+  loop: "{{ sophos_static_routes }}"
+  loop_control:
+    label: "{{ item.name }} ({{ item.destination }}/{{ item.netmask }} via {{ item.gateway }})"
+  register: route_result
+  no_log: "{{ sophos_no_log_sensitive }}"
+  changed_when: "'successful' in route_result.content | lower or '200' in route_result.content"
+  failed_when: "'error' in route_result.content | lower"
+  tags: ['routes']
+
+- name: Display static route configuration results
+  ansible.builtin.debug:
+    msg: "Configured {{ sophos_static_routes | length }} static routes successfully"
+  tags: ['routes']
--- a/sophos-xgs-ansible/roles/sophos_network/tasks/vlans.yml
+++ b/sophos-xgs-ansible/roles/sophos_network/tasks/vlans.yml
@@ -0,0 +1,52 @@
+---
+# ============================================================================
+# Configure VLAN Interfaces
+# ============================================================================
+
+- name: Get current VLAN configuration from firewall
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController?reqxml=<Request><Login><Username>{{ sophos_api_username }}</Username><Password>{{ sophos_api_password }}</Password></Login><Get><VLANInterface/></Get></Request>"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    return_content: true
+    status_code: [200]
+  register: current_vlans
+  no_log: "{{ sophos_no_log_sensitive }}"
+  tags: ['vlans']
+
+- name: Parse current VLAN names
+  ansible.builtin.set_fact:
+    existing_vlans: "{{ current_vlans.content | regex_findall('<Name>(.*?)</Name>') }}"
+  tags: ['vlans']
+
+- name: Display existing VLANs
+  ansible.builtin.debug:
+    msg: "Found {{ existing_vlans | length }} existing VLANs: {{ existing_vlans | join(', ') }}"
+  tags: ['vlans']
+
+# Loop through each VLAN and configure it
+- name: Configure VLAN interface {{ item.name }}
+  ansible.builtin.uri:
+    url: "https://{{ sophos_mgmt_host }}:{{ sophos_mgmt_port }}/webconsole/APIController"
+    method: POST
+    validate_certs: "{{ sophos_validate_certs }}"
+    headers:
+      Content-Type: "application/x-www-form-urlencoded"
+    body: "reqxml={{ lookup('template', 'vlan.json.j2') | urlencode }}"
+    status_code: [200, 201]
+    timeout: "{{ sophos_api_timeout }}"
+  loop: "{{ sophos_vlans }}"
+  loop_control:
+    label: "{{ item.name }} (VLAN {{ item.vlan_id }})"
+  register: vlan_result
+  no_log: "{{ sophos_no_log_sensitive }}"
+  changed_when: "'successful' in vlan_result.content | lower or '200' in vlan_result.content"
+  failed_when: "'error' in vlan_result.content | lower"
+  tags: ['vlans']
+
+- name: Display VLAN configuration results
+  ansible.builtin.debug:
+    msg: "Configured {{ sophos_vlans | length }} VLANs successfully"
+  tags: ['vlans']