GSX Connection
- Last UpdatedMay 16, 2024
- 4 minute read
The GSX Connection settings allow you to integrate Jamf Pro with Apple's Global Service Exchange (GSX) to look up and populate the following purchasing information for computers and mobile devices:
Purchase date
Warranty expiration date
GSX may not always return complete purchasing information. Only the information found in GSX is returned. Additional fields may be populated if supplemental coverage is purchased.
To integrate Jamf Pro with GSX, you must first create a GSX account and obtain a certificate from Apple. Then you can configure the GSX Connection settings in Jamf Pro, which involves entering GSX account information, retrieving an API token from Apple, and uploading the Apple certificate.
You can also use Jamf Pro to test the GSX connection and upload a renewed Apple certificate when needed.
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 (.p12)
For instructions on creating a GSX account and obtaining an Apple certificate, see the Integrating with Apple’s Global Service Exchange (GSX) article.
After the GSX connection is in place, you can look up and populate purchasing information for a single computer or device by editing its inventory information, or for multiple computers or devices by using a mass action.
- In Jamf Pro, click Settings in the sidebar.
- In the Global section, click GSX connection .
- Click Test .
- Click Test again.
A message displays, reporting the success or failure of the connection.
A successful connection will display information similar to the following:
[Accept: application/json, Content-Type: application/json, X-Apple-SoldTo: 0000000000, X-Apple-ShipTo: 0000000000] GET https://partner-connect.apple.com/gsx/api/authenticate/check HTTP/1.1 Response: OK- In Jamf Pro, click Computers or Devices in the sidebar.
- Perform a simple or advanced search.
- Click the computer or device you want to update the information for.
- Click the Purchasing tab in the sidebar and click Edit.
- In the PO Number field, enter a PO number and click Search.
The purchasing data for the computer or mobile device from GSX is populated in Jamf Pro.
You can populate GSX purchasing information for multiple computers or devices by sending a mass action command.
- Do one of the following:
- At the bottom of the list, click Action.
- Click the Send Remote Commands radio button, and then click Next.
- Click the Look up Purchasing Information from GSX radio button, and click Next.
The purchasing data for multiple computers or devices from GSX is populated in Jamf Pro.
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.
- In Jamf Pro, click Settings in the sidebar.
- In the Global section, click GSX connection .
- Click Edit .
- Click Remove to remove the expired certificate.
- Drag and drop a new Apple certificate in the Upload The GSX Certificate Or Keystore field or select a file from your library by clicking browse for a file.
- Enter the keystore password in the Enter The Keystore Password field.
- Click Save .