JumpCloud

Collect logs from JumpCloud Directory as a Service

Version
1.12.0 (View all)
Compatible Kibana version(s)
8.13.0 or higher
Supported Serverless project types

Security
Observability
Subscription level
Basic
Level of support
Community

The JumpCloud integration allows you to monitor events related to the JumpCloud Directory as a Service via the Directory Insights API.

You can find out more about JumpCloud and JumpCloud Directory Insights here

Data streams

A single data stream named "jumpcloud.events" is used by this integration.

Requirements

An Elastic Stack with an Elastic Agent is a fundamental requirement.

An established JumpCloud tenancy with active users is the the other requirement. Basic Directory Insights API access is available to all subscription levels.

NOTE: The lowest level of subscription currently has retention limits, with access to Directory Insights events for the last 15 days at most. Other subscriptions levels provide 90 days or longer historical event access.

A JumpCloud API key is required, the JumpCloud documentation describing how to create one is here

This JumpCloud Directory Insights API is documented here

Configuration

JumpCloud API Key

Ensure you have created a JumpCloud admin API key that you have access to, refer to the link above which provides instructions how to create one.

Enabling the integration in Elastic

  1. In Kibana go to Management > Integrations
  2. In "Search for integrations" search bar type JumpCloud
  3. Click on "JumpCloud" integration from the search results.
  4. Click on Add JumpCloud button to add the JumpCloud integration.
  5. Configure the integration as appropriate
  6. Assign the integration to a new Elastic Agent host, or an existing Elastic Agent host

Events

The JumpCloud events dataset provides events from JumpCloud Directory Insights events that have been received.

All JumpCloud Directory Insights events are available in the jumpcloud.events field group.

Exported fields

FieldDescriptionType
@timestamp
Event timestamp.
date
data_stream.dataset
Data stream dataset.
constant_keyword
data_stream.namespace
Data stream namespace.
constant_keyword
data_stream.type
Data stream type.
constant_keyword
input.type
keyword
jumpcloud.event.application.display_label
keyword
jumpcloud.event.application.id
keyword
jumpcloud.event.application.name
keyword
jumpcloud.event.application.sso_url
keyword
jumpcloud.event.association.action_source
keyword
jumpcloud.event.association.connection.from.name
keyword
jumpcloud.event.association.connection.from.object_id
keyword
jumpcloud.event.association.connection.from.type
keyword
jumpcloud.event.association.connection.to.name
keyword
jumpcloud.event.association.connection.to.object_id
keyword
jumpcloud.event.association.connection.to.type
keyword
jumpcloud.event.association.op
keyword
jumpcloud.event.attr
keyword
jumpcloud.event.auth_context.auth_methods.duo.success
boolean
jumpcloud.event.auth_context.auth_methods.jumpcloud_protect.success
boolean
jumpcloud.event.auth_context.auth_methods.password.success
boolean
jumpcloud.event.auth_context.auth_methods.totp.success
boolean
jumpcloud.event.auth_context.auth_methods.webauthn.success
boolean
jumpcloud.event.auth_context.jumpcloud_protect_device.app_version
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.geoip.continent_code
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.geoip.country_code
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.geoip.latitude
float
jumpcloud.event.auth_context.jumpcloud_protect_device.geoip.longitude
float
jumpcloud.event.auth_context.jumpcloud_protect_device.geoip.region_code
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.geoip.region_name
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.geoip.timezone
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.id
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.ip
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.make
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.model
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.os
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.os_version
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.user_id
keyword
jumpcloud.event.auth_context.jumpcloud_protect_device.username
keyword
jumpcloud.event.auth_context.policies_applied.id
keyword
jumpcloud.event.auth_context.policies_applied.metadata.action
keyword
jumpcloud.event.auth_context.policies_applied.metadata.resource_type
keyword
jumpcloud.event.auth_context.policies_applied.name
keyword
jumpcloud.event.auth_meta.auth_methods.password.success
boolean
jumpcloud.event.auth_method
keyword
jumpcloud.event.base
keyword
jumpcloud.event.changes
flattened
jumpcloud.event.client_ip
keyword
jumpcloud.event.connection_id
keyword
jumpcloud.event.deref
long
jumpcloud.event.dn
keyword
jumpcloud.event.error_code
long
jumpcloud.event.error_message
keyword
jumpcloud.event.event_type
keyword
jumpcloud.event.filter
keyword
jumpcloud.event.geoip.continent_code
keyword
jumpcloud.event.geoip.country_code
keyword
jumpcloud.event.geoip.latitude
float
jumpcloud.event.geoip.longitude
float
jumpcloud.event.geoip.region_code
keyword
jumpcloud.event.geoip.region_name
keyword
jumpcloud.event.geoip.timezone
keyword
jumpcloud.event.id
keyword
jumpcloud.event.idp_initiated
boolean
jumpcloud.event.initiated_by.email
keyword
jumpcloud.event.initiated_by.id
keyword
jumpcloud.event.initiated_by.type
keyword
jumpcloud.event.initiated_by.username
keyword
jumpcloud.event.mech
keyword
jumpcloud.event.message
keyword
jumpcloud.event.mfa
boolean
jumpcloud.event.mfa_meta.type
keyword
jumpcloud.event.number_of_results
long
jumpcloud.event.operation_number
long
jumpcloud.event.operation_type
keyword
jumpcloud.event.organization
keyword
jumpcloud.event.process_name
keyword
jumpcloud.event.provider
keyword
jumpcloud.event.resource.email_type
keyword
jumpcloud.event.resource.id
keyword
jumpcloud.event.resource.recipient_email
keyword
jumpcloud.event.resource.type
keyword
jumpcloud.event.resource.username
keyword
jumpcloud.event.scope
long
jumpcloud.event.service
keyword
jumpcloud.event.src_ip
keyword
jumpcloud.event.sso_token_success
boolean
jumpcloud.event.start_tls
boolean
jumpcloud.event.success
boolean
jumpcloud.event.system.displayName
keyword
jumpcloud.event.system.hostname
keyword
jumpcloud.event.system.id
keyword
jumpcloud.event.system_timestamp
keyword
jumpcloud.event.timestamp
keyword
jumpcloud.event.tls_established
boolean
jumpcloud.event.useragent.device
keyword
jumpcloud.event.useragent.major
keyword
jumpcloud.event.useragent.minor
keyword
jumpcloud.event.useragent.name
keyword
jumpcloud.event.useragent.os
keyword
jumpcloud.event.useragent.os_full
keyword
jumpcloud.event.useragent.os_major
keyword
jumpcloud.event.useragent.os_minor
keyword
jumpcloud.event.useragent.os_name
keyword
jumpcloud.event.useragent.os_patch
keyword
jumpcloud.event.useragent.os_version
keyword
jumpcloud.event.useragent.patch
keyword
jumpcloud.event.useragent.version
keyword
jumpcloud.event.username
keyword
jumpcloud.event.version
keyword

