Créer un compte API dans Apple Business
Présentation
L’API Apple Business permet de modifier les assignations de la gestion des appareils, d’afficher les informations sur les appareils, d’automatiser les workflows d’attribution des appareils, d’intégrer les données d’inventaire des appareils dans des plateformes tierces ou de créer des tableaux de bord personnalisés, des tâches qui, sinon, nécessiteraient une navigation manuelle sur le portail Web. L’API est compatible avec OAuth 2, qui permet aux apps de fournir un jeu d’identifiants pour s’authentifier, et de recevoir un jeton d’accès afin de transmettre des requêtes authentifiées à l’API.
Avant d’utiliser ces API, vous devez créer un compte API dans Apple Business. Seuls les profils utilisateurs ayant le rôle d’administrateur de l’organisation peuvent créer un compte API.
Remarque : Vous pouvez avoir jusqu’à 50 comptes API.
Accès aux données
Lorsque le compte API est correctement configuré, il peut autoriser une app à accéder aux informations suivantes :
Catégorie | Nom de l’autorisation | Description |
|---|---|---|
Appareils | Afficher les services de gestion des appareils, gérer l’attribution de plateforme par défaut et ajouter des appareils avec Apple Configurator. | Permet d’obtenir une liste des appareils d’une organisation donnée, enregistrés via Inscription automatisée des appareils. |
Appareils | Afficher les services de gestion des appareils, gérer l’attribution de plateforme par défaut et ajouter des appareils avec Apple Configurator. | Permet d’obtenir des informations sur un appareil appartenant à une organisation, comme le modèle, le numéro de commande ou de pièce, etc. |
Services de gestion des appareils | Afficher les services de gestion des appareils, gérer l’attribution de plateforme par défaut et ajouter des appareils avec Apple Configurator. | Permet d’obtenir une liste des services de gestion des appareils d’une organisation donnée. |
Services de gestion des appareils | Afficher les services de gestion des appareils, gérer l’attribution de plateforme par défaut et ajouter des appareils avec Apple Configurator. | Permet d’obtenir une liste des numéros de série des appareils affectés à un service de gestion des appareils. |
Services de gestion des appareils | Afficher les services de gestion des appareils, gérer l’attribution de plateforme par défaut et ajouter des appareils avec Apple Configurator. | Permet d’obtenir les informations d’identification attribuées à un appareil affecté à un service de gestion des appareils. |
Services de gestion des appareils | Afficher les services de gestion des appareils, gérer l’attribution de plateforme par défaut et ajouter des appareils avec Apple Configurator. | Permet d’obtenir les informations de service associées à un appareil affecté à un service de gestion des appareils. |
Services de gestion des appareils | Afficher les services de gestion des appareils, gérer l’attribution de plateforme par défaut et ajouter des appareils avec Apple Configurator. | Permet d’obtenir des informations sur l’activité d’un appareil appartenant à l’organisation générée par une action de gestion de l’appareil, comme une attribution ou un retrait. |
Services de gestion des appareils | Assigner des appareils aux services de gestion des appareils. | Permet d’attribuer ou de retirer des appareils à un service de gestion des appareils. |
Services de gestion des utilisateurs | Permet d’obtenir la liste des utilisateurs au sein d’une organisation. | |
Services de gestion des utilisateurs | Permet d’obtenir des informations sur un utilisateur ou une utilisatrice en particulier au sein d’une organisation. | |
Services de gestion des groupes d’utilisateurs | Permet d’obtenir la liste des groupes d’utilisateurs au sein d’une organisation. | |
Services de gestion des groupes d’utilisateurs | Permet d’obtenir des informations sur un groupe d’utilisateurs en particulier au sein d’une organisation. | |
Services de gestion des groupes d’utilisateurs | Permet d’obtenir la liste des utilisateurs attribués à un groupe d’utilisateurs au sein d’une organisation. | |
Schémas | Afficher les Schémas. | Permet d’obtenir une liste des schémas au sein d’une organisation. |
Schémas | Gérer les Schémas | Permet de créer un schéma au sein d’une organisation. |
Schémas | Gérer les Schémas | Permet d’obtenir des informations sur un schéma au sein d’une organisation. |
Schémas | Gérer les Schémas | Permet de mettre à jour un schéma au sein d’une organisation. |
Schémas | Gérer les Schémas | Permet de supprimer un schéma au sein d’une organisation. |
Schémas | Gérer les Schémas | Permet d’obtenir ou modifier les membres d’un type donné dans un schéma au sein d’une organisation. |
Configurations | Afficher les configurations d’appareils | Permet d’obtenir la liste des configurations au sein d’une organisation. |
Configurations | Afficher les configurations d’appareils | Permet d’obtenir les détails d’une configuration au sein d’une organisation. |
Configurations | Créer, modifier et supprimer des configurations d’appareils. | Permet de créer une configuration au sein d’une organisation (de type CUSTOM_SETTING). |
Configurations | Créer, modifier et supprimer des configurations d’appareils. | Permet de mettre à jour une configuration au sein d’une organisation (de type CUSTOM_SETTING). |
Configurations | Créer, modifier et supprimer des configurations d’appareils. | Permet de supprimer une configuration au sein d’une organisation. |
Paquets | Consulter et gérer les appareils qui utilisent la gestion d’appareils intégrée. | Permet d’obtenir des paquets au sein d’une organisation. |
Apps | Afficher les apps | Permet d’obtenir les apps sous licence au sein d’une organisation. |
Évènements d’audit | Accéder aux événements d’audit via l’API d’administration. | Récupérez une liste d’évènements d’audit pour une organisation, filtrés selon différents critères. Un évènement d’audit représente une activité au sein de l’organisation, par exemple l’ajout ou la suppression d’un appareil. |
Générer une clé privée
Afin de sécuriser la connexion à Apple Business, vous devez générer une clé privée. Le nom de fichier de la clé se termine par .pem, et vous ne le générez qu’une seule fois.
Créer un compte API et télécharger la clé privée
Dans Apple Business, connectez-vous avec un profil utilisateur ayant le rôle d’administrateur de l’organisation.
Dans votre Navigateur, sélectionnez Réglages > API.
Sélectionnez Ajouter un compte API, saisissez le nom du profil utilisateur et sélectionnez son rôle, puis Suivant.
Choisissez l’une des options suivantes :
Sélectionnez Générer et télécharger pour générer et télécharger la clé.
Le fichier est téléchargé automatiquement à l’emplacement défini dans les réglages de votre navigateur, ou à l’emplacement que vous indiquez en l’absence de réglage prédéfini.
Sélectionnez Plus tard pour générer la clé privée ultérieurement.
Pour consulter les informations nécessaires afin de créer la connexion, sélectionnez Modifier.
Consultez la documentation Apple Developer pour savoir comment créer la connexion.
Modifier un compte API existant migré depuis Apple Business Manager ou Apple Business Essentials
Si votre organisation a migré d’Apple Business Manager ou Apple Business Essentials vers Apple Business et si vous disposiez de comptes API, ces comptes ont désormais un rôle personnalisé. Vous pouvez consulter et modifier toutes les informations du compte API.
Dans Apple Business, connectez-vous avec un profil utilisateur ayant le rôle d’administrateur de l’organisation.
Dans votre Navigateur, sélectionnez Réglages > API.
Sélectionnez Modifier à côté d’un compte API existant.
Si nécessaire, vous pouvez effectuer l’une des actions suivantes :
Modifier le nom du compte
Changer le rôle
Le rôle personnalisé est Gestionnaire d’API d’appareil. Pour modifier les autorisations d’un rôle, consultez la section Introduction aux rôles et autorisations.
Copier l’identifiant client dans votre presse-papiers.
Copier l’identifiant de clé dans votre presse-papiers.
Révoquer la clé privée.
Sélectionnez Enregistrer.
Consultez la documentation Apple Developer pour savoir comment gérer la connexion.