Workspace ONE UEM

Le connecteur Workspace ONE UEM récupère dans OverView les appareils enrôlés dans votre tenant Omnissa Workspace ONE UEM ainsi que leurs utilisateurs d'enrôlement, via l'API REST de Workspace ONE UEM.

Objectif

Le connecteur Workspace ONE UEM récupère les informations suivantes :

• Appareils enrôlés dans le tenant (nom d'hôte, numéro de série, constructeur, modèle, IMEI, stockage, état du chiffrement et interfaces réseau)
• Système d'exploitation, applications installées et statut de conformité de chaque appareil
• Utilisateurs d'enrôlement associés aux appareils

Prérequis

• Un compte administrateur autorisé à créer des rôles sur la page Accounts > Administrators > Admin Roles, dans l'organization group que le connecteur interroge.
• L'API REST est la même sur les deux déploiements, seul l'identifiant change. Les tenants SaaS s'authentifient avec un client OAuth 2.0. Le Workspace ONE Token Service qui émet ces tokens n'existe pas on-premises, où l'API s'atteint avec une clé d'API et un compte administrateur en lecture seule.

Informations à fournir dans OverView

Renseignez le tableau correspondant à votre déploiement. Tous ses champs sont obligatoires.

Tenant SaaS

Déploiement on-premises

Procédure

Créer un rôle en lecture seule

Le rôle définit les endpoints API que l'identifiant peut appeler. Il est attribué au client OAuth en SaaS, et au compte administrateur on-premises.

1. Connectez-vous à la console Workspace ONE UEM et allez dans Accounts > Administrators > Admin Roles.
2. Cliquez sur Add Role.
3. Saisissez un Name (ex. : OverView Connector) et une Description.
4. Saisissez chaque permission listée dans Permissions requises dans le champ Search Resources, puis cochez sa case Read. Laissez toutes les autres ressources décochées.
5. Cliquez sur Save.

Créer un client OAuth, en SaaS

1. Allez dans Groups & Settings > Configurations.
2. Saisissez OAuth dans le champ de recherche Enter a name or category, puis sélectionnez OAuth Client Management.
3. Cliquez sur Add.
4. Saisissez un Name et une Description, sélectionnez l'Organization Group qui contient les appareils à importer, et sélectionnez le Role créé ci-dessus.
5. Positionnez le Status sur Enabled, puis cliquez sur Save.
6. Copiez immédiatement le Client ID et le Client Secret : ils ne sont affichés qu'une seule fois et ne peuvent plus être récupérés une fois l'écran fermé.

Créer une clé d'API et un compte administrateur, on-premises

1. Allez dans Groups & Settings > All Settings > System > Advanced > API > REST API.
2. Dans l'onglet General, cochez Enable API Access, cliquez sur Add, saisissez un nom de Service et une Description, puis copiez l'API Key générée.
3. Dans l'onglet Authentication, sélectionnez Basic.
4. Allez dans Accounts > Administrators > Admins, puis cliquez sur Add > Add Admin.
5. Dans l'onglet Basic, positionnez le User Type sur Basic et renseignez le nom d'utilisateur, le mot de passe, le prénom et le nom.
6. Dans l'onglet Roles, sélectionnez l'Organization Group qui contient les appareils à importer et le Role créé ci-dessus, puis cliquez sur Save.

Configurer le connecteur dans OverView

1. Dans OverView, allez dans Data Sources Settings > Sources.
2. Sélectionnez Workspace ONE UEM et cliquez sur Configure.
3. Renseignez l'API URL et les identifiants de votre déploiement, puis cliquez sur Save Configuration.

Permissions requises

Le rôle a besoin de deux ressources, toutes deux au niveau Read : le connecteur ne crée, ne modifie et ne supprime rien dans Workspace ONE UEM.

Elles couvrent les endpoints devices/search, devices/{id}/network, devices/{id}/apps, devices/{id}/compliance et system/users/search.

Documentation officielle

• Using UEM Functionality With a REST API
• Rest API for Workspace ONE UEM
• Role Based Access
• Workspace ONE UEM API reference