Skip to main content

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.

Set up the integration in Rhombus

Generate a Kisi API

  1. Sign in to Kisi
  2. On the top right corner, click on your name and select My Account
  3. Navigate on the API tab
  4. Select Add API Key and click on Add
  5. Copy the API key as you will need to add it in 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 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.

Set up the integration in Kisi

To create the integration, we will generate the client-side key-pair, get the certificate signed, and receive an API key to create the integration in Kisi.

Generate the Private key and Certificate Signing Request (CSR)

  • On Windows: follow this guide
  • On macOS/Linux:
  1. Open the Terminal
  2. Copy the command below: 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
  1. Copy the new command and paste it in the Terminal
  2. Press Enter. This command generates two files: rhombus_client.csr (Certificate Signing Request file) and rhombus_client.key (your Private key)
  3. 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, you can download:
  • the Signed Certificate – by clicking Download
  • the API Key - a 22 character (alphanumeric) string under the API Key header

Configure the integration in Kisi

  1. Sign in to Kisi
  2. On your Kisi place dashboard, select Integrations and click on Add Integration
  3. Enter a name, open the Type dropdown and select Rhombus Camera
  4. 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
  5. Enter the Rhombus API key and click Add

Import cameras in Kisi

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

  1. On your place dashbaord, 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

When done, you will start seeing camera footage in the Event History. The events are shown when the chosen door is being unlocked, held or forced opened.

For more details please visit our help article on how to Integrate Kisi with Rhombus Systems.