setup

JumpCloud

Purpose

Syncs your JumpCloud organization, users, systems, and SaaS application assignments for identity and device coverage.

tip

Secret fields below accept either an AWS Secrets Manager ARN or a value pasted directly into SubImage's managed vault. See Secrets for details.

Required Fields

Field Secret? Description
jumpcloud_api_key Yes JumpCloud API key
jumpcloud_org_id No JumpCloud Organization ID

Setup Steps

  1. In the JumpCloud Admin Console, open your profile (bottom-left) → My API keyGenerate New API Key. Copy the key — it is shown only once.
  2. In Settings → General, copy the Organization ID.
  3. In SubImage, fill in:
    • jumpcloud_api_key — the API key (or its AWS Secret ARN)
    • jumpcloud_org_id — your Organization ID
  4. Save the module.

Troubleshooting

  • 401 Unauthorized — the API key is invalid or expired. Generate a new one and update the value in SubImage.
  • 403 Forbidden — the API key lacks admin scope. Generate it from an admin account.
  • Organization ID mismatch — the API key and jumpcloud_org_id must belong to the same organization.