Lenel S2 OnGuard 8.3

Mapped's LenelS2 OnGuard 8.3 integration is an Mapped gateway (UG) enabled connector, which connects access activity events from OnGuard installations to the graph in the Mapped cloud. To use this integration with your Lenel OnGuard system, you will need to contact your LenelS2 representative and obtain the necessary licenses.

Use Cases

Potential use cases include:

• Measuring building occupancy
• Finding patterns in space utilization
• Identifying areas of concern in your building

Configuration

A WebSDK license must be procured from Lenel before enabling this integration, which will require help from your Lenel OnGuard system integrator. Once the WebSDK is installed on your Lenel system, and the integrator created the necessary WebSDK user, you will need to provide the configured username and password to enable the integration on your Mapped gateway.

Please ensure the standard Lenel OpenAccess ports of 8080 and 443 are open, otherwise the integration will be unable to reach the server.

Mapped Concepts

Connector Concept	Mapped Type
Panel, Reader	Access_Control_Unit, Access_Reader
Event	Access_Activity_Status

Sample Code

Here's an example that shows how to retrieve the access control events for a set time period and for a specific unit - note you will need to use json for the value type, not a float or integer. The schema for the json follows the example below.

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  things(filter: {id: {eq: "THGH4Mtf45q8ew8Ty2aCxABcd"}}) {
    id
    name
    exactType
    points {
      id
      name
      exactType
      series(startTime: "2025-05-14T00:48:00.000", endTime: "2025-05-14T00:48:59.000") {
        timestamp
        value {
          json
        }
      }
    }
  }
}

Event JSON Schema:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
{
  "$id": "https://schemas.mapped.com/mapped/1.0/core/Access_Activity_Status/complexValue.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Access_Activity_Status:ComplexValueSchema",
  "type": "object",
  "properties": {
    "result": {
      "type": "string",
      "enum": [
        "denied",
        "granted"
      ]
    },
    "credentialIdentity": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "Access_Credential_Identity"
          ]
        },
        "value": {
          "type": "string"
        },
        "scope": {
          "type": "string",
          "enum": [
            "CONNECTOR"
          ]
        },
        "scopeId": {
          "type": "string"
        }
      }
    },
    "reason": {
      "type": "string"
    }
  }
}

Note - any AccessCardIdentifier associated with a result has been anonymized.