NinjaOne
Visualize NinjaOne Users, Devices, Policies, Alerts, and monitor changes through queries and alerts.
- Installation guide
- NinjaOne data model
- NinjaOne types
Installation
Requirements
- User requires Client ID and Client Secret generated in NinjaOne Account.
- You must have permission in JupiterOne to install new integrations.
Configuration in NinjaOne
Create Client App and Generate Client ID and Client Secret
- Visit the Apps page in the NinjaOne portal.
- Navigate to the API tab.
- Select Client App IDs.
- Click the Add button and choose Application Platform as Web (PHP, Java, .NET Core, etc.).
- Provide a Name for the Client Application.
- Select the Monitoring & Management Scope checkbox.
- Under Allowed grant types, select Client Credentials and Refresh Token.
- Click the Save button.
- Copy the Client Secret—it will disappear once you close the window.
- Close the window and copy the Client ID. This will be needed for configuring the integration in the JupiterOne portal.
Configuration in JupiterOne
- From the top navigation of the J1 Search homepage, select Integrations
- Search for the NinjaOne and select it.
- Click on the Add Instance button and configure the following settings:
- Enter the Account Name by which you'd like to identify this NinjaOne
Cloud instance in JupiterOne. Ingested entities will have this value stored in
tag.AccountName
when Tag with Account Name is checked. - Enter a Description that will further assist your team when identifying the integration instance.
- Select a Polling Interval that you feel is sufficient for your monitoring
needs. You may leave this as
DISABLED
and manually execute the integration. - Enter the NinjaOne Client ID generated for use by JupiterOne.
- Enter the NinjaOne Client Secret generated for use by JupiterOne.
- Click Create Configuration once all values are provided.
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Data Model
Entities
The following entities are created:
Resources | Entity _type | Entity _class |
---|---|---|
Account | ninjaone_account | Account |
Device | ninjaone_device | Device |
Incident | ninjaone_alert | Alert |
Policy | ninjaone_controlpolicy | ControlPolicy |
User | ninjaone_user | User |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
---|---|---|
ninjaone_account | OWNS | ninjaone_device |
ninjaone_controlpolicy | ENFORCES | ninjaone_device |
ninjaone_device | HAS | ninjaone_alert |
ninjaone_user | OWNS | ninjaone_device |
Ninjaone Account
ninjaone_account
inherits from Account
Property | Type | Description | Specifications |
---|---|---|---|
_key * | string | ||
mfaEnabled * | boolean | ||
name * | string |
Ninjaone User
ninjaone_user
inherits from User
Property | Type | Description | Specifications |
---|---|---|---|
name * | string | ||
displayName * | string | ||
email * | string | ||
active * | boolean | ||
firstName * | string | ||
lastName * | string | ||
phoneNumber * | string | ||
isAdmin * | boolean | ||
permitAllClients * | boolean | ||
notifyAllClients * | boolean | ||
mustChangePassword * | boolean | ||
mfaEnabled * | boolean | ||
userType * | string | ||
invitationStatus * | string | ||
tags | array of string s | ||
fields | array of string s |
Ninjaone Controlpolicy
ninjaone_controlpolicy
inherits from ControlPolicy
Property | Type | Description | Specifications |
---|---|---|---|
_key * | string | ||
name * | string | ||
displayName * | string | ||
parentPolicyId | number | ||
description | string | ||
nodeClass * | string | ||
nodeClassDefault * | boolean | ||
tags | array of string s |
Ninjaone Device
ninjaone_device
inherits from Device
Property | Type | Description | Specifications |
---|---|---|---|
organizationId * | number | ||
locationId * | number | ||
nodeClass * | string | ||
nodeRoleId * | number | ||
rolePolicyId * | number | ||
policyId | number | ||
approvalStatus * | string | ||
name * | string | ||
ipAddresses | array of string s | ||
publicIP | string | ||
osArchitecture | string | ||
osLastBootOn | number | ||
osBuildNumber | string | ||
osServicePackMajorVersion | number | ||
osServicePackMinorVersion | number | ||
osLocale | string | ||
osLanguage | string | ||
osNeedsReboot | boolean | ||
biosSerialNumber | string | ||
domainRole | string | ||
numberOfProcessors | number | ||
totalPhysicalMemoryInBytes | number | ||
totalPhysicalMemory | string | ||
isVirtualMachine | boolean | ||
chassisType | string | ||
memoryCapacity | number | ||
processorArchitectures | array of string s | ||
processorMaxClockSpeeds | array of number s | ||
processorClockSpeeds | array of number s | ||
processorNames | array of string s | ||
processorNumCores | array of number s | ||
processorNumLogicalCores | array of number s | ||
lastLoggedInUser | string | ||
category * | string | ||
bitLockerVolumeName | string | The name of the first volume with BitLocker enabled. Multiple volumes with BitLocker enabled will not be represented. | |
bitLockerConversionStatus | string | Any of: FULLY_DECRYPTED FULLY_ENCRYPTED ENCRYPTION_IN_PROGRESS DECRYPTION_IN_PROGRESS ENCRYPTION_PAUSED DECRYPTION_PAUSED UNKNOWN | |
bitLockerEncryptionMethod | string | Any of: NONE AES_128_WITH_DIFFUSER AES_256_WITH_DIFFUSER AES_128 AES_256 HARDWARE_ENCRYPTION XTS_AES_128 XTS_AES_256 UNKNOWN | |
bitLockerProtectionStatus | string | Any of: UNPROTECTED PROTECTED UNKNOWN PENDING | |
bitLockerLockStatus | string | Any of: UNKNOWN UNLOCKED LOCKED | |
bitLockerInitializedForProtection | boolean |
Ninjaone Alert
ninjaone_alert
inherits from Alert
Property | Type | Description | Specifications |
---|---|---|---|
_key * | string | ||
name * | string | ||
deviceId * | number | ||
message * | string | ||
sourceConfigUid * | string | ||
sourceName * | string | ||
sourceType | string | ||
subject | string | ||
userId | number | ||
ticketTemplateId | number |