Skip to main content

Immersive Labs

Visualize Immersive Labs learners, teams, catalog labs, collections, and scheduled exercises (Cyber Range drills, crisis simulations, screening, and CTF events) in the JupiterOne graph, along with per-learner assignments and completions — including earned CPE credits. Track training completion and CPE credit as compliance evidence, identify learners who have not engaged with assigned training, correlate learners to employee identities, and monitor engagement across teams through queries and alerts.

Installation​

Prerequisites​

  • An Immersive Labs organization (tenant) with an Organization Admin who can generate an API key.
  • Your region-specific API base URL (for example https://api.immersivelabs.online or https://api.us.immersivelabs.com).
  • Access to JupiterOne with permission to configure integrations.

Generate an API key in Immersive Labs​

The integration authenticates with an API key issued as an Access Key / Secret Token pair.

  1. Sign in to the Immersive Labs platform as an Organization Admin.
  2. Go to Platform Settings → API.
  3. Select Generate API key.
  4. Copy the Access Key and the Secret Token. The Secret Token is shown only once, so store it securely — you will paste both values into JupiterOne in the next section.

The integration issues read-only requests and mints a least-privilege token scoped to account:read team:read catalog:read assignment:read, all of which are granted to every API key by default, so no additional scope provisioning is required. See the Authorization tab for details.

Configure the integration in JupiterOne​

To install the Immersive Labs integration in JupiterOne, navigate to the Integrations tab and select Immersive Labs. Click New Instance to begin configuring your integration.

Creating an Immersive Labs instance requires the following:

  • The Account Name used to identify the Immersive Labs account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.
  • Description to assist in identifying the integration instance, if desired.
  • Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

Authentication fields​

FieldRequiredDescription
API Base URLYesYour region-specific Immersive Labs API endpoint (e.g. https://api.immersivelabs.online or https://api.us.immersivelabs.com).
Access KeyYesThe Access Key from your Immersive Labs API key (used as the token username).
Secret TokenYesThe Secret Token paired with the Access Key (used as the token password).

Advanced — Activity Lookback Days​

The completion and assignment steps fetch learner activity created within a lookback window, so each sync is bounded rather than pulling the full history.

FieldDefaultOptionsDescription
Activity Lookback Days9014, 30, 90, 180, 365How far back (in days) to fetch completion and attempt activity on each sync. Increase it to capture older activity.

Click Create once all values are provided to finalize the integration.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.