← Back to Integration
OPERATING SYSTEMS

Integration with Windows Server Integration withSPOG.AI

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

CapabilityDescription
System InventoryDiscovers operating system, hardware, BIOS, CPU, memory, and storage details.
Network ConfigurationCollects IP addresses, MAC addresses, routes, and interfaces.
Applications & ServicesIdentifies installed applications, running services, and scheduled tasks.
Security & Patch InformationRetrieves security configurations, installed updates, and missing patches.
Performance & Event LogsCollects CPU, memory, and disk I/O metrics, plus event logs and audit events.
User & Access ControlDiscovers local users, domain groups, and active sessions.
Scheduled DiscoveryRuns 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

CategoryData CollectedDescription
System InventoryOS version, hardware details, BIOS, CPU, memory, storageCore hardware and operating system details for each host.
Network ConfigurationIPs, MACs, routes, interfacesNetwork settings and connectivity of each host.
User & Access ControlLocal users, domain groups, active sessionsAccounts, groups, and sessions present on each host.
Security LogsEvent logs, audit events, security alertsSecurity and audit records from the host.
Service & Process InfoRunning services, scheduled tasksServices and tasks running on each host.
Patch & Update InfoInstalled updates, missing patchesPatch level and outstanding updates.
Registry & ConfigurationSystem configurations, policy complianceConfiguration and policy compliance details.
Performance MetricsCPU load, memory usage, disk I/O statisticsResource 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 TypeAccessSetup
AdministratorFull access via WinRM.No additional configuration required.
Domain UserWinRM execution rights and PowerShell remote access.Add manually via Set-PSSessionConfiguration.
Local UserLocal WinRM access only.Configure WinRM authentication manually.

Network requirements

ComponentPortProtocolDirectionPurpose
SPOG.AI Appliance → Windows Server5985 / 5986HTTP / HTTPS (WinRM)OutboundRemote management
SPOG.AI Appliance → Windows Server135, 139, 445TCPOutboundDCOM, SMB communication
Windows Server → SPOG.AI443HTTPSOutboundAPI 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:
FieldDescription
Integration NameEnter a name (for example, Windows Discovery).
CIDR/SubnetDefine the target network range for discovery.
Authentication TypeSelect Password or Vault-based authentication.
UsernameEnter the domain or local Windows account.
PasswordProvide the account credentials (set the password to never expire).
Exclude Service TypeSpecify 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.

Frequently
Asked Questions