Managed devices

Managed devices allow admins to maintain a list of devices managed by their Mobile Device Management (MDM) system. When the Managed Device Restriction is enabled for a group, access for that group is permitted exclusively from these devices.

info

This feature is available upon request. Contact Kisi Sales to enable it.

Step 1: Configure your MDM system

In your MDM system, define a Unique Device Identifier for each managed device and populate the MDMDeviceID field. You use this identifier as the device's uid when adding it to Kisi.

Step 2: Add managed devices to Kisi

Choose one of the following methods:

Bulk import via CSV

1. Sign in to Kisi

2. Click the integrations icon (3x3 grid of dots) > Add Integration

3. Select Upload Managed Devices

4. Download the CSV template

5. Fill in one row per device with its uid (the Unique Device Identifier from your MDM system) and name, and save the file as CSV. For example, a filled-in template looks like this in a spreadsheet app:

   	A	B
   1	uid	name
   2	A1B2C3D4-0001	Reception iPad
   3	A1B2C3D4-0002	Front desk iPhone
   4	A1B2C3D4-0003	Warehouse tablet

6. On the Import Managed Devices page, click Import CSV file and select your file. Keep the page open until the progress bar reaches 100% and the success message appears.

7. Click Return and check that the devices appear under Managed Devices

Your CSV file must keep the template's header row (uid,name), and every row needs both a uid and a name. If a column or value is missing, the whole file is rejected. Empty lines are ignored. Only .csv files can be selected.

Devices already in Kisi (matched by uid) are skipped and their names aren't changed. If the same uid appears more than once in the file, only the first row is imported. To rename a device, edit it on the Managed Devices page.

info

The CSV import is a one-time upload. Kisi doesn't connect to or sync with your MDM, and no MDM credentials are needed. When devices change, upload a new CSV file or add, edit, or delete devices manually.

note

Each organization can have one Upload Managed Devices integration. To import more devices later, open the existing integration and upload another CSV file.

Add manually

1. Sign in to Kisi
2. Navigate to Managed Devices and click Add Device
3. Enter the device name and the Unique Device Identifier (uid) from your MDM system
4. Click Add

Step 3: Enable the managed device restriction

Once devices are added, you can enable the restriction on a group to allow access only from those devices.

1. Navigate to Groups and select the group you want to restrict
2. Click Permissions and enable Managed Device Restriction
3. Click Save

Edit or delete managed devices

• To edit a device, select it from the list and update its information
• To delete a device, select it and click Delete
• To bulk delete, select multiple devices and click Delete

Remove the Upload Managed Devices integration

Deleting the Upload Managed Devices integration doesn't remove the imported devices. To remove them, delete them from the Managed Devices page.

Troubleshooting CSV imports

The Import Managed Devices page shows these messages:

• Importing <file>: Please do not refresh your page - the import is in progress. Leave the page open, because the upload runs in your browser.
• Success importing <file>! All devices have been uploaded. - all devices were imported. Click Return to check them.
• Error importing <file>: Something went wrong. Could not parse the document, please check the file format - the file couldn't be read. Check that the header row is uid,name and that no row is missing a value.
• Error importing <file>: please try again - the import failed partway. Devices created before the failure stay in Kisi. Upload the same file again to add the missing devices, because existing UIDs are skipped.
• There can be only one managed devices installation per organization - your organization already has an Upload Managed Devices integration. Open the existing integration to upload another CSV file.

Common questions

Is it necessary for users to download the Kisi mobile app on the managed device?

Yes, users must install the Kisi mobile app through the Mobile Device Management (MDM) system and ensure the managed device field is configured first.

Do users need to sign in, or is it done automatically?

Users are required to sign in manually, following the standard process.