Vous pouvez configurer des propriétés supplémentaires et créer des jetons d'API pour un utilisateur admin d'entreprise.

Dans le portail d'entreprise, accédez à Administration > Administrateurs (Administrators). Pour configurer un utilisateur Admin, cliquez sur le lien vers un nom d'utilisateur, ou sélectionnez l'utilisateur et cliquez sur Actions > Modifier l'administrateur (Modify Admin).

Les propriétés existantes de l'utilisateur admin sélectionné s'affichent et, si nécessaire, vous pouvez ajouter ou modifier les éléments suivants :

État (Status)

Par défaut, l'état est Activé (Enabled). Si vous choisissez Non activé (Not Enabled), l'utilisateur est déconnecté de toutes les sessions actives.

Type

Si vous avez choisi le mode d'authentification Natif (Native) dans la section Configurer l'authentification de l'entreprise, le type de l'utilisateur est sélectionné comme Natif (Native). Si vous avez choisi un autre mode d'authentification, vous pouvez choisir le type de l'utilisateur. Si vous choisissez l'utilisateur Non natif (Non-Native), vous ne pouvez pas réinitialiser le mot de passe ni modifier le rôle d'utilisateur.

Propriétés (Properties)

Les détails existants tels que le nom, l'ID d'e-mail, le numéro de téléphone et le numéro de téléphone mobile de l'utilisateur s'affichent. Si nécessaire, vous pouvez modifier les détails de l'utilisateur, définir un nouveau mot de passe ou réinitialiser le mot de passe existant.
  • Pour définir un nouveau mot de passe, vous devez entrer le mot de passe actuel correctement dans la zone de texte Mot de passe actuel (Current Password) et le mot de passe à modifier dans les zones Nouveau mot de passe (New Password) et Confirmer le mot de passe (Confirm Password).
  • Pour réinitialiser le mot de passe existant, cliquez sur Réinitialisation du mot de passe (Password Reset). Un e-mail contenant un lien est envoyé à l'utilisateur pour réinitialiser le mot de passe.

Rôle

Le type existant du rôle d'utilisateur s'affiche. Si nécessaire, vous pouvez choisir un autre rôle pour l'utilisateur. Les privilèges du rôle sont modifiés en conséquence.

API Tokens (Jetons d'API)

Les utilisateurs peuvent accéder aux API Orchestrator à l'aide de jetons au lieu d'une authentification basée sur une session. En tant que super utilisateur opérateur, vous pouvez gérer les jetons d'API pour les clients. Vous pouvez créer plusieurs jetons d'API pour un utilisateur.

Pour les utilisateurs en lecture seule d'entreprise et les utilisateurs experts commerciaux MSP, l'authentification par jeton n'est pas activée.

Configurer des jetons d'API

Tout utilisateur peut créer des jetons en fonction des privilèges auxquels ils ont été attribués à leurs rôles d'utilisateur, à l'exception des utilisateurs en lecture seule d'entreprise et les utilisateurs experts commerciaux MSP.

Les utilisateurs peuvent effectuer les actions suivantes, en fonction de leurs rôles :

  • Les utilisateurs d'entreprise peuvent créer, télécharger et révoquer des jetons pour eux-mêmes.
  • Les super utilisateurs opérateurs peuvent gérer des jetons d'autres utilisateurs opérateurs et des utilisateurs d'entreprise, si l'utilisateur d'entreprise a délégué des autorisations d'utilisateur à l'opérateur.
  • Les super utilisateurs d'entreprise peuvent gérer les jetons de tous les utilisateurs de cette entreprise.
  • Les utilisateurs ne peuvent télécharger que leurs propres jetons.
  • Les super utilisateurs ne peuvent créer et révoquer que les jetons pour d'autres utilisateurs.

Gérer les jetons d'API

  • Dans la section Jetons d'API (API Tokens), cliquez sur Actions > Nouveau jeton d'API (New API Token), pour créer un jeton.
  • Dans la fenêtre Nouveau jeton d'API (New API Token), entrez un Nom (Name) et une Description pour le jeton, puis choisissez Durée de vie (Lifetime) dans le menu déroulant.

  • Cliquez sur Créer (Create) et le nouveau jeton s'affiche dans la grille Jetons d'API (API Tokens).
  • Initialement, l'état du jeton affiché est En attente (Pending). Pour télécharger le jeton, sélectionnez-le, puis cliquez sur Actions > Télécharger le jeton d'API (Download API Token). L'état passe à Activé (Enabled), ce qui signifie que le jeton d'API peut être utilisé pour l'accès à l'API.
  • Pour désactiver un jeton, sélectionnez-le, puis cliquez sur Actions > Révoquer le jeton d'API (Revoke API Token). L'état du jeton affiché est Révoqué (Revoked).
  • Lorsque la durée de vie du jeton est écoulée, l'état passe à Expiré (Expired).

Seul l'utilisateur associé à un jeton peut le télécharger et ensuite, seul l'ID du jeton s'affiche. Vous ne pouvez télécharger un jeton qu'une seule fois.

Après le téléchargement du jeton, l'utilisateur peut l'envoyer comme partie intégrante de l'en-tête d'autorisation de la demande pour accéder à l'API Orchestrator.

L'exemple suivant montre un exemple d'extrait de code permettant d'accéder à une API. 

curl -k -H "Authorization: Token <Token>"
  -X POST https://vco/portal/
  -d '{ "id": 1, "jsonrpc": "2.0", "method": "enterprise/getEnterpriseUsers", "params": { "enterpriseId": 1 }}'

Après avoir modifié les paramètres et les jetons d'API, cliquez sur Enregistrer les modifications (Save Changes).