Skip to main content

Integrate Kisi with Rhombus Systems

As a Kisi admin, you can integrate your place with Rhombus Systems' security cameras. Before setting up the integration, make sure you have API access to your Rhombus Systems cameras.

info

This is a Kisi-built integration, maintained and supported by Kisi.

Prerequisites

  • a Rhombus Systems account
  • Kisi administrator access rights
  • a Kisi organization API key
  • at least one camera set up in the location

Generate a Kisi API key

You need to have organization administrator or organization owner rights to create an API key. We recommend creating API keys from the organization owner's account, to avoid the API key becoming invalid when an organization admin loses their admin rights.

  1. Sign in to Kisi
  2. On the top right corner, click on your name and click on My Account
  3. Next, select the API tab and click on Add API key
  4. Enter your name, your Kisi password, and your verification code and click Add
  5. Copy the API key shown on the screen and click Close

Configure the integration in Rhombus

  1. Sign in to your Rhombus account as an Administrator
  2. On your dashboard, choose the cogwheel in the top right corner
  3. Navigate to Third-Party Integrations
  4. Under Badge systems, choose Kisi and click Edit
  5. Make sure the Integration Enabled option is toggled on
  6. Select the Kisi place you want to associate your camera(s) with
  7. Select the doors you want to associate your camera(s) with
  8. Click on Update Kisi Credentials and enter the API Key you generated above

After this, you will be able to see activity on your Rhombus dashboard such as visitors, recent faces and more.

Generate the Private key and Certificate Signing Request (CSR)

  • On Windows: follow this guide
  • On macOS/Linux:
  1. Open the Terminal
  2. Copy the following command: openssl req -out rhombus_client.csr -new -newkey rsa:4096 -nodes -keyout rhombus_client.key -subj "/C=US/ST=California/L=Sacramento/O=Rhombus Systems/CN=Client Name"
  3. Paste it in a text editor and replace the C, ST, L, O, OU and CN values with the appropriate values for your organization
    • C (Country Name): e.g. US
    • ST (State or Province Name): e.g. NY
    • L (Locality): e.g. New York City
    • O (Organization): e.g. Company
    • OU (Organizational Unit): e.g IT Operations
    • CN (Common Name): e.g. Certificate for Company
  4. Copy the new command and paste it in the Terminal
  5. Press Enter. This command generates two files: rhombus_client.csr (Certificate Signing Request file) and rhombus_client.key (your Private key). This step takes around 3 seconds.
  6. Locate the two files in your computer

Upload CSR file to Rhombus

  1. Navigate to the Rhombus Console
  2. Click on Settings and select API Management
  3. Click Add API Key
  4. Add a name and paste the contents of the rhombus_client.csr file in the Certificate Signing Request field
  5. The certificate will show up as Pending until it has been signed (may take up to 24 hours)
  6. Once the API Token shows up as Active, click Download. This will download:
  • the Signed Certificate in a CRT file format
  • the API Key, that is a 22 character (alphanumeric) string under the API Key header

Configure the integration in Kisi

  1. Sign in to Kisi
  2. Navigate to Organization Setup
  3. Click on Integrations > Add Integration
  4. Enter a name, open the Type dropdown and select Rhombus Camera
  5. Open both the Certificate and the Private key in a text editor, copy their values (including the first and the last lines) and paste the text in the respective fields in Kisi
  6. Enter the Kisi API key
  7. Enable the integration
  8. Click Add

Import cameras in Kisi

Once the Rhombus integration is created, you can import cameras.

  1. On your place dashboard, navigate to Hardware
  2. Select the Cameras tab and click Import Camera
  3. Choose the relevant camera integration, the camera you wish to add, and the door that this camera should be associated with
info

In Kisi, you can only connect at most one door to a camera, but doors might have multiple cameras associated.

Supported events for camera snapshots

Once the integration is set up, camera footage will appear in the Event History, marked with a camera icon. Snapshots will be created on the following Kisi events:

  • Door unlocked (lock.unlock)
  • Door unlock failed (lock.unlock)
  • Door opened (lock.opened)
  • Door held open (lock.held_open)
  • Door forced open (lock.forced_open)

Deassign cameras

  1. Sign in to Kisi
  2. Navigate to the place where you have your camera assigned
  3. On the dashboard, click on Hardware
  4. Select the Cameras tab
  5. Click on the camera that you wish to deassign
  6. Click on Delete camera in the top right corner
  7. If you are planning to reassign this camera, click on Copy token to save the device token
  8. Click Delete

After deletion, you will receive an email notification confirming that the corresponding camera has been deassigned.