Deploy with Rippling

Install Tokenize on Rippling-managed Macs and Windows PCs with the Rippling enrollment scripts.

If you manage devices with Rippling, use the Rippling scripts from the dashboard. They work like the standard MDM scripts, but they find each person's email on the device, so you don't have to map it per device.

Who can do this: Admins create the enrollment key. A Rippling admin uploads the package and script.

Step 1: Create an enrollment key

  1. Go to Settings → Downloads and click Deploy with MDM.
  2. Check the allowed email domains. Click Add another domain if you need more.
  3. Click Create key and copy it. It's shown once and expires after 90 days.

See Deploy with MDM for how domains limit who can enroll.

Step 2: Download the files

Under Deploy, choose Rippling, then Mac or Windows. Download both:

  • Download Mac installer or Download Windows installer (Windows on Arm: Download Arm64 installer)
  • Download Mac script or Download Windows script

Once you've created a key on this page, the script you download already has the key written into it, so you don't need to pass it as an argument. The download happens in your browser; the key isn't sent anywhere. Step 3 on the page then reads "No arguments needed. The enrollment key is already in the script."

The downloaded script contains the key, so treat the file like a password. It's stored in plain text in Rippling's script library and in each device's script cache. Keep the rollout short, don't reuse that copy later, and revoke the key after rollout.

Step 3: Install and run the script

  1. In Rippling, install the package on the devices.
  2. Upload the script in Rippling Scripts. Set it to run as root on Mac or SYSTEM on Windows.
  3. Add any arguments the dashboard shows. With the key already in the script, there are none.
  4. Assign the script only to the admins and devices in this rollout. Run it after the person assigned to each device has logged in.

If the dashboard shows "Couldn't add the enrollment key to the script", the download falls back to the plain script. Add the argument the dashboard shows in Rippling, with your key filled in:

  • Mac: --enrollment-token '<your-key>'
  • Windows: -EnrollmentToken '<your-key>'

You can also paste the key between the quotes of CONFIGURED_ENROLLMENT_CREDENTIAL="" (Mac) or $script:ConfiguredEnrollmentCredential = '' (Windows) near the top of your copy of the plain script.

How the script finds the email

The script tries these sources in order:

  1. An email you pass with --email (Mac) or -Email (Windows). If you set one, it's the only one used.
  2. Rippling's agent data on the device.
  3. On Windows, the signed-in Windows account.
  4. The accounts the person is signed in to in Claude Code, Codex, and Cursor (Cursor on Mac only). On Windows, the script reads the Codex login from the folder CODEX_HOME points to when that variable is set for the person or the machine, otherwise from .codex in their profile.

Tokenize only accepts emails on the key's allowed domains, so personal accounts are refused and the script moves to the next one. The script prints each email it tries and where it came from.

A company-domain login that belongs to someone else, such as a shared team account, would be accepted. If your team shares tool accounts, pass --email / -Email, or add --require-user-match / -RequireUserMatch so only emails that match the computer's username are used.

Pass -Email for your first Windows devices. On either platform, try the script on one or two devices before a full rollout.

Read the script output

Rippling shows a script's standard output as Output and its standard error as Error, and shows the Error box even when a run worked. The scripts print progress notes (lines starting with ==>) and warnings (lines starting with WARNING:) to Output, and only failures to Error.

A run that worked ends with a line like this in Output, naming the device and the email it enrolled:

==> SUCCESS: enrolled device "Paul's MacBook" (C02…) in Tokenize prod as paul@example.com for paul.

On Windows, a failed enrollment writes a line starting with ERROR: enroll failed with exit to Error, followed by the exit code, the email it tried, and the last line the installer printed.

Troubleshooting

  • "this copy of the script has no enrollment key": the script you uploaded has no key in it. Download the script again from the dashboard after creating a key, or add the key as an argument, then run it again. Exit code 12.
  • "device is not eligible for enrollment": none of the emails found are on the allowed domains or in your synced directory. Pass --email / -Email.
  • Exit code 11: no logged-in user or no email was found. Run it again while the person is logged in, or pass the email.

The full exit code table is in Deploy with MDM.

Don't also push OrgId or APIKey through managed preferences. They would override the key the script creates.