Skip to content

Enrollment keys

An enrollment key lets Lookout register devices to a specific client. Each device trades the key for its own credential during installation.

Create a key

  1. Open Clients and find the client.
  2. Optionally enter a label, such as Initial rollout or Intune.
  3. Select New enrollment key.
  4. Copy the key from the dark box at the top of the page.

Keys are shown only once

Trimtab stores only a fingerprint of the key. If you lose it, revoke it and create a new one. Store keys in your password manager or your RMM's secure variables, never in plain-text scripts shared outside your team.

Reuse and revoke

  • One key can enroll any number of devices for its client, so you need one key per client, not per device. The Uses column counts enrollments.
  • If you deploy on a schedule, keep the key active so new devices can enroll.
  • Select Revoke if a key may have leaked, or when you stop adding devices for that client. Devices already enrolled keep working, because each has its own credential. To keep deploying, create a new key and update your RMM variable.
  • To stop a specific device from reporting, remove or revoke the device instead. See Device and tenant pages.

Re-enrolling a device

Running the installer again with a key on a device that's already enrolled keeps the same device and its history. Lookout (0.6.5 and later) proves it's the same device by sending its current credential, and the Bridge gives it a new one.

Without that proof, the Bridge enrolls a new device, even if the name and serial number match an existing one. Names and serial numbers aren't secret, so matching on them alone would let anyone holding an enrollment key take over a device and report in its place. This happens after a device is wiped and Lookout is installed fresh, or with Lookout older than 0.6.5. Remove the old device once the new one is reporting; the activity log notes each enrollment that shares a name and serial with another device.