Skip to main content

Overview

The ISL Online integration enables ThreatAware to collect read-only data from your ISL Online platform, providing visibility into remote access sessions and support activities.
Connection Method: API Setup Time: 15 minutes Access Required: ISL Online Administrator account

Data collected

The ISL Online integration provides:
  • Remote access session information
  • Support operator activity logs
  • Session history and details
  • System configuration data

Use cases

Remote Access Monitoring

Track remote access sessions and activities across your organisation

Session Tracking

Monitor active and historical remote support sessions

Support Activity Audit

Track support operator activities and session details for audit purposes

Security Control Validation

Verify remote access controls meet organisational security standards

Setup instructions

1

Log in to ISL Online Admin Console

Access the ISL Online Console with an administrator account.
2

Navigate to API Access

In the ISL Online admin console:
  • Go to Settings > API Access
  • This section contains API key management
3

Create API Key

Create a new API key for ThreatAware:
  • Click Create API Key
  • Provide a descriptive name, for example: ThreatAware Integration
  • Set the permissions to Read-only (unless additional access is required)
  • Click Generate or Create to generate the key
  • Copy the API Key that is displayed
API keys are typically displayed only once. Store the key securely in your password manager immediately.
4

Configure in ThreatAware

In ThreatAware, go to Integrations and select ISL Online:
  • Paste the API Key in the designated field
  • Click Connect to establish the integration
5

Verify Connection

After connecting, verify the integration status:
  • Check that the Integration Status shows as Active
  • Wait for initial data synchronization (typically 10-15 minutes)
  • Verify ISL Online data appears in ThreatAware

Required credentials

Field Name: ISL Online API Key Type: Password (encrypted) Description: The API key generated in ISL Online’s Settings > API Access sectionExample: abc123def456xyz789uvw123
Store this credential securely in your organisation’s password manager.

Verification and testing

After setup, verify the integration is working correctly:
  1. Check Integration Status
    • Navigate to Integrations in ThreatAware
    • Confirm the ISL Online integration shows Active status
    • Note the last sync timestamp
  2. Verify Data Collection
    • Wait for initial data sync (10-15 minutes)
    • Log in to ISL Online and note active sessions
    • Verify the same sessions appear in ThreatAware
  3. Test Queries
    • Create a test query to filter devices with ISL Online data
    • Verify session details appear correctly

Troubleshooting

Symptoms: Integration status shows authentication failureSolutions:
  • Verify the API Key is entered correctly and completely
  • Ensure the key was copied without extra spaces or line breaks
  • Check that the API key hasn’t expired or been revoked
  • Log in to ISL Online to verify the key is still active
  • Generate a new API key if the current one is invalid
Symptoms: Integration connects but shows no session dataSolutions:
  • Verify the API key has Read-only permissions (or higher if needed)
  • Check that the user account used to generate the API key is an administrator
  • Review the ISL Online API configuration for required permissions
  • Regenerate the API key with proper permissions if needed
  • Consult the ISL Online API Documentation for detailed permissions
Symptoms: Integration worked initially but stopped collecting dataSolutions:
  • Log in to ISL Online and check the API key status
  • Verify the key hasn’t been manually revoked or expired
  • Generate a new API key in ISL Online
  • Update the key in ThreatAware integrations settings
  • Test the connection again
Symptoms: Integration shows active but no session data appearsSolutions:
  • Wait up to 15 minutes for initial data synchronization
  • Verify there are active remote sessions in ISL Online to collect
  • Check that the API key has read permissions
  • Log in to ISL Online to verify session data exists
  • Review integration logs in ThreatAware (contact support if needed)
Symptoms: Integration fails to connect or times out repeatedlySolutions:
  • Check ISL Online platform availability and status
  • Verify your network connection to ISL Online
  • Confirm firewall rules allow outbound HTTPS (443) to ISL Online
  • Try connecting again after a few minutes
  • Contact ISL Online support if the platform is unreachable

Additional resources

ISL Online Help

Official ISL Online documentation and API guides

ISL Online Platform

Access your ISL Online platform

ThreatAware Support

Contact ThreatAware support for integration assistance

Best practices

Credential Management
  • Store the API key securely in your organisation’s password manager
  • Document where the API key was generated and for what purpose
  • Regenerate API keys periodically per your security policy
  • Monitor authentication failures in the integration logs
  • Keep track of API key creation dates for rotation planning
API Usage and Security
  • Use read-only API keys for monitoring and compliance purposes
  • Only create API keys with the minimum permissions required
  • Audit ISL Online API access regularly
  • Revoke unused API keys to reduce security risk
  • Monitor for unusual API activity or access patterns