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 Pro data into Oomnitza, you must have the following:

• Your Jamf credentials. These credentials need to be added to Oomnitza before you complete the next steps. For further information, refer to Adding Jamf (OAuth 2.0) credentials.
• The URL of the Jamf Pro instance such as https://<instance_name>.jamfcloud.com.

Integrate Jamf with Oomnitza

Information
When creating the asset integration, check Software  to retrieve information about the names and versions of software.

1. In Oomnitza, click Configuration> Integrations> Overview.
2. Click Integrations List View.
3. Scroll down to the Extended section for asset integrations.
4. Click NEW INTEGRATION.
5. Select the integration in the sidebar.
6. Click ADD.

Integration Overview

More information is provided about the following fields to help you complete the integration:

• Integration preferences:  By default,  Create and Update are selected. To ensure that only live user records are synced with Oomnitza, select Update Only. When you run the integration, you can check the error logs to see the records that weren't uploaded and why they weren't uploaded. Then, you can decide whether to upload the user records that were skipped by changing your integration preference back to Create and Update.

Integration details

To review or update the integrations details, click the pencil:

1. Update the integration name if necessary. 
2. For installation type, ensure that Cloud is selected.
3. For integration preferences, select an option.
4. Enter the name of the integration user.

Credential details

Choose one of the following options:

• Select the credentials that were created for the integration.
• Edit the credentials that were created for the integration.
• Create new credentials

Schedule

By default, user 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. Click the pencil.
2. Configure your schedule.
3. Click Update.

Mappings

To map the fields to Oomnitza, click the pencil.

Creating custom mappings

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

Did you know? 
You can define rules for your integration by selecting Edit integration at the top of the screen. For example, you may only want to run the integration if a certain contact or region exists. See Filtering integration results.  

You can add new fields to your integration by selecting the + (Add) option. All you need to do is specify the field name and then enter the JSON path, for example {{response.email}}. See Creating custom API fields. 

Launching the integration

Your integration is in Draft mode until all the required mandatory fields are added. Once you have added all of the required fields, we recommend that you complete the following steps

1. Select Launch to activate your integration.
2. Change your Integration preferences to Update only so that no records are imported and do a Test Run.
3. Click Sync Sessions and review the status of the integration. If you encounter any errors, see troubleshooting integrations.
4. When the test run has been completed, change your Integration preferences and click Run Now.

Getting your results
To view the information that is collected about your assets, click Assets. To view the information about software, click an asset and then click the Software tab. To view the information that is collected about your users, click People. 

Related Links

• Running an extended integration
• Troubleshooting integrations
• Mapping extended integrations

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 Configuration > General > 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. Click Configuration > Workflows > 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