Vous pouvez configurer des applications externes pour utiliser la fonctionnalité principale de Workspace ONE UEM en intégrant les API REST à l'infrastructure UEM et en facilitant la connectivité. Vous pouvez également sélectionner une URL de jeton OAuth la plus proche de votre centre de données pour authentifier les appels d'API.

Prise en main des API REST

À l'aide de l'architecture logicielle REST simplifiée, les API REST de Workspace ONE UEM prennent actuellement en charge plusieurs fonctionnalités, notamment le groupe organisationnel, l'administration de la console, l'application mobile, le terminal mobile, la messagerie, l'utilisateur de l'inscription, le profil, le Smart Group et la gestion de groupe d'utilisateurs.

L'utilisation d'API basées sur REST offre plusieurs avantages aux entreprises, notamment la suppression des coûts et du temps passé à développer des applications en interne. Les API REST de Workspace ONE UEM sont entièrement capables et prêtes à être intégrées aux serveurs, aux programmes et aux processus d'entreprise. En outre, les API REST de Workspace ONE UEM sont plus efficaces, peuvent s'exécuter sans problème et être facilement personnalisées pour les entreprises. Ces API sont destinées aux développeurs d'applications, et ce guide fournit des connaissances sur la conception et l'architecture de la bibliothèque d'API pour faciliter le développement et l'intégration personnalisés avec Workspace ONE UEM.

Accéder à la documentation de l'API

Accédez à la documentation détaillée de l'API en accédant à la page d'aide de l'API de Workspace ONE UEM.

Pour ce faire, dans les environnements SaaS, remplacez le « cn » dans votre URL par « as », puis ajoutez /api/help après .com.

Par exemple, la documentation de l'API pour l'URL d'un environnement SaaS
https://cn4855.awmdm.com
est
https://as4855.awmdm.com/api/help

URL du centre de données et du jeton pour la prise en charge d'OAuth 2.0

Workspace ONE UEM prend en charge le protocole OAuth 2.0 standard dans l'industrie pour l'authentification et l'autorisation sécurisées pour les appels API REST.

Les URL de jeton sont spécifiques à la région.

Tableau 1. URL de jeton spécifiques à la région
Région Emplacement du centre de données SaaS de Workspace ONE UEM URL de jeton
Ohio (États-Unis) Tout l'environnement UAT https://uat.uemauth.vmwservices.com/connect/token
Virginie (États-Unis) États unis https://na.uemauth.vmwservices.com/connect/token
Virginie (États-Unis) Canada https://na.uemauth.vmwservices.com/connect/token
Francfort (Allemagne) Royaume-Uni https://emea.uemauth.vmwservices.com/connect/token
Francfort (Allemagne) Allemagne https://emea.uemauth.vmwservices.com/connect/token
Tokyo (Japon) Inde https://apac.uemauth.vmwservices.com/connect/token
Tokyo (Japon) Japon https://apac.uemauth.vmwservices.com/connect/token
Tokyo (Japon) Singapour https://apac.uemauth.vmwservices.com/connect/token
Tokyo (Japon) Australie https://apac.uemauth.vmwservices.com/connect/token
Tokyo (Japon) Hong Kong https://apac.uemauth.vmwservices.com/connect/token

Créer un client OAuth à utiliser pour les commandes API

Vous pouvez créer un client OAuth à utiliser pour les commandes API dans Workspace ONE UEM Console version 2001 ou ultérieure. Créez un client OAuth en procédant comme suit.

  1. Accédez à Groupes et paramètres > Configurations.
  2. Saisissez OAuth dans la zone de texte de recherche nommée « Saisissez un nom ou une catégorie ».
  3. Sélectionnez Gestion des clients OAuth qui apparaît dans les résultats. L'écran Gestion des clients OAuth s'affiche.
  4. Cliquez sur le bouton Ajouter ;
  5. Saisissez le Nom, la Description, le Groupe organisationnel et le Rôle.
  6. Assurez-vous que l'État est défini sur Activé.
  7. Cliquez sur Enregistrer.
  8. IMPORTANT : copiez l'ID client et la Clé secrète du client dans le presse-papiers et enregistrez-les avant de fermer cet écran. Cliquez sur l'icône du presse-papiers () pour envoyer la Clé secrète du client vers le presse-papiers.

    Vous ne pouvez pas revenir ici pour récupérer ces informations après avoir sélectionné Fermer.