Activation de l'accès API pour Omnissa Identity Service

Vous pouvez activer l'accès API pour Omnissa Identity Service après avoir configuré l'intégration initiale avec votre fournisseur d'identité depuis la console Omnissa Connect. Utilisez les API pour gérer de manière programmatique les utilisateurs et les groupes, la fédération des identités ainsi que les opérations d'administration.

Pour activer l'accès API, vous devez créer un client OAuth 2.0 pour Omnissa Identity Service dans Omnissa Connect.

Dans un premier temps, pour obtenir un jeton administrateur permettant un accès initial, créez un client OAuth 2.0 temporaire depuis la page Omnissa Identity Service dans la console Omnissa Connect. Utilisez ensuite les informations d'identification du client pour appeler les REST API afin de créer un autre client OAuth 2.0 avec des privilèges limités, que vous continuerez à utiliser avec les API Omnissa Identity Service. Après avoir créé le deuxième client, supprimez le client temporaire.

Conditions préalables

• Vous disposez des rôles suivants :
  • Rôles Administrateur d'organisation et Propriétaire d'organisation dans Omnissa Connect (pour le service cloud Omnissa Identity Service uniquement)
  • Rôle de super administrateur dans le service Omnissa Access
  • Rôles d'administrateur dans les services que vous intégrez à Omnissa Identity Service. Pour Workspace ONE UEM, le rôle Administrateur de la console ou un rôle personnalisé équivalent est requis.
• Depuis la page Gestion des identités > Gestion des utilisateurs finaux de la console Omnissa Connect, vous avez activé Omnissa Identity Service, configuré l'intégration à votre fournisseur d'identité tiers et sélectionné les produits et services Omnissa à utiliser avec ce fournisseur d'identité.

Procédure

1. Créez un client OAuth 2.0 temporaire dans la console Omnissa Connect.

   1. Accédez à Omnissa Identity Service.

      • Cloud : connectez-vous à la console Omnissa Connect, sélectionnez Gestion des identités > Gestion des utilisateurs finaux dans le volet de gauche, puis cliquez sur Lancer la gestion des utilisateurs finaux.
      • Sur site : connectez-vous à la console Omnissa Access, sélectionnez Intégrations > Identity Service, puis cliquez sur Configurer le provisionnement SCIM.

      Omnissa Identity Service s'ouvre dans un nouvel onglet du navigateur.

   2. Cliquez sur le bouton Informations d'identification de l'API.

   3. Sur la page Informations d'identification de l'API, cliquez sur Ajouter un client.

      Un client OAuth 2.0 nommé api-bootstrap-client est généré.

   4. Recherchez les valeurs ID client et Secret partagé.

      Important : assurez-vous de copier le secret avant de quitter la page ; sinon, vous devrez le régénérer. Pour régénérer le secret, cliquez sur le bouton Régénérer. Veuillez noter que lorsque vous régénérez le secret, l'ancien secret n'est immédiatement plus valide.

      

2. Obtenez un jeton d'accès à l'aide des valeurs ID client et Secret partagé du client temporaire.

   Reportez-vous à Étape 2 : Obtenir un jeton d'accès pour le client OAuth 2.0 dans la section Prise en main des REST API d'Omnissa Identity Service de la Omnissa Identity Service API Reference.

3. Utilisez les instances de REST API pour créer un autre client OAuth 2.0, avec l'ensemble de règles IDP_AND_DIRECTORY_ADMIN.

   Reportez-vous à Étape 3 : Créer un client OAuth 2.0 avec le fournisseur d'identité et le jeu de règles administrateur de l'annuaire dans la section Prise en main des REST API d'Omnissa Identity Service de la Omnissa Identity Service API Reference.

4. Dans la console Omnissa Connect, supprimez le client OAuth 2.0 temporaire nommé api-bootstrap-client.

   1. Accédez à Omnissa Identity Service.

      • Cloud : connectez-vous à la console Omnissa Connect, sélectionnez Gestion des identités > Gestion des utilisateurs finaux dans le volet de gauche, puis cliquez sur Lancer la gestion des utilisateurs finaux.
      • Sur site : connectez-vous à la console Omnissa Access, sélectionnez Intégrations > Identity Service, puis cliquez sur Configurer le provisionnement SCIM.

      Omnissa Identity Service s'ouvre dans un nouvel onglet du navigateur.

   2. Cliquez sur le bouton Informations d'identification de l'API.

   3. Sur la page Informations d'identification de l'API, cliquez sur Supprimer pour supprimer le client api-bootstrap-client.

Étape suivante

Utilisez les REST API d'Omnissa Identity Service pour gérer les utilisateurs et les groupes, la fédération des identités ainsi que les opérations d'administration. Pour appeler les API, obtenez un jeton d'accès à partir du deuxième client OAuth 2.0 que vous avez créé.

Pour en savoir plus sur l'utilisation des REST API d'Omnissa Identity Service, reportez-vous à la section Référence API.