JumpCloud

Version: 1.0.0

JumpCloud's revolutionary directory unifies device and identity on Windows, Mac, and Linux with cloud based SSO, MDM, MFA, PAM, and more.

Connect JumpCloud with LogicHub

  1. Navigate to Automations > Integrations.
  2. Search for JumpCloud.
  3. Click Details, then the + icon. Enter the required information in the following fields.
    • Label: Enter a connection name.
    • Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.
    • Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).
    • Remote Agent: Run this integration using the LogicHub Remote Agent.
    • X-API Key: X-API Key for the JumpCloud API.
  4. After you've entered all the details, click Connect.

Actions for JumpCloud

List All System Users

This action returns all system users. Scopes: commandrunner.legacy,users,users.readonly

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input NameDescriptionRequired
ParamsJinja-templated JSON containing the params for the JumpCloud API. Example: '{"limit":"10","skip":"0","sort":"","fields":"","filter":"SOME_STRING_VALUE","search":"SOME_STRING_VALUE"}'Optional
X-org-idJinja-templated text containing the x-org-id for the JumpCloud API.Optional

Output

JSON containing the following items:

{
   "results":[
      {
         "account_locked":false,
         "activated":false,
         "addresses":[
            
         ],
         "allow_public_key":true,
         "alternateEmail":null,
         "attributes":[
            
         ],
         "disableDeviceMaxLoginAttempts":false,
         "email":"[email protected]",
         "enable_managed_uid":false,
         "enable_user_portal_multifactor":false,
         "externally_managed":false,
         "firstname":"Admin",
         "lastname":"XYZ",
         "ldap_binding_user":false,
         "manager":null,
         "mfa":{
            "exclusion":false,
            "configured":false
         },
         "password_never_expires":false,
         "passwordless_sudo":false,
         "phoneNumbers":[
            
         ],
         "samba_service_user":false,
         "ssh_keys":[
            
         ],
         "state":"ACTIVATED",
         "sudo":false,
         "suspended":false,
         "unix_guid":123,
         "unix_uid":123,
         "username":"admin",
         "creationSource":"jumpcloud:gapps",
         "created":"2022-02-02T04:25:38.622Z",
         "organization":"asdf1234",
         "password_expired":false,
         "totp_enabled":false,
         "_id":"61asdf7b52aasdfas6bb",
         "id":"61asdf7b52aasdfas6bb",
         "mfaEnrollment":{
            "totpStatus":"NOT_ENROLLED",
            "webAuthnStatus":"NOT_ENROLLED",
            "pushStatus":"NOT_ENROLLED",
            "overallStatus":"NOT_ENROLLED"
         }
      },
      {
         "account_locked":false,
         "activated":false,
         "addresses":[
            
         ],
         "allow_public_key":true,
         "alternateEmail":null,
         "attributes":[
            
         ],
         "company":"",
         "costCenter":"",
         "department":"",
         "description":"",
         "disableDeviceMaxLoginAttempts":false,
         "displayname":"",
         "email":"[email protected]",
         "employeeIdentifier":null,
         "employeeType":"",
         "enable_managed_uid":false,
         "enable_user_portal_multifactor":false,
         "external_dn":"",
         "external_source_type":"",
         "externally_managed":false,
         "firstname":"XYZ",
         "jobTitle":"",
         "lastname":"Services",
         "ldap_binding_user":false,
         "location":"",
         "managedAppleId":"",
         "manager":null,
         "mfa":{
            "exclusion":false,
            "configured":false
         },
         "middlename":"",
         "password_never_expires":false,
         "passwordless_sudo":false,
         "phoneNumbers":[
            
         ],
         "samba_service_user":false,
         "ssh_keys":[
            
         ],
         "state":"ACTIVATED",
         "sudo":false,
         "suspended":false,
         "systemUsername":"",
         "unix_guid":1234,
         "unix_uid":1234,
         "username":"service",
         "creationSource":"jumpcloud:gapps",
         "created":"2022-02-08T04:23:33.323Z",
         "organization":"5dasdf464172asdfasdf39",
         "password_expired":false,
         "totp_enabled":false,
         "_id":"62asdf462d1casdfa828",
         "id":"62asdf462d1casdfa828",
         "mfaEnrollment":{
            "totpStatus":"NOT_ENROLLED",
            "webAuthnStatus":"NOT_ENROLLED",
            "pushStatus":"NOT_ENROLLED",
            "overallStatus":"NOT_ENROLLED"
         }
      }
   ],
   "totalCount":1026,
   "error":null,
   "has_error":false
}

Expire a System User's Password

This action allows you to expire a user's password. Scopes: users

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input NameDescriptionRequired
System User IDJinja-templated text containing the system user's ID for the JumpCloud API. Example '46ca07ca9c6ba9c699ac6bb'Required
X-org-idJinja-templated text containing the x-org-id for the JumpCloud API.Optional

Output

JSON containing the following items:

{
	 "msg":"Successful",
   "error":null,
   "has_error":false
}

Release Notes

  • v1.0.0 - Added 2 actions: List All System Users and Expire a System User's Password action.

© 2017-2021 LogicHub®. All Rights Reserved.