Overview
The ManageEngine Patch integration enables ThreatAware to collect read-only data from your ManageEngine Patch Manager console, providing visibility into patch deployment status and helping validate your patch management security controls.Connection Method: API
Setup Time: 15 minutes
Access Required: ManageEngine Administrator account
Data collected
The ManageEngine Patch integration provides:- Patch deployment status
- Update compliance metrics
- System patch history
- Security update tracking
Use cases
Patch Compliance Tracking
Monitor patch deployment status and ensure systems are current with security updates
Compliance Validation
Verify patch management controls are in place for all managed systems
Security Monitoring
Identify systems missing critical security patches across your environment
Audit Support
Generate reports showing patch deployment coverage and compliance metrics
Setup instructions
1
Log in to ManageEngine Patch Manager Console
Access your ManageEngine Patch Manager Console using an account with administrator privileges.
2
Generate an API Key
In the Patch Manager console, navigate to Admin > API Key Generation.
- Click Generate Key and create a new key for ThreatAware integration
- Set the required permissions, typically Read-only for monitoring, unless broader access is needed
- Copy the API Key generated
3
Configure in ThreatAware
Complete the integration setup in ThreatAware:
- Open ThreatAware and navigate to Settings > Integrations
- Search for and select ManageEngine Patch
- Enter the required credentials:
- API Key: The key generated in ManageEngine Patch Manager
- ManageEngine URL: Your ManageEngine Patch Manager instance URL
- Click Connect to establish the integration
4
Verify Connection
After connecting, ThreatAware will begin polling data from ManageEngine Patch within 1 hour.
- Check that the Integration Status shows as Active
- Verify data is appearing in ThreatAware by viewing patch compliance details
Required credentials
API Key
API Key
Field Name: ManageEngine Patch API Key
Type: Password (encrypted)
Description: The API key generated in ManageEngine Patch Manager for API access
ManageEngine URL
ManageEngine URL
Field Name: ManageEngine Patch URL
Type: String
Description: The URL of your ManageEngine Patch Manager instanceFormat:
https://your-manageengine-url.com
Example: https://patch.acme.com or https://manageengine.company.netVerification and testing
After setup, verify the integration is working correctly:-
Check Integration Status
- Navigate to Settings > Integrations in ThreatAware
- Confirm the ManageEngine Patch integration shows Active status
- Check the last sync timestamp
-
Verify Data Collection
- Wait 60 minutes for the initial data poll
- Search for a known device in ThreatAware
- Check for ManageEngine Patch data in device details
-
Test Queries
- Create a test query to filter devices with patch data
- Verify the data matches your expectations
Troubleshooting
Invalid API Key Error
Invalid API Key Error
Symptoms: Integration status shows authentication failureSolutions:
- Verify the API Key is correct and copied completely
- Ensure API key generation is enabled in ManageEngine Patch Manager
- Check that the API key has not expired
- Confirm the API key was entered without extra spaces
Permission Issues
Permission Issues
Symptoms: Integration connects but no data appearsSolutions:
- Verify the API key has read permissions to patch data
- Review the ManageEngine API Documentation for required permissions
- Check if there are organisational units the API key cannot access
- Ensure the API key has permissions across all required scopes
Connection Timeout
Connection Timeout
Symptoms: Integration fails to connect or times outSolutions:
- Verify the ManageEngine URL is correct and accessible from ThreatAware
- Check firewall rules allow outbound HTTPS (443) to your ManageEngine instance
- Confirm your ManageEngine Patch Manager is accessible via the internet (or review network requirements)
- Test the URL in a browser to ensure it’s reachable
No Data After 1 Hour
No Data After 1 Hour
Symptoms: Integration shows active but no patch data appearsSolutions:
- Verify there is patch data in ManageEngine Patch Manager to collect
- Check the API key’s scope and access permissions
- Review ThreatAware integration logs (contact support if needed)
- Confirm the systems you expect to see exist in ThreatAware from other integrations
Additional resources
ManageEngine API Documentation
Official ManageEngine documentation for API configuration and permissions
ThreatAware Support
Contact ThreatAware support for integration assistance