Kastle

Kastle provides devices and software for security & access control. Through this connector, you can normalize your Kastle Oasis and Event Stream data.

Use Cases

Potential use cases include:

• Build occupancy management apps utilizing access control data
• Develop alerts to identify spaces that are over capacity based on how many people swiped into a particular space
• Build tailgating security breach alerts based on a combination of Kastle access data and live occupancy data from other systems

Configuration

Auth

The Kastle Connector uses both Oasis Connect and Event Stream Username and Password for authorization, however you will also need both Owner GUIDs as well, which are currently only supplied by Kastle support. They can be reached via [email protected].

Credential	Description
Oasis Connect Username	The Oasis Connect username provided by Kastle
Oasis Connect Password	The Oasis Connect password provided by Kastle
Event Stream Username	The Event Stream username provided by Kastle
Event Stream Password	The Event Stream password provided by Kastle
Event Stream Owner GUID	The Event Stream Owner GUID provided by Kastle
Oasis Connect Owner GUID	The Oasis Connect Owner GUID provided by Kastle

Source Management

For place mapping, the Kastle connector does not directly pull from the Kastle data source. Instead, a sheet including the Space RefIds (Kastle Location IDs) must be imported. Contact [email protected] to request the location IDs for your service.

When adding new Location IDs, make sure to include previously imported Location IDs in your sheet, otherwise they will be removed from the place mapping. You can Export CSV from the Mapping tab to obtain all the existing currently mapped Location IDs from the Space RefId column.

In Step One Upload, import a spreadsheet file with the following headers:

• Building Address
• Building Name
• Building SiteId
• Floor Level
• Floor Name
• Space Code
• Space Name
• Space RefId (required)

Note that any column except Space RefId may be left blank.

In Step Two Map Headers, confirm which columns map to the expected headers. Wait a moment before proceeding to Step 3 Review.

In Step Three Review, review the source information you've added and submit if it looks correct.

Mapped Concepts

Connector Concept	Mapped Type
BuildingMapping	Building
Card Reader	Access_Card_Reader
Data stream	Access_Activity_Status

Sample Code

Here's an example showing how to retrieve when an access card reader registered a swipe during a specific window of time:

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
{
  points(filter: {id: {eq: "PNT46M9E7eggcTpXW3ZEw3w7k"}}) {
    id
    name
    exactType
    series(startTime: "2023-05-20T10:00:00.000", endTime: "2023-05-25T00:00:00.000") {
      timestamp
      value {
        json
      }
    }
  }
}