Connexion GSX

Les réglages de la connexion GSX vous permettent d’intégrer Jamf Pro à Global Service Exchange (GSX) d’Apple pour rechercher et remplir les informations d’achat suivantes pour les ordinateurs et les appareils mobiles :

  • Date d’achat

  • Date d’expiration de la garantie

Remarque :

GSX ne retourne pas toujours des informations complètes sur l’achat. Seules les informations figurant dans GSX sont retournées.

Pour intégrer Jamf Pro à GSX, vous devez d’abord créer un compte GSX et obtenir un certificat auprès d’Apple. Vous pouvez ensuite configurer les réglages de la connexion GSX dans Jamf Pro, ce qui implique de saisir les informations du compte GSX, de récupérer un jeton API auprès d’Apple et de téléverser le certificat Apple.

Vous pouvez également utiliser Jamf Pro pour tester la connexion GSX et téléverser un nouveau certificat Apple si nécessaire.

Configuration des réglages de connexion GSX

Exigences

Pour configurer les réglages de connexion GSX, vous avez besoin des éléments suivants :

  • Un compte GSX avec le rôle « gestionnaire », l’accès aux services Web et l’accès aux informations concernant la couverture et la garantie

  • Un certificat Apple (.pem or .p12)

Pour obtenir des instructions sur la création d’un compte GSX et l’obtention d’un certificat Apple, consultez l’article Intégration à Global Service Exchange (GSX) d’Apple.

  1. Dans Jamf Pro, cliquez sur Réglages dans l’angle supérieur droit de la page.
  2. Dans la section Gestion globale, cliquez sur Connexion GSX .
  3. Cliquez sur Modifier .
  4. Sélectionner Activer la connexion à GSX.
    Remarque :

    Ce réglage et certains des autres réglages de ce volet sont peut-être déjà configurés si Jamf Pro a été utilisé pour générer une CSR.

  5. Saisissez le nom d’utilisateur et le numéro du compte GSX, y compris tous les zéros qui le précèdent.
  6. Renseignez votre jeton API dans le champ Jeton API en procédant comme suit :
    1. Cliquez sur le lien « Connectez-vous à votre compte GSX Apple » sous le champ Jeton API.
    2. Connectez-vous à votre compte GSX Apple.
    3. Cliquez sur Copier dans le presse-papiers pour copier votre jeton API.
    4. Dans Jamf Pro, collez votre jeton API dans le champ Jeton API.
      Remarque :

      Le jeton API ne s’affiche pas à la fin de la configuration de la connexion GSX ou lorsque vous modifiez une connexion GSX existante. En effet, le jeton API change à chaque demande et sera donc toujours différent.

  7. Dans la section Authentification par certificat, cliquez sur Téléverser.
  8. Le champ URI sera automatiquement rempli.
  9. Suivez les instructions à l’écran pour téléverser le certificat Apple (.pem or .p12).
    Remarque :

    Le mot de passe du keystore sera identique au mot de passe d’exportation défini lors de la création du certificat.

  10. Cliquez sur Enregistrer .

Une fois la connexion GSX établie, vous pouvez rechercher et remplir les informations sur l’achat pour un seul ordinateur ou appareil en modifiant ses données d’inventaire, ou pour plusieurs ordinateurs ou appareils à l’aide d’une action de masse.

Test de la connexion GSX

  1. Dans Jamf Pro, cliquez sur Réglages dans l’angle supérieur droit de la page.
  2. Dans la section Gestion globale, cliquez sur Connexion GSX .
  3. Cliquez sur Test .
  4. Cliquez à nouveau sur Test.

Un message s’affiche, indiquant le succès ou l’échec de la connexion.

Lorsque la connexion est établie avec succès, les informations similaires aux informations suivantes s’affichent :

[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

Renouvellement du certificat Apple

Vous pouvez utiliser Jamf Pro pour téléverser un certificat Apple renouvelé, sans supprimer le certificat existant, afin de ne pas perdre la connexion avec GSX. Une notification est affichée 31 jours avant la date d’expiration du certificat Apple.

  1. Dans Jamf Pro, cliquez sur Réglages dans l’angle supérieur droit de la page.
  2. Dans la section Gestion globale, cliquez sur Connexion GSX .
  3. Cliquez sur Modifier .
  4. Cliquez sur Renouveler.
  5. Suivez les instructions à l’écran pour uploader un certificat Apple renouvelé.