{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21268,"path":"integrate-applications/integration-hub/jamf-spoke.md","title":"Jamf Spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Jamf Spoke\n\nManage users, mobile devices, groups, and computers in the Jamf account from your ServiceNow instance.\n\n## Request apps on the Store\n\nVisit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).\n\n## Integration Hub subscription\n\nThis spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).\n\n## Spoke version\n\nJamf spoke v2.0.0 is the latest version. For version history of the spoke, see [Jamf spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-jamf.html).\n\n## Supported versions\n\nThis spoke was built for Jamf Classic and Pro APIs, but may be compatible with later versions.\n\n## Spoke dependencies\n\nIf you’re having trouble installing the app, ensure that these dependent plugins are installed:\n\n- Complex Object \\(com.glide.cobject\\)\n- ServiceNow IntegrationHub Runtime \\(com.glide.hub.integration.runtime\\)\n- ServiceNow IntegrationHub Action Template - Data Stream \\(com.glide.hub.action\\_type.datastream\\)\n- ServiceNow Flow Designer - Dynamic Inputs \\(com.glide.hub.dynamic\\_inputs\\)\n- ServiceNow IntegrationHub Action Step - REST\\(com.glide.hub.action\\_step.rest\\)\n\n**Note:** Some of these plugins are licensable features and need appropriate licenses, if used outside the spoke implementation. For information on the licenses, contact your account manager.\n\n## Spoke subflows\n\nThe Jamf spoke provides sample subflows to demonstrate automating tasks. To customize a sample subflow, copy it to the required application scope. Available sample subflows include:\n\n|Subflow|Description|\n|-------|-----------|\n|Configure Group|Enables a CSD agent to create and configure the target group in Jamf portal.|\n|Create Software Configuration|Enables a CSD Agent to create the software configuration record of the specified Jamf application.|\n|Discover and Store Data|Discovers the data from the Jamf server and updates the records in Application, Group, and Policy tables.|\n|Look up Application Details|Retrieves the additional details for applications and updates the respective records in the application table.|\n|Deploy Application|Adds the provided user or device to the given group in the Jamf Server.|\n|Revoke Application|Removes the provided user or device from the given group in the Jamf Server.|\n|Look up Configuration Data|Retrieves configuration data for the specified requested item or software configuration record.|\n\n**Note:** These subflows are available only when the [Client Software Distribution 2.0 application](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/csd-app-2.md) is installed.\n\n## Spoke actions\n\nThe Jamf spoke provides actions to automate tasks when events occur in your ServiceNow instance. Available actions include:\n\n\n
\n\nCategory\n\n\n\nAction\n\n\n\nDescription\n\n
\n\nComputer Management\n\n\n\nLook up Application by ID\n\n\n\nRetrieves details of an application by ID in Jamf.\n\n
\n\nLook up Applications Stream\n\n\n\nRetrieves all the applications.\n\n
\n\nLook up Computer by Serial Number\n\n\n\nRetrieves details of computer by serial number in Jamf.\n\n
\n\nLook up Computers Stream\n\n\n\nRetrieves general and hardware details of all the computers.\n\n
\n\nLook up Package by ID\n\n\n\nRetrieves details of package by ID in Jamf.\n\n
\n\nLook up Packages Stream\n\n\n\nRetrieves all the packages.\n\n
\n\nLook up Policies Stream\n\n\n\nRetrieves all the policies.\n\n
\n\nLook up Policy by ID\n\n\n\nRetrieves details of policy by ID in Jamf.\n\n
\n\nAdd Computer Group to Mac Application\n\n\n\nAdds a target computer group to a Mac application given the current scope of the application.\n\n
\n\nAdd User Group to Mac Application\n\n\n\nAdds a target user group to a Mac application given the current scope of the application.\n\n
\n\nRemove Computer Group from Mac Application\n\n\n\nRemoves a target computer group from a Mac application given the current scope of the application.\n\n
\n\nData Management**Note:** These actions are available only when the [Client Software Distribution 2.0 application](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/csd-app-2.md) is installed.\n\n\n\nLook up Configuration Data\n\n\n\nRetrieves the configuration data for the specified requested item or software configuration record.\n\n
\n\nPrepare Software Data\n\n\n\nPrepares the software data for the specified requested item that can be used for deployment or revocation.\n\n
\n\nGroup Management\n\n\n\nAdd Computer to Static Group\n\n\n\nAdds an existing computer to a static group in Jamf.\n\n
\n\nAdd Mobile Device to Static Group\n\n\n\nAdds an existing mobile device to a static group in Jamf.\n\n
\n\nAdd User to Static Group\n\n\n\nAdds an existing user to a static group in Jamf.\n\n
\n\nCreate Static Computer Group\n\n\n\nCreates a static computer group with the given name on the server.\n\n
\n\nCreate Static Mobile Device Group\n\n\n\nCreates a static mobile device group with the given name on the server.\n\n
\n\nCreate Static User Group\n\n\n\nCreates a static user group with the given name on the server.\n\n
\n\nDelete Computer Group\n\n\n\nDeletes the given computer group from the server.\n\n
\n\nDelete Mobile Device Group\n\n\n\nDeletes the given mobile device group from the server.\n\n
\n\nDelete User Group\n\n\n\nDeletes the given user group from the server.\n\n
\n\nIs Computer in Group\n\n\n\nChecks if an existing computer is a member of the specified group in Jamf.\n\n
\n\nIs Mobile Device in Group\n\n\n\nChecks if an existing mobile device is a member of the specified group in Jamf.\n\n
\n\nIs User in Group\n\n\n\nChecks if an existing user is a member of the specified group in Jamf.\n\n
\n\nLook up Computer Group by ID\n\n\n\nRetrieves details of computer group by ID in Jamf.\n\n
\n\nLook up Computer Groups Stream\n\n\n\nRetrieves all the computer groups.\n\n
\n\nLook up Target Groups\n\n\n\nRetrieves the target group details associated with given application.\n\n
\n\nLook up Mobile Device Group by ID\n\n\n\nRetrieves details of mobile device group by ID in Jamf.\n\n
\n\nLook up Mobile Device Groups Stream\n\n\n\nRetrieves all the mobile device groups.\n\n
\n\nLook up User Group by ID\n\n\n\nRetrieves details of user group by ID in Jamf.\n\n
\n\nLook up User Groups Stream\n\n\n\nRetrieves all the user groups.\n\n
\n\nRemove Computer from Static Group\n\n\n\nRemove an existing computer from a static group in Jamf.\n\n
\n\nRemove Mobile Device from Static Group\n\n\n\nRemove an existing mobile device from a static group in Jamf.\n\n
\n\nRemove User from Static Group\n\n\n\nRemove an existing user from a static group in Jamf.\n\n
\n\nMobile Device Management\n\n\n\nLook up Mobile Device Application by ID\n\n\n\nRetrieves details of mobile device application by ID from Jamf.**Note:** Configure the system property **com.glide.attachment.max\\_get\\_size** to customize the size of attachment that can be retrieved. The default value is 5 MB.\n\n
\n\nLook up Mobile Device Applications Stream\n\n\n\nRetrieves all the mobile device applications.\n\n
\n\nLook up Mobile Device by Serial Number\n\n\n\nRetrieves details of mobile device by serial number in Jamf.\n\n
\n\nLook up Mobile Devices Stream\n\n\n\nRetrieves details of all the mobile devices.\n\n
\n\nUser Management\n\n\n\nLook up User by ID\n\n\n\nRetrieves details of user by ID in Jamf.\n\n
\n\nLook up User by Name\n\n\n\nRetrieves details of user by user name in Jamf.\n\n
\n\nLook up Users Stream\n\n\n\nRetrieves all the users.\n\n
\n\nSoftware Management\n\n\n\nLook up Computer Application Scope\n\n\n\nRetrieves scope of a given computer application from the server.\n\n
\n\nLook up Mobile Device Application Scope\n\n\n\nRetrieves scope of a given mobile device application from the server.\n\n
\n\nMobile Device Management\n\n\n\nRemove Mobile Device Group from Mobile Device Application\n\n\n\nRemoves a target mobile device group from a mobile device application given the current scope of the application.\n\n
\n\nAdd Mobile Device Group to Mobile Device Application\n\n\n\nAdds a target mobile device group to a mobile device application given the current scope of the application.\n\n
\n\nAdd User Group to Mobile Device Application\n\n\n\nAdds a target user group to a mobile device application given the current scope of the application.\n\n
\n\nRemove Mobile Device Group from Mobile Device Application\n\n\n\nRemoves a target mobile device group from a mobile device application given the current scope of the application.\n\n
\n\nRemove User Group from Mobile Device Application\n\n\n\nRemoves a target user group from a mobile device application given the current scope of the application.\n\n
## Spoke module\n\nThe Jamf spoke adds the Jamf application to your instance. The application includes these modules and data accessed through the spoke modules is stored in the respective tables:\n\n|Module|Description|Table|\n|------|-----------|-----|\n|Applications|Displays the list of applications from the Jamf server.|Application \\[sn\\_jamf\\_spoke\\_application\\]|\n|Groups|Displays the list of groups from the Jamf server.|Group \\[sn\\_jamf\\_spoke\\_group\\]|\n|Configurations|Stores software configuration details for the applications.|Configuration \\[sn\\_jamf\\_spoke\\_sf\\_config\\]|\n|Policies|Displays the list of policies from the Jamf server.|Policy \\[sn\\_jamf\\_spoke\\_policy\\]|\n|Server Instances|Stores details of the provider servers.|Server Instance \\[sn\\_jamf\\_spoke\\_server\\]|\n\n**Note:** These modules and tables are available only when the [Client Software Distribution 2.0 application](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/csd-app-2.md) is installed.\n\nAnother table is Jamf Credential \\[sn\\_jamf\\_spoke\\_jamf\\_credential\\] is available that stores details of the credential records. This table is available along with the Jamf spoke and doesn't require installation of the [Client Software Distribution 2.0 application](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/csd-app-2.md).\n\n## Spoke triggers\n\nUse triggers in the Jamf spoke to subscribe to the required events. The endpoint enables webhooks to connect with your ServiceNow instance. You can configure the flows to execute only when the specified trigger conditions are met. The supported events are:\n\n|Category|Trigger|Description|\n|--------|-------|-----------|\n|Computer Management|Computer Inventory Completed|Trigger initiates when a managed computer submits inventory.|\n|Group Management|Smart Group Computer Membership Change|Trigger initiates when a managed computer joins or leaves the membership of a smart computer group.|\n|Mobile Device Management|Mobile Device Inventory Completed|Trigger initiates when a device completes the Update Inventory MDM command.|\n\nFor information about setting up the triggers for the Jamf spoke, see [Set up triggers for the Jamf spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/jamf-setup-triggers.md). For more information about inbound integration, see [Conditional and event-driven inbound integration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/conditional-and-event-driven-inbound-integration.md).\n\n## Connection and credential alias requirements\n\nIntegration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.\n\nFor information about setting up the spoke, see [Set up the Jamf spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-jamf-spk.md).\n\n"}}