> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threataware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ISL Online

> Connect ThreatAware to ISL Online for remote access and support monitoring

## 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.

<Info>
  **Connection Method**: API
  **Setup Time**: 15 minutes
  **Access Required**: ISL Online Administrator account
</Info>

## Data collected

The ISL Online integration provides:

* Remote access session information
* Support operator activity logs
* Session history and details
* System configuration data

## Use cases

<CardGroup cols={2}>
  <Card title="Remote Access Monitoring" icon="network-wired">
    Track remote access sessions and activities across your organisation
  </Card>

  <Card title="Session Tracking" icon="history">
    Monitor active and historical remote support sessions
  </Card>

  <Card title="Support Activity Audit" icon="clipboard-list">
    Track support operator activities and session details for audit purposes
  </Card>

  <Card title="Security Control Validation" icon="shield-halved">
    Verify remote access controls meet organisational security standards
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Log in to ISL Online Admin Console">
    Access the [ISL Online Console](https://www.islonline.com) with an administrator account.
  </Step>

  <Step title="Navigate to API Access">
    In the ISL Online admin console:

    * Go to **Settings** > **API Access**
    * This section contains API key management
  </Step>

  <Step title="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

    <Warning>
      API keys are typically displayed only once. Store the key securely in your password manager immediately.
    </Warning>
  </Step>

  <Step title="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
  </Step>

  <Step title="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
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="API Key" icon="key">
    **Field Name**: ISL Online API Key
    **Type**: Password (encrypted)
    **Description**: The API key generated in ISL Online's Settings > API Access section

    Example: `abc123def456xyz789uvw123`

    <Tip>
      Store this credential securely in your organisation's password manager.
    </Tip>
  </Accordion>
</AccordionGroup>

## 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

<AccordionGroup>
  <Accordion title="Invalid API Key Error" icon="triangle-exclamation">
    **Symptoms**: Integration status shows authentication failure

    **Solutions**:

    * 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
  </Accordion>

  <Accordion title="Permission Issues" icon="ban">
    **Symptoms**: Integration connects but shows no session data

    **Solutions**:

    * 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](https://help.islonline.com) for detailed permissions
  </Accordion>

  <Accordion title="API Key Expired" icon="clock">
    **Symptoms**: Integration worked initially but stopped collecting data

    **Solutions**:

    * 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
  </Accordion>

  <Accordion title="No Data After 15 Minutes" icon="database">
    **Symptoms**: Integration shows active but no session data appears

    **Solutions**:

    * 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)
  </Accordion>

  <Accordion title="Connection Timeout" icon="exclamation-triangle">
    **Symptoms**: Integration fails to connect or times out repeatedly

    **Solutions**:

    * 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
  </Accordion>
</AccordionGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="ISL Online Help" icon="book" href="https://help.islonline.com">
    Official ISL Online documentation and API guides
  </Card>

  <Card title="ISL Online Platform" icon="globe" href="https://www.islonline.com">
    Access your ISL Online platform
  </Card>

  <Card title="ThreatAware Support" icon="life-ring" href="mailto:help@threataware.com">
    Contact ThreatAware support for integration assistance
  </Card>
</CardGroup>

## Best practices

<Tip>
  **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
</Tip>

<Tip>
  **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
</Tip>