Configuring the GSX Connection Settings

Jamf Pro Installation and Configuration Guide for Linux 11.23.0
Solution
Application
Content Type
Technical Documentation
Utilities & Services
version
11.23.0
ft:locale
en-US
vrm_version
11.23.0
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 (.p12)

For instructions on creating a GSX account and obtaining an Apple certificate, see the Integrating with Apple’s Global Service Exchange (GSX) article.

  1. In Jamf Pro, click Settings in the sidebar.
  2. In the Global section, click GSX connection .
  3. Click Edit .
  4. Use the Enable connection to GSX switch to enable the GSX connection.
    Note:

    This setting and others on this pane may already be configured if Jamf Pro was used to generate a certificate signing request (CSR).

  5. Enter the username and account number, including the leading zeros, for the GSX account.
  6. (Optional) Enter the GSX ship-to number.
  7. Provide your API token in the API Token field by doing the following:
    1. Click the “Log in to your Apple GSX account” link below the API Token field.
    2. Log in to your Apple GSX account.
    3. Click Copy to clipboard to copy your API Token.
    4. In Jamf Pro, paste your API Token into the API Token field.
      Note:

      The API token is not displayed after you finish configuring the GSX connection or when you edit an existing GSX connection. This is because the API token changes with every request and will always be different.

  8. In the Certificate-based authentication section, drag and drop a file into the Upload The GSX Certificate or Keystore section or click browse for a file.
  9. The URI field will be populated automatically.
  10. Enter the keystore password in the Enter The Keystore Password field.
    Note:

    The keystore password will be the same as the export password that was set when the certificate was created.

  11. Click Save .

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.