An example event for events looks as following:

{
    "@timestamp": "2023-01-14T08:16:06.495Z",
    "agent": {
        "ephemeral_id": "6bb5080e-3d3c-4b5c-8d62-af0f195b06c8",
        "id": "747b3f2a-8b40-4ee3-9ddd-ec86e51f9342",
        "name": "docker-fleet-agent",
        "type": "filebeat",
        "version": "8.10.1"
    },
    "client": {
        "geo": {
            "city_name": "London",
            "continent_name": "Europe",
            "country_iso_code": "GB",
            "country_name": "United Kingdom",
            "location": {
                "lat": 51.5142,
                "lon": -0.0931
            },
            "region_iso_code": "GB-ENG",
            "region_name": "England"
        },
        "ip": "81.2.69.144"
    },
    "data_stream": {
        "dataset": "jumpcloud.events",
        "namespace": "ep",
        "type": "logs"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "747b3f2a-8b40-4ee3-9ddd-ec86e51f9342",
        "snapshot": false,
        "version": "8.10.1"
    },
    "event": {
        "action": "admin_login_attempt",
        "agent_id_status": "verified",
        "category": [
            "authentication"
        ],
        "created": "2023-10-26T06:57:29.823Z",
        "dataset": "jumpcloud.events",
        "id": "63c264c6c1bd55c1b7e901a4",
        "ingested": "2023-10-26T06:57:32Z",
        "module": "directory",
        "original": "{\"@version\":\"1\",\"changes\":[{\"field\":\"active\",\"to\":true},{\"field\":\"displayName\",\"to\":\"Willy Wonka\"},{\"field\":\"emails\",\"to\":[{\"primary\":true,\"type\":\"work\",\"value\":\"w.wonka@chocolate.biz\"}]},{\"field\":\"externalId\",\"to\":\"63ec9bba89a64e507ce0a4c2\"},{\"field\":\"schemas\",\"to\":[\"urn:ietf:params:scim:schemas:core:2.0:User\",\"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User\"]}],\"client_ip\":\"81.2.69.144\",\"event_type\":\"admin_login_attempt\",\"geoip\":{\"continent_code\":\"OC\",\"country_code\":\"AU\",\"latitude\":-27.658,\"longitude\":152.8915,\"region_code\":\"QLD\",\"region_name\":\"Queensland\",\"timezone\":\"Australia/Brisbane\"},\"id\":\"63c264c6c1bd55c1b7e901a4\",\"initiated_by\":{\"email\":\"user.name@sub.domain.tld\",\"id\":\"123456789abcdef123456789\",\"type\":\"admin\"},\"mfa\":true,\"organization\":\"1234abcdef123456789abcde\",\"provider\":null,\"service\":\"directory\",\"success\":true,\"timestamp\":\"2023-01-14T08:16:06.495Z\",\"useragent\":{\"device\":\"Mac\",\"major\":\"109\",\"minor\":\"0\",\"name\":\"Chrome\",\"os\":\"Mac OS X\",\"os_full\":\"Mac OS X 10.15.7\",\"os_major\":\"10\",\"os_minor\":\"15\",\"os_name\":\"Mac OS X\",\"os_patch\":\"7\",\"os_version\":\"10.15.7\",\"patch\":\"0\",\"version\":\"109.0.0.0\"}}",
        "outcome": "success",
        "type": [
            "info"
        ]
    },
    "input": {
        "type": "httpjson"
    },
    "jumpcloud": {
        "event": {
            "changes": [
                {
                    "field": "active",
                    "to": true
                },
                {
                    "field": "displayName",
                    "to": "Willy Wonka"
                },
                {
                    "field": "emails",
                    "to": [
                        {
                            "primary": true,
                            "type": "work",
                            "value": "w.wonka@chocolate.biz"
                        }
                    ]
                },
                {
                    "field": "externalId",
                    "to": "63ec9bba89a64e507ce0a4c2"
                },
                {
                    "field": "schemas",
                    "to": [
                        "urn:ietf:params:scim:schemas:core:2.0:User",
                        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
                    ]
                }
            ],
            "client_ip": "81.2.69.144",
            "event_type": "admin_login_attempt",
            "geoip": {
                "continent_code": "OC",
                "country_code": "AU",
                "latitude": -27.658,
                "longitude": 152.8915,
                "region_code": "QLD",
                "region_name": "Queensland",
                "timezone": "Australia/Brisbane"
            },
            "id": "63c264c6c1bd55c1b7e901a4",
            "initiated_by": {
                "email": "user.name@sub.domain.tld",
                "id": "123456789abcdef123456789",
                "type": "admin"
            },
            "mfa": true,
            "organization": "1234abcdef123456789abcde",
            "service": "directory",
            "success": true,
            "timestamp": "2023-01-14T08:16:06.495Z",
            "useragent": {
                "device": "Mac",
                "major": "109",
                "minor": "0",
                "name": "Chrome",
                "os": "Mac OS X",
                "os_full": "Mac OS X 10.15.7",
                "os_major": "10",
                "os_minor": "15",
                "os_name": "Mac OS X",
                "os_patch": "7",
                "os_version": "10.15.7",
                "patch": "0",
                "version": "109.0.0.0"
            },
            "version": "1"
        }
    },
    "source": {
        "user": {
            "email": "user.name@sub.domain.tld",
            "id": "123456789abcdef123456789"
        }
    },
    "tags": [
        "preserve_original_event",
        "preserve_duplicate_custom_fields",
        "forwarded"
    ],
    "user_agent": {
        "device": {
            "name": "Mac"
        },
        "name": "Chrome",
        "os": {
            "full": "Mac OS X 10.15.7",
            "name": "Mac OS X",
            "version": "10.15.7"
        },
        "version": "109.0.0.0"
    }
}

