Documentation
    {{docApp.userSession.userId}}
    {{docApp.userSession.userName}}
    {{docApp.userSession.email}}
    Issuer : {{docApp.userSession.issuerInstance}}
    Expires : {{new Date(docApp.userSession.validUntil).toLocaleDateString()}}

{{docApp.title}}

{{docApp.description}}

How can we help?

{{docApp.searchError}}
{{product.name}}

Searching in {{docApp.searchFilterBySpecificBookTitle}}

{{docApp.searchResultFilteredItems.length}} results for: {{docApp.currentResultsSearchText}} in {{docApp.searchFilterBySpecificBookTitle}}
Search results have been limited. There are a total of {{docApp.searchResponse.totalResultsAvailable}} matches.

You have an odd number of " characters in your search terms - each one needs closing with a matching " character!

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

{{group.title || group.id}}

{{group.description}}

  1. {{book.title}}

{{group.title}}

{{book.title}}
More...

Software / Update

  • Article
  • 2 minutes to read

Operation Information

Update Licensed Software within jamf.

This is a Premium Integration.

Authentication

This operation requires authentication, the details of which can be securely stored on your instance in a KeySafe Key of type Jamf.

To create a key of this type:

  • In the Configuration area of your Hornbill instance, navigate to Platform Configuration > Security > KeySafe;
  • Click on the + Create New Key button;
  • On the resulting Create New Key form, choose Jamf in the Type pick list;
  • Give the Jamf KeySafe key a Title (this is the name / identifier for the Jamf account as you will see it when using the cloud automation node in your workflows);
  • Optionally populate the Description field;
  • Populate the following fields accordingly, then click the Create Key button to create your new key:
Name Type Description
Username string Jamf username
Jamf Server string The server name for your jamf instance this can be found in your url before '.jamfcloud.com'
Password string Your Jamf Password

Revoking Access

If at any point you wish to revoke access to any of the above accounts from your Hornbill instance, just delete the relevant KeySafe key(s) from the KeySafe list.

Warning

This will revoke the rights of any existing Cloud Automation Node in your Hornbill Workflows that are using the revoked Jamf account, so you will need to manage these workflows accordingly.

Input Parameters

Display Name ID Type Description Required Supported Values
Software ID softwareId string The Unique ID of the Software Yes None provided
Software Name name string The Name of the Software No None provided
Publisher Name publisher string The name of the Publisher for the Software No None provided
Platform Name platform string The Platform name for this Software No None provided
Send Email On Violation sendEmailOnViolation boolean Informs a user on violation of the Software No None provided
Remove Titles From Inventory Reports removeTitlesFromInventoryReports boolean Create Titleless inventory reports No None provided
Exclude Titles Purchased From App Store excludeTitlesPurchasedFromAppStore boolean Excludes title purchased form the application store No None provided
Notes notes string Any notes made against the software No None provided
Compare Type compareType string What the comparison is against No None provided
Comparison Type Name compareName string The Name of the comparison type No None provided
Compare Type Version compareVersion string The Version Number of the Compare Type No None provided

Output Parameters

Display Name ID Type Description
Error Message error string Any error message returned by jamf
Status Code status string The status of the operation, ok/failed
Software ID id string The unique identifier number for the updated Software
  • Version {{docApp.book.version}}
  • Node {{docApp.node}} / {{docApp.build}}
In This Document