Avant de pouvoir interagir avec l’API Jamf Protect, vous devez créer un client API dans Jamf Protect. La création d’un client API génère des informations relatives à la configuration et au point de terminaison, telles qu’un identifiant client et un mot de passe du client API, qui peuvent être utilisées pour :
-
Obtenir un jeton d’accès
-
Inscrire votre locataire Jamf Protect dans Jamf Pro
Avant de créer un client API, tenez compte des autorisations nécessaires pour ce client. Vous pouvez créer un nouveau rôle et attribuer les autorisations minimales requises pour l’intégration de l’API ou vous pouvez attribuer le rôle Lecture seule au client. Le rôle « Lecture seule » inclura automatiquement toutes les futures autorisations en lecture seule. Les autorisations suivantes sont les autorisations minimales actuellement recommandées pour un client API.
Lecture seule : Plans
Lecture seule : API Clients (Clients API)
Lecture seule : Downloads (Téléchargements)
Ces autorisations sont susceptibles d’être modifiées et peuvent être mises à jour à tout moment. Pour plus d’informations sur l’attribution de rôles personnalisés, consultez la section Rôles utilisateur et groupes.
Vous pouvez utiliser jusqu’à cinq clients API dans Jamf Protect. Pour ajouter un client API supplémentaire, vous devez supprimer l’un des clients existants.
- Notez le mot de passe de l’API pour un usage ultérieur.Important:
Cette valeur ne sera plus affichée par Jamf Protect.
Les informations relatives à la configuration et au point de terminaison de votre client API s’affichent.
Si vous prévoyez d’intégrer un client API à Jamf Pro ou de le tester en utilisant l’application Altair GraphQL Client, assurez-vous de copier l’identifiant client dans le volet API Client Configuration (Configuration du client API) et l’URL de l’API Jamf Protect dans le volet Token and API Endpoints (Jeton et points de terminaison de l’API).