Set up authentication credentials and scheduled jobs to import Jamf data into your CMDB.

1. Navigate to Service Graph Connector for Jamf > Setup. Then on the Get Started page, select Get started.
   Continue to follow the steps in the guided setup to complete the configuration, or follow the steps below for more details about each configuration step.
2. On the Service Graph Connector for Jamf page, in the Configure the connection section, select the task Configure Jamf authentication credentials. On the next page, in the Configure Jamf authentication credentials task section, click Configure, and complete the following steps:
   1. Fill in the fields on the Basic Auth Credentials form.

      Field	Description
      Name	Descriptive name of this authentication configuration
      User name	The user name used to authenticate the HTTP request when this Basic authentication profile is enabled. Note: The Jamf user must have a role with read privileges for Computers so that the integration can pull computer data.
      Password	The password used to authenticate the HTTP request when this Basic authentication profile is enabled.

   2. Click Update if necessary, then click Mark as Complete in the Configure Jamf authentication credentials task section.
3. In the Configure Jamf HTTP Connection task section, click Configure and complete the following steps:
   1. Review the HTTP(s) Connection form and fill in fields as needed:

      Table 1. Fields requiring input on the HTTP(s) Connection form

      Field	Description
      Name	Name of the Connection
      Use MID server	Flag denoting if this Connection use MID server or not
      Host	Target host value used by the Connection. The Connection URL will automatically fill in the <hostname>

      Table 2. Pre-populated fields on the HTTP(s) Connection form

      Field	Description
      Credential	Credential value used by this Connection
      Connection alias	Connection value with which the Connection can be referred
      URL builder	Use URL builder to build the connection URL
      Connection URL	Manually enter your connection URL or use the URL builder to build the connection string
      Mutual authentication	Checked if this is Mutual Authentication
      Protocol	Underlying protocol used by the Connection
      Active	Flag denoting if this Connection record is active or not
      Domain	Domain to which the Connection belongs
      Override default port	Target value port used by the Connection
      Base path	Base path for HTTPS connection

   2. Click Update if necessary, and then click Mark as Complete in the Configure Jamf HTTP Connection task section.
4. In the Test the connection task section, click Configure and complete the following steps:
   1. Review the fields on the Data Source form, which is automatically set.

      Field	Description
      Name	Unique name of this data source
      Import set table label	Specify the import set table that this data source will produce
      Import set table name	Name of the table that will be created for this data source
      Type	Data storage type of the data to be imported
      Data in single column	Data in single column
      Application	Application containing this record
      Data Loader	Script that loads data in import set table

   2. Click the Test Load 20 Records related link to test the connection. Testing the connection takes a few moments, after which the page refreshes to show the test results. When finished, select Mark as Complete.
      The connection is successful if the HTTP Status is 200. If there is an Error Code and Error Message, the connection failed and further troubleshooting is required.
      Note: Do not click Load All Records during this setup.
   3. In the Help side bar, click Back to Guided Setup and then under the Test the connection task section, select Mark as Complete.
5. On the left side bar, click the Duplicate detection rules icon.
6. On the Service Graph Connector for Jamf page, in the Duplicate detection rules section, select the task Configure duplicate detection rules. And then, in the Configure duplicate detection rules section, click Configure.
7. On the CMDB Duplicate Row Rules form, update the Active column value to true to activate the duplicate detection rule. When finished, in the Help side bar, select Mark as Complete.
8. On the left side bar, click Set up scheduled import jobs icon.
9. On the Service Graph Connector for Jamf page, in the Set up scheduled import jobs section, select the task Configure the scheduled job.
10. In the Configure the scheduled job task section, click Configure and complete the following steps to activate the scheduled job:
    1. Select the name of the scheduled job you want to activate.
    2. Review the pre-populated fields on the Scheduled Data Import form. Modify the schedule as needed, and then select Active.
       Note: By default, SG-Jamf Mobile Devices is automatically set as Active and runs SG- Jamf Computer as a parent.

       Field	Description
       Name	Name of the scheduled job
       Data Source	Data source record that defines the data to import
       Run as	Scheduled job will run with credentials of specified user (optional)
       Active	Check box to activate scheduled job
       Concurrent Import	Load the data into multiple import sets and process (transform) concurrently
       Partition Method	Choice of partition for concurrent import set
       Partition Size	Import set size for early scheduling
       Execute pre-import script	Check box to specify a script to run before the import is performed
       Pre-script	Optional processing before import Note: For SG-Jamf Remove Software, you can import information about deleted software instances or software installs onto your ServiceNow instance. To run the import from the beginning, set the code as: var resetLastRunDatetime = true;
       Execute post-import script	Check box to specify a script to run after the import is performed
       Application	Application containing this record
       Run	Frequency at which you want to run the import
       Conditional	Specify conditions under which this job is executed

    3. Click Execute Now and repeat the previous steps for the other imports if needed.
    4. When you're finished, click Mark as Complete in the Configure the scheduled job task section.

