Dell Asset Management

JupiterOne's integration with Dell Asset Management collects hardware inventory and warranty entitlement data from the Dell TechDirect API, providing visibility into your Dell device fleet and the support coverage attached to each asset.

Installation

Installation

For this integration, you will need:

• A set of Dell TechDirect API OAuth credentials — a Client ID and Client Secret for the TechDirect Asset/Entitlement API. Register at tdm.dell.com to obtain them. See the Dell developer portal for API documentation.
• A CSV file containing the Dell service tags you want to enrich. The integration looks up warranty and entitlement data for each tag against the TechDirect /PROD/sbil/eapi/v5/asset-entitlements endpoint.

info

The integration enriches a customer-supplied list of service tags — it does not auto-discover newly purchased hardware. Re-upload the CSV when new devices ship to bring them into JupiterOne.

Service tags CSV format

The Service Tags (CSV) field accepts either of the following formats:

• One service tag per line, with no header row:

  ABC1234
  DEF5678
  GHI9012

• A CSV with a header row containing a serviceTag column. The header match is case-insensitive, and service_tag and Service Tag are also accepted. Any extra columns are ignored:

  serviceTag,owner,location
  ABC1234,Alice,Boston
  DEF5678,Bob,New York

Tags are automatically trimmed, uppercased, and deduplicated. Blank rows are skipped. A multi-column file that does not contain a recognized service-tag header column is rejected with a configuration error, to avoid silently treating the header row as data.

Configuration in JupiterOne

To install the Dell Asset Management integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Dell Asset Management. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

• The Account Name used to identify the Dell account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

• Description to assist in identifying the integration instance, if desired.

• Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

• TechDirect Client ID: the OAuth client ID for the Dell TechDirect Asset/Entitlement API.

• TechDirect Client Secret: the OAuth client secret for the Dell TechDirect API.

• Service Tags (CSV): upload the CSV file containing the Dell service tags to enrich.

Click Create once all values are provided to finalize the integration.

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.

Authorization

Endpoints

API endpoints that the integration makes requests to.

Show Endpoints (1)

• /PROD/sbil/eapi/v5/asset-entitlements

Documentation Links

Links to provider documentation relevant to setup and configuration.

Show Documentation Links (2)

• https://developer.dell.com/apis
• https://tdm.dell.com

Data Model

Entities

The following entities are created:

Resources	Entity _type	Entity _class
Account	dell_account	Account
Device	dell_device	Device
Entitlement	dell_entitlement	Configuration

Relationships

The following relationships are created:

Source Entity _type	Relationship _class	Target Entity _type
dell_account	HAS	dell_device
dell_device	HAS	dell_entitlement

Types

Dell Account

dell_account inherits from Account

Property	Type	Description	Specifications
clientId *	string	The Dell TechDirect OAuth client ID used as the stable identifier for this customer account.

---

Dell Device

dell_device inherits from Device

Property	Type	Description	Specifications
countryCode *	string | null	The ISO 3166-1 alpha-2 country code recorded for the device shipment.
productCode *	string | null	The internal Dell product/SKU code describing the device configuration.
productFamily *	string | null	The product family grouping reported by TechDirect (e.g. Latitude, PowerEdge).
productLineDescription *	string | null	The human-readable product line description (e.g. Latitude 5440, OptiPlex 7010).
serviceTag *	string	The Dell service tag — the unique hardware identifier printed on the device chassis.
shippedOn *	number | null	The date the device shipped from Dell, as a Unix timestamp in milliseconds.

---

Dell Entitlement

dell_entitlement inherits from Configuration

Property	Type	Description	Specifications
endsOn *	number | null	The date this entitlement expires, as a Unix timestamp in milliseconds.
entitlementType *	string | null	The category of entitlement (e.g. INITIAL, EXTENDED, UPGRADE) as reported by TechDirect.
isActive *	boolean | null	Whether the entitlement is currently active (derived: endsOn is in the future). Null when end date is unknown.
itemNumber *	string	The TechDirect-assigned item number identifying this entitlement record within the device.
serviceLevelCode *	string | null	The Dell service level code identifying the support plan (e.g. ND, PR, KD).
serviceLevelDescription *	string | null	The human-readable description of the service level (e.g. ProSupport Next Business Day).
serviceLevelGroup *	number | null	The numeric grouping that Dell uses internally to bucket related service levels.
serviceTag *	string	The service tag of the device this entitlement covers.
startsOn *	number | null	The date this entitlement becomes effective, as a Unix timestamp in milliseconds.

---

Release Notes