Integrating with GSX
Integrating with Apple’s Global Service Exchange (GSX) allows you to look up and populate the following purchasing information for computers and mobile devices:
-
Purchase date
-
Warranty expiration date
-
Apple Care ID (warranty reference number)
Note: GSX may not always return complete purchasing information. Only the information found in GSX is returned.
To integrate with GSX, you need to configure the GSX Connection settings in Jamf Pro, which involves entering GSX account information and uploading an Apple certificate.
You can also use Jamf Pro to test the connection and upload a renewed Apple certificate when needed.
Requirements
To configure the GSX Connection settings, you need:
-
A GSX account with the “Manager” role, access to Web Services, and access to coverage/warranty information
-
An Apple certificate (.pem or .p12)
For instructions on creating a GSX account and obtaining an Apple certificate, see the Integrating with Apple’s Global Service Exchange (GSX) Knowledge Base article.
Configuring the GSX Connection Settings
-
Log in to Jamf Pro.
-
In the top-right corner of the page, click Settings
.
-
Click Global Management.
-
Click GSX Connection
.
-
Click Edit.
-
Select Enable Connection to GSX.
Note: This and some of the other settings on this pane may already be configured if Jamf Pro was used to generate a CSR. -
Enter the username and account number for the GSX account.
-
Configure the region and URI settings as needed.
-
Select Certificate-based Authentication and click Upload.
-
Follow the onscreen instructions to upload the Apple certificate (.pem or .p12).
Testing the GSX Connection
Once the GSX Connection settings are configured, you can test the connection to make sure it works .
-
Log in to Jamf Pro.
-
In the top-right corner of the page, click Settings
.
-
Click Global Management.
-
Click GSX Connection
.
-
Click Test.
-
Click Test again.
A message displays, reporting the success or failure of the connection.
Renewing the Apple Certificate
You can use Jamf Pro to upload a renewed Apple certificate without removing the existing certificate so the connection with GSX is not lost. A notification is displayed 31 days prior to the expiration date of the Apple certificate.
-
Log in to Jamf Pro.
-
In the top-right corner of the page, click Settings
.
-
Click Global Management.
-
Click GSX Connection
.
-
Click Edit.
-
Click Renew.
-
Follow the onscreen instructions to upload a renewed Apple certificate.
Related Information
For related information, see the following sections in this guide:
-
Mass Looking up and Populating Purchasing Information for Computers
Find out how to mass look up and populate purchasing information for computers from GSX. -
Mass Looking up and Populating Purchasing Information for Mobile Devices
Find out how to mass look up and populate purchasing information for mobile devices from GSX. -
Viewing and Editing Inventory Information for a Computer
You can look up and populate purchasing information for a single computer by editing the computer’s inventory information in Jamf Pro. -
Viewing and Editing Inventory Information for a Mobile Device
You can look up and populate purchasing information for a single mobile device by editing the device’s inventory information in Jamf Pro. -
Local Enrollment Using Recon
Find out how to look up and populate purchasing information when enrolling a computer by running Recon locally. -
Remote Enrollment Using Recon
Find out how to look up and populate purchasing information when enrolling a computer by running Recon remotely.