If you need to connect multiple instances for Jamf, you can create connection aliases, HTTP connections, and scheduled data imports to pull in data from multiple data servers.

1. Navigate to Connections & Credentials > Connection & Credential Aliases.
2. On the Connection & Credentials Aliases list, select Jamf_CMDB_Connection, then the Child Aliases tab and New, to create a new child alias.
3. On the Connection & Credential Aliases form, enter a name for the alias and click Submit.
4. Click the Connections tab and select New, to create a new connection.
5. On the HTTP(s) Connection form, complete the following steps:
   1. Review the HTTP(s) Connection form and fill in fields as needed.

      Table 3. Fields requiring input on the HTTP(s) Connection form

      Name	Description
      Name	Name of the Connection
      Credential	Credential used by this Connection. Note: Create a new Basic Auth credential by selecting > New > Basic Auth Credentials. When you create a new Basic Auth credential, enter a new Jamf user name and password.
      URL builder	Check box to build a URL. The connection URL will be auto generated based on the Host and Base path. Note: Update the Host field with a Jamf host name or IP address and the Base path field with /JSSResource.
      Use MID server	(Optional) For more information on how to configure a MID Server, see the Configuring a MID Server for the Service Graph Connector for Jamf [KB0853427] KB article on the HI Knowledge Base. Note: If you create more than one instance, it will only use one MID Server.

      The URL builder builds a URL in the Connection URL which is based on values in the Host and Base path fields.

      

      Table 4. Fields that are automatically set on the HTTP(s) Connection form

      Field	Description
      Active	Flag denoting if this Connection is active or not
      Domain	Domain to which the Connection belongs
      Connection alias	Connection alias value with which the Connection can be referred
      Connection URL	Use to enter connection URL for the new connection

   2. Click Submit.
6. Select the alias you created and right-click the form context menu icon , then select Copy sys_id.
   Note: You will need the system ID for an upcoming step.
7. Navigate to Service Graph Connector for Jamf > Import Schedules.
8. Select New to create a new import schedule for the new instance.
9. On the Scheduled Data Import form, complete the following steps:
   1. Fill out the Scheduled Data Import form.

      Table 5. Scheduled Data Import

      Name	Description
      Name	Name of the scheduled data import
      Data Source	Data source record that defines the data to import. By default, select SG-Jamf Computer.
      Run as	Name of a user whose credentials the import job uses. By default, select System Administrator.
      Concurrent Import	Check box to load the data into multiple import sets and processes concurrently.
      Partition Method	Choice of partition method for concurrent import set
      Partition Size	Import set size for early scheduling
      Execute pre-import script	Check box to specific script to run before the import is performed.
      Run	Frequency at which you want to run the import.
      Conditional	Specify conditions under which this job is executed

   2. Select the Concurrent Import box to set the Partition Method to Custom size and Partition Size to 15,000.
   3. Select the Execute pre-import script box, then paste the sys_id of the new Connection Alias you copied from Step 6 into the following script:

      var devConnectionAliasSysId = "your_sys_id"; 
      
      gs.getSession().putClientData("jamf_connection_alias_sys_id", devConnectionAliasSysId);

   4. In the Run field, select After Parent Runs to run the scheduled data imports sequentially then select the parent in the Parent field.

      

      Note: These scheduled imports shouldn't run simultaneously since they share the same data source.
   5. Click Submit.