Overview
SPOG.AI integrates with Windows Servers to provide exhaustive discovery of server and workstation assets under a specific tenant. The SPOG.AI Discovery Appliance connects to each target over WinRM using authorized credentials and collects hardware, software, network, security, patch, and performance data. All collected data is securely transmitted to the SPOG.AI Configuration Management Database (CMDB), where it supports analytics, compliance monitoring, and incident management. Administrator accounts can connect directly with no extra configuration, while standard domain users must be granted rights to run WinRM queries.
Key Features
| Capability | Description |
| System Inventory | Discovers operating system, hardware, BIOS, CPU, memory, and storage details. |
| Network Configuration | Collects IP addresses, MAC addresses, routes, and interfaces. |
| Applications & Services | Identifies installed applications, running services, and scheduled tasks. |
| Security & Patch Information | Retrieves security configurations, installed updates, and missing patches. |
| Performance & Event Logs | Collects CPU, memory, and disk I/O metrics, plus event logs and audit events. |
| User & Access Control | Discovers local users, domain groups, and active sessions. |
| Scheduled Discovery | Runs discovery cycles on a configured schedule (default every 24 hours). |
How the Integration Works
Once configured, the SPOG.AI Discovery Appliance connects to each Windows host over WinRM (HTTP on port 5985 or HTTPS on port 5986) using authorized credentials. It collects hardware, software, and network configuration details, installed applications and running services, security configurations and patch information, and performance and event log data.
All collected data is securely transmitted to the SPOG.AI CMDB, where it is used for analytics, compliance monitoring, and incident management. Credentials are encrypted within SPOG.AI or stored in an integrated credential vault, and discovery cycles run on the schedule you configure.
Data Collected
| Category | Data Collected | Description |
| System Inventory | OS version, hardware details, BIOS, CPU, memory, storage | Core hardware and operating system details for each host. |
| Network Configuration | IPs, MACs, routes, interfaces | Network settings and connectivity of each host. |
| User & Access Control | Local users, domain groups, active sessions | Accounts, groups, and sessions present on each host. |
| Security Logs | Event logs, audit events, security alerts | Security and audit records from the host. |
| Service & Process Info | Running services, scheduled tasks | Services and tasks running on each host. |
| Patch & Update Info | Installed updates, missing patches | Patch level and outstanding updates. |
| Registry & Configuration | System configurations, policy compliance | Configuration and policy compliance details. |
| Performance Metrics | CPU load, memory usage, disk I/O statistics | Resource utilization of each host. |
Prerequisites
Before configuring the integration, ensure the following prerequisites are met:
- Supported OS: Windows Server 2016 / 2019 / 2022, or Windows 10/11 (Enterprise/Pro).
- WinRM (Windows Remote Management) is enabled and configured on the target.
- An Administrator account, or a delegated domain account with WinRM access rights.
- Recommended: a dedicated domain service account for SPOG.AI discovery, with a non-expiring password and limited privileges.
- Network connectivity from the SPOG.AI Discovery Appliance to the target on the ports listed below.
Account types
| Account Type | Access | Setup |
| Administrator | Full access via WinRM. | No additional configuration required. |
| Domain User | WinRM execution rights and PowerShell remote access. | Add manually via Set-PSSessionConfiguration. |
| Local User | Local WinRM access only. | Configure WinRM authentication manually. |
Network requirements
| Component | Port | Protocol | Direction | Purpose |
| SPOG.AI Appliance → Windows Server | 5985 / 5986 | HTTP / HTTPS (WinRM) | Outbound | Remote management |
| SPOG.AI Appliance → Windows Server | 135, 139, 445 | TCP | Outbound | DCOM, SMB communication |
| Windows Server → SPOG.AI | 443 | HTTPS | Outbound | API data exchange (optional) |
For Domain User authentication, also allow ICMP ping, TCP 135, 80, 443, 139, DCOM, and WinRM (5985/5986). For Local User authentication, only WinRM is required (configured separately).
Configuration
1. Enable the WinRM service
- Log in to the Windows Server as an Administrator.
- Open PowerShell and run:
winrm quickconfig
This command starts the WinRM service and sets it to auto-start, creates a default listener on port 5985 (HTTP), and configures the WinRM firewall exceptions.
2. Allow a domain user to access WinRM
Required only if you are using a non-administrator domain account.
- Run the following command:
Set-PSSessionConfiguration -Name Microsoft.PowerShell -ShowSecurityDescriptorUI
- In the Security Descriptor UI, click Add, enter the domain username, and select Check Names.
- Assign Allow permissions for Full Control, Read, and Execute.
- Click OK to apply.
3. Configure firewall rules
Enable inbound WinRM traffic:
netsh advfirewall firewall add rule name="WinRM HTTP" dir=in action=allow protocol=TCP localport=5985
netsh advfirewall firewall add rule name="WinRM HTTPS" dir=in action=allow protocol=TCP localport=5986
Tip: For encrypted communication, enable an HTTPS listener using a valid SSL certificate.
4. Configure Firewall Rules
Run the following commands in PowerShell:
Set-Item WSMan:\localhost\Service\AllowUnencrypted -Value $true
Set-Item WSMan:\localhost\Client\TrustedHosts -Value "<Appliance-IP>"
winrm set winrm/config/client/auth '@{Basic="true"}'
winrm set winrm/config/service/auth '@{Basic="true"}'
Note: These settings allow unencrypted Basic authentication. For encrypted communication, use an HTTPS listener with a valid SSL certificate, and use Kerberos or NTLM wherever possible.
Tip: For encrypted communication, enable the HTTPS listener using a valid SSL certificate.
6. Test connectivity
From the SPOG.AI Discovery Appliance or another host, run:
Test-WSMan <Target-ComputerName>
If the test succeeds, proceed to the SPOG.AI configuration.
7. Configure Windows in SPOG.AI
- Log in to the SPOG.AI Dashboard.
- Navigate to Administration → Connected Hub → Add and search for Windows Discovery.
- Go to Configuration and provide the following details:
| Field | Description |
| Integration Name | Enter a name (for example, Windows Discovery). |
| CIDR/Subnet | Define the target network range for discovery. |
| Authentication Type | Select Password or Vault-based authentication. |
| Username | Enter the domain or local Windows account. |
| Password | Provide the account credentials (set the password to never expire). |
| Exclude Service Type | Specify services to exclude from scanning (optional). |
- Click Save to complete the configuration.
8. Validate the integration
- Run Test Connection from SPOG.AI to confirm WinRM communication.
- Execute a discovery cycle and confirm that the Windows host is discovered.
- Verify that asset metadata populates in the CMDB and that server details (OS, CPU, RAM, IP, and so on) appear accurately.
- Review the Discovery Appliance logs for any access or permission errors.