[ 1 Connect JumpCloud with Devo SOAR ] [ 2 Actions for JumpCloud ] [ 2.1 List All System Users ] [ 2.1.1 Input Field ] [ 2.1.2 Output ] [ 2.2 Expire a System User's Password ] [ 2.2.1 Input Field ] [ 2.2.2 Output ] [ 3 Release Notes ]

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 Devo SOAR

Navigate to Automations > Integrations.
Search for JumpCloud.
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 Devo SOAR Remote Agent.
X-API Key: X-API Key for the JumpCloud API.
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 Name	Description	Required

Input Name	Description	Required
Params	Jinja-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-id	Jinja-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":"admin@xyz.com",
         "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":"asdf@XYZ.com",
         "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 Name	Description	Required

Input Name	Description	Required
System User ID	Jinja-templated text containing the system user's ID for the JumpCloud API. Example '46ca07ca9c6ba9c699ac6bb'	Required
X-org-id	Jinja-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.