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
• At least one camera set up in the location
• At least one door set up in Kisi

The integration isn't complete until at least one Rhombus account is authenticated in Kisi.

Configure the integration in Kisi

1. Sign in to Kisi
2. Click the integrations icon (3x3 grid of dots) > Add Integration
3. Open the Type dropdown and select Rhombus
4. Click Add then Configure Integration
5. Open the Accounts tab and click Add Account
6. Enter a Key Name and click Generate Private Key and CSR
7. In the Generate Private Key and CSR popup, fill in all six fields, then click Generate. Generate stays disabled until every field is filled in.
   • C (Country Code): a 2-letter ISO country code, for example US
   • ST (State or Province Name)
   • L (Locality)
   • O (Organization)
   • OU (Organizational Unit)
   • CN (Common Name)
8. Click Download CSR file to download the certificate request file
9. Open the file and copy the full text

caution

Download the CSR before you close the dialog. If you close it without downloading, you'll need to generate a new private key and CSR.

Downloading the CSR also saves the account. It appears in the Accounts list as Not Authenticated with a Continue button, which you use to finish the setup after you've configured Rhombus.

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 Integrations and Developer Resources
4. Navigate to the API Tokens tab
5. Click Add API Key
6. Add a name and select a role. The role must allow viewing cameras and creating and downloading video clips.
7. Paste the certificate request file from Kisi into the popup and click Submit
8. Copy the Rhombus API Key and download the signed certificate (a .crt file)

Authenticate Rhombus credentials in Kisi

1. In the Accounts tab, click Continue next to the account
2. Click Upload Signed Certificate and select the signed certificate you downloaded from Rhombus. Only .crt files are accepted.
3. Paste the Rhombus API Key
4. Click Complete Account (or Add Account if you completed every step in one go). Kisi checks the credentials with Rhombus. If they're valid, you'll see "Account updated successfully!" (or "Account added successfully!") and the account shows as Authenticated.

If you click Save and Close before all the credentials are in, Kisi saves the account as it is ("Account saved.") and you can finish it later with Continue.

note

The certificate must be signed from the latest CSR you downloaded for this account. Kisi keeps only the most recent private key, so if you regenerate the private key and CSR, request a new signed certificate from Rhombus.

Add a Rhombus camera to Kisi

1. Switch to the Cameras tab
2. Click Add Camera
3. Select the Rhombus account. Only authenticated accounts are listed. If none are, you'll see "No account is currently authenticated."
4. Under Select Rhombus Camera, select the camera. Cameras already added to this integration aren't listed.
5. Select the Place and Door
6. Under Clip duration (seconds), enter how many seconds of video to record for each event: a whole number from 3 to 60 (default 10)
7. Click Save

info

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

Supported events for video clips

Once the integration is set up, camera footage will appear in the Event History, marked with a camera icon. The integration attaches a video clip to 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)
• Tailgating incident (incident.create)

Each clip starts at the time of the event and runs for the camera's clip duration. Kisi requests the clip about 30 seconds after the clip ends, so it appears in Event History at least the clip duration plus 30 seconds after the event, usually within a minute or two.

Manage cameras

The Cameras tab lists every camera with its Account and Status.

• Status - shows Online or Offline. Kisi syncs the status from Rhombus every 15 minutes, and a camera shows Online only when Rhombus reports it as connected. Kisi doesn't fetch clips for a camera while it shows Offline.
• Edit a camera - click its row to open Edit Camera. Only the Door and Clip duration (seconds) can be changed. The account, Rhombus camera and place are locked; to move a camera to another place, delete it and add it again.
• Delete cameras - select one or more cameras with the checkboxes and click Delete, then confirm in the Delete Cameras dialog. This also removes the cameras from Kisi.

Deleting a camera in the Kisi dashboard also removes it from the integration. Deleting a Kisi door also deletes the Rhombus cameras linked to it.

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.

Manage Rhombus accounts

You can connect more than one Rhombus account. The Accounts tab lists every account under Existing Accounts with its status, Authenticated or Not Authenticated. Each camera is tied to one account.

To add another account, click Add Account and follow the steps in Configure the integration in Kisi.

To remove an account, first delete the cameras that use it, then click Delete next to the account.

Troubleshooting

Accounts are not authenticated

If Rhombus rejects an account's credentials, for example because the API key was revoked or the certificate is no longer valid, Kisi marks the account Not Authenticated. Clips for that account's cameras fail, and the Accounts tab shows a red banner: "The following account(s) are not authenticated: … Cameras linked to these accounts will not be able to process snapshots. Please continue setup or delete disabled accounts."

To fix it, click Continue next to the account and enter a new API key, a new signed certificate or both. To request a new certificate, use Regenerate Private Key and CSR, then repeat the steps in Configure the integration in Rhombus with the new CSR.

Error messages

Error	Meaning and resolution
Rhombus credentials are invalid.	Rhombus rejected the API key or certificate. Check the API key, and make sure the certificate was signed from the CSR you downloaded for this account.
Enter a key name before downloading the CSR.	The account has no Key Name. Enter one, then download the CSR.
No account is currently authenticated.	No Rhombus account is authenticated, so there's nothing to add cameras from. Finish an account with Continue as described in Authenticate Rhombus credentials in Kisi.
Delete Conflicting Camera: "A camera with the same Device ID already exists in Kisi. Do you want to delete it?"	A camera with the same device ID already exists in Kisi, for example from an earlier setup. Click Delete, then add the camera again.
Cannot delete credential. There are still camera(s) using this credential.	You can't delete an account that cameras still use. Delete those cameras first, then delete the account.

Remove the integration

1. Sign in to Kisi
2. Click the integrations icon (3x3 grid of dots) and select your Rhombus integration
3. Click Delete and confirm

Removing the integration deletes every Rhombus camera it created in Kisi.