Changelog

VersionDetailsKibana version(s)

1.12.0

Enhancement View pull request
Populate 'event.outcome' based on 'sso_token_success', when present

8.13.0 or higher

1.11.0

Enhancement View pull request
Update the kibana constraint to ^8.13.0. Modified the field definitions to remove ECS fields made redundant by the ecs@mappings component template.

8.13.0 or higher

1.10.0

Enhancement View pull request
Set sensitive values as secret.

8.12.0 or higher

1.9.1

Enhancement View pull request
Changed owners

8.7.1 or higher

1.9.0

Enhancement View pull request
Limit request tracer log count to five.

8.7.1 or higher

1.8.0

Enhancement View pull request
ECS version updated to 8.11.0.

8.7.1 or higher

1.7.1

Bug fix View pull request
Fix mapping for jumpcloud.event.changes.

8.7.1 or higher

1.7.0

Enhancement View pull request
Improve 'event.original' check to avoid errors if set.

8.7.1 or higher

1.6.0

Enhancement View pull request
Set 'community' owner type.

8.7.1 or higher

1.5.0

Enhancement View pull request
ECS version updated to 8.10.0.

8.7.1 or higher

1.4.0

Enhancement View pull request
The format_version in the package manifest changed from 2.11.0 to 3.0.0. Added 'owner.type: elastic' to package manifest.

8.7.1 or higher

1.3.0

Enhancement View pull request
Add tags.yml file so that integration's dashboards and saved searches are tagged with "Security Solution" and displayed in the Security Solution UI.

8.7.1 or higher

1.2.2

Bug fix View pull request
Remove version attribute from ingest node pipelines.

8.7.1 or higher

1.2.1

Bug fix View pull request
Add missing field definitions for input.type and jumpcloud.event.version.

8.7.1 or higher

1.2.0

Enhancement View pull request
Update package to ECS 8.9.0.

8.7.1 or higher

1.1.0

Enhancement View pull request
Document valid duration units.

8.7.1 or higher

1.0.0

Enhancement View pull request
Release JumpCloud as GA.

8.7.1 or higher

0.5.0

Enhancement View pull request
Ensure event.kind is correctly set for pipeline errors.

0.4.0

Enhancement View pull request
Update package to ECS 8.8.0.

0.3.0

Enhancement View pull request
Update package-spec version to 2.7.0.

0.2.0

Enhancement View pull request
Add a new flag to enable request tracing

0.1.0

Enhancement View pull request
Update package to ECS 8.7.0.

0.0.2

Bug fix View pull request
Fix img links in readme

0.0.1

Enhancement View pull request
Initial draft of the package

On this page