Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure Service Graph Connector for Jamf using SGC Central

Use the playbook available with the SGC Central application to set up the Service Graph Connector for Jamf for pulling in Jamf data into the CMDB.

Before you begin

Install Service Graph Connector for Jamf version 2.13.0 or later from the ServiceNow Store. For ServiceNow Store installation steps, see Install a ServiceNow Store application.

When using client credentials for authentication, obtain the OAuth credentials from your Jamf administrator. Make a note of the following details:

  • Application (client) ID
  • Client Secret

If using Client Credentials authentication in Jamf Pro, you need to use the API Roles and Clients functionality. For more details, refer to the API Roles and Clients section in the Jamf documentation. When creating a new API client in the Jamf environment, the Access token lifetime field on the form for creating a client enables setting how long the token remains valid. The default is 60 seconds, but due to ServiceNow AI Platform limitations, the value must be set to more than 60 seconds. Setting the token lifetime to 3600 seconds (1 hour) helps prevent potential issues.

Role required: admin

About this task

The playbook experience for onboarding connectors is activated with SGC Central in the Service Graph Workspace or CMDB Workspace. To configure the SGC Central application, see Configuring SGC Central and for more information on how to interact with a playbook, see Interact with Playbook.

Procedure

  1. Use one of the following methods to open SGC Central:

    • Navigate to Workspaces > Service Graph Workspace, and from the left navigation panel, select the Ingestion icon
Image omitted: icon-sgc-central.png
No alternative text supplied

to open the SGC Central view. - Navigate to Workspaces > CMDB Workspace > SGC Central. 2. On the Overview page, select Create connection.

**Tip:** Alternatively, you can select **Create connection** on the All connections page.
  1. On the Create connection window, select the Jamf connector type and then select Create connection.

  2. Complete the initial prerequisites when setting up a connection for the first time using a connector.

    Note: This step is required only during the first-time setup. See Perform initial setup tasks when creating a connection in SGC Central.

  3. Determine the type of authentication for the Jamf connection.

    1. In the Setup stage of the playbook, select the Select alias template activity.

      If needed, expand the Setup stage to select an activity.

    2. Select an alias template for the connection.

      • SG-Jamf OAuth Connection: Select when using OAuth or client credentials for authentication.
      • SG-Jamf Basic Connection: Select when using Basic authentication or Bearer token.
        1. Select Continue.
  4. Enter connection details and test the API connection for importing data.

    1. In the Setup stage of the playbook, select the Configure and test connection activity.

    2. On the form, fill in the fields.

      • When the SG-Jamf OAuth Connection template is selected, fill in the details as shown in the following table.
FieldDescription
Connection NameName to identify the Jamf connection record.
Connection URLBase URL to connect to the Jamf API.Note: This field is automatically set to the URL to connect to the application. Leave the field value as is.
OAuth Client IDApplication (client) ID of your Jamf client application as noted in the Before you begin section.Note: Verify that the Jamf client has read privileges for the Computers and Mobile Devices categories in Jamf.
OAuth Client SecretClient Secret of your Jamf client application as noted in the Before you begin section.
Use MID ServerOption to use a MID Server.Note: Use of a MID Server is optional.
Mid SelectionName of the MID Server used by the connector.This field appears only when the Use MID Server check box is selected.
    -   When the **SG-Jamf Basic Connection** template is selected, fill in the details as shown in the following table.
FieldDescription
Connection NameName to identify the Jamf connection record.
Connection HostTarget host value used by the connection.Note: Update the Host field with your Jamf base URL or IP address. For example, demojamfhost.com or 127.0.0.1.
User NameUser name that is used to authenticate the HTTP or HTTPS request when this Basic authentication profile is enabled.Note: Verify that the Jamf user has read privileges for the Computers and Mobile Devices categories in Jamf.
PasswordPassword that is used to authenticate the HTTP or HTTPS request when this Basic authentication profile is enabled.
Use MID ServerOption to use a MID Server.Note: Use of a MID Server is optional.
Mid SelectionName of the MID Server used by the connector.This field appears only when the Use MID Server check box is selected.
3.  Select **Create and test connection**.

4.  Once the connection test is complete, select **Continue**.
  1. Set configuration properties for the connection to access Jamf resources.

    Note: To skip this step, select Continue for the Set configuration properties activity. If you skip this step, the default values of the properties are considered.

    1. In the Setup stage of the playbook, select the Set configuration properties activity.

    2. Set the fields for configuration properties as described in the following table.

FieldDescription
Import managed application records onlyOption to limit the import to managed application records only.Note: If the Import managed application records only check box is cleared, the default behavior is to import all application records.
Use JAMF Pro APIOption to enable the use of the Jamf Pro API for querying computer records. Note: When the Use JAMF Pro API check box is selected, the connector uses the Jamf Pro API, which offers pagination of response data and improved performance over the Jamf Classic API.
3.  Select **Continue**.
  1. Configure the import schedule to import data at regular intervals.

    1. In the Setup stage of the playbook, select the Configure import schedule activity.

    2. Select Configure import schedule.

    3. Select the Active check box, and then fill in the run schedule and time details.

      For more information, see Schedule a data import.

    4. Select Save.

    5. Repeat steps from 8.b to 8.d for each job displayed on the page.

    6. Select Continue.

  2. In the Setup stage of the playbook, select the Confirm connection creation activity to verify whether the connection was created.

What to do next

Select View all connections to review the connection details. The configured connection appears in the Installed connections list.

Related topics

Service Graph Connector for Jamf

CMDB classes targeted in Service Graph Connector for Jamf

Accessing the connection details of Service Graph Connector for Jamf