Creating an extended integration for Jamf Apple assets and software (OAuth 2.0)

Let Oomnitza be your single source of truth!

You'll get visibility of your Apple assets and software as data from Jamf is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Jamf in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key asset and software information
• Configurable reports to share information about assets and software with your colleagues and management such as corporate-wide reports that detail the distribution and status of the assets and software in your environment
• Configurable workflows that you can create such as
  • Workflows for deleting computers, and for remotely locking and erasing devices 
  • Workflows for editing a computer's extension attribute, general attribute, location, and purchasing attribute 
  • Workflows for adding a user, getting a user's details, and updating a user's details
  • Workflows for deleting users

Navigation

Adding credentials

Integrate Jamf with Oomnitza

Create workflows

Before you start

To stream Jamf data into Oomnitza, you must add your OAuth 2.0 credentials to the Oomnitza vault. 

The user’s credentials that are added must have read-only access to device information and access to the Jamf Pro API.

Add credentials to the vault in Oomnitza

To add Jamf credentials to Oomnitza, see Adding Jamf (OAuth 2.0) credentials.

Next step

You use the credentials that you added to create and customize your Jamf integration with Oomnitza.

Integrate Jamf with Oomnitza

Info and connect details

1. Click Settings.
2. Click Integrations List View .
3. On the Integrations page, scroll down to the Extended section for Assets.
4. Click NEW INTEGRATION.
5. In the New Asset Integration sidebar, click Jamf.
6. To integrate Oomnitza with the Jamf Asset and Software Load (OAuth 2.0), click APPLY and then click NEXT twice.

On the Connect page, complete these steps:

1. Enter a descriptive name for the integration such as Jamf Assets and Software. That'll be the name of the integration that is shown on the Integrations page.
2. Select Software to retrieve information about the names and versions of software.
3. Select Cloud as the installation type.
4. From the Credentials list, select the credentials from the Oomnitza vault that you added for the connection.
5. Enter the name of the user of the integration.
6. Enter the URL of your Jamf Pro instance. The format of the URL is as follows: https://<customer-subdomain>.jamfcloud.com/.
7. Click Next.

Mappings

Custom mappings
To find out if more fields can be mapped from Jamf Pro to Oomnitza, contact [e-mail].

The following information about your assets, can be mapped to Oomnitza:

Active Directory Status
Alt. MAC Address
Applecare ID
Asset Tag
Available RAM Slots
Barcode #1
Barcode #2
Battery Capacity
Boot ROM
Building
Bus Speed
Cache Size (KB)
Computer Name
Connector Sync Time
Department
Disk Encryption Configuration
Distribution Point
Email Address
Gatekeeper Status
ID (Computer ID)
Initial Entry Date
Institutional Recovery Key
IPv4 Address
Is BLE Capable
Is iTunes Store Account Active
Is Leased
Is Master Password Set
Is MDM Capable
Is Purchased
Is Supervised
JAMF Version
Last Contact Time
Last known IPv4 Address
Lease Expires
Life Expectancy
MAC Address
Make
Model Identifier
Model
NIC Speed
Number of Cores
Number of Processors
Optical Drive
OS Applecare ID
OS Build
OS Maintenance Expires
OS Name
OS Version
Phone Number
Platform
PO Date
PO Number
Position
Processor Architecture
Processor Speed MHz
Processor Speed
Processor Type
Purchase Price
Purchasing Account
Purchasing Contact
Real Name
Report Date
Room
Serial Number
Service Pack
SIP Status
SMC Version
Total Memory (MB)
UDID (Computer)
Username
Vendor
Warranty Expires
Xprotect Version

Map the Jamf fields to Oomnitza fields to get the information that you need to manage Apple assets and software.

To learn more, see Mapping.

When you've completed mapping Jamf Pro to Oomnitza fields, click NEXT. 

Schedule

By default, Jamf data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN. 

If you want to change the integration settings, click the integration tile, and then click a navigation link on the page, such as 4 Mappings, and edit the settings.

Add the Jamf subdomain as a global variable

To save time when you create workflows, you can add the Jamf subdomain as a global variable in Oomnitza.

1. In Oomnitza, click Settings > Global Settings.
2. Click Add new variable (+). 
3. Enter Jamf.Subdomain as the variable name.
4. Enter your subdomain. The format of the instance URL is https://<customer-subdomain>.jamfcloud.com/. You enter the part of the URL that is between the angle brackets. 
5. Click SAVE.

Create workflows

To reduce your workload and automate complex and repetitive tasks, you can use API presets to create asset and user workflows.

1. From the menu, click Assets.
2. Click Add (+). The Begin and End blocks are automatically added to the sandbox.
3. Enter the name and a description of the workflow. 
4. Edit the Begin block by choosing a schedule and adding the rules that will trigger the workflow. For example, add the rule Name equals Jamf, and a rule to trigger the workflow.
5. Click the Blocks tab, and  drag and drop the API block onto the canvas.
6. Click the Edit button.
7. Enter Jamf  in the search field and choose one of the following presets. To add a preset, you must select credentials and enter your Jamf subdomain. 

   • Jamf Add User

   • Jamf Delete Computer

   • Jamf Delete User

   • Jamf Edit Computer Extension Attribute

   • Jamf Edit Computer General Attribute

   • Jamf Edit Computer Location Attribute

   • Jamf Edit Computer Purchasing Attribute

   • Jamf Get user Details

   • Jamf Remote Erase Device

   • Jamf Remote Lock Device

   • Jamf Update User

8. Click the right arrow >.
   1. Select your credentials.
   2. Click SAVE.
9. Connect the blocks.
10. Validate, launch, and save your workflow.

See Jamf integrations for more information about API asset and user presets. 

Did you know
You can use the expressions that are provided in the Jinja2 template to retrieve the values of extension attributes from Jamf Pro. You simply replace the name of the extension attribute with the name of the attribute:
{% set ext_attrs = computer.extension_attributes %}{% for x in ext_attrs %}{% if x.name == "Extension Attribute Name" %}{{x.value}}{% else %}{% endif %}{% endfor %}
Need help? Contact [e-mail]..

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your assets and software
• Configure custom reports about your assets and software

See Getting started.

Related links

Extended Integration for Jamf Apple Assets and Software (Basic Auth)

Extended Integration for Jamf Mobile Assets (Basic Auth)

  Extended integration for Jamf enrollment devices