Privilèges requis pour l'utilisation des fonctions API

Les utilisateurs Watson Explorer Engine avec lesquels vous vous authentifiez sont généralement créés dans l'outil d'administration Watson Explorer Engine, tel qu'expliqué dans la section Management du Manuel de l'utilisateur Watson Explorer Engine. En plus de pouvoir s'authentifier en tant qu'utilisateur Watson Explorer Engine valide, les applications API doivent s'authentifier en tant qu'utilisateur disposant de privilèges suffisants pour exécuter les fonctions de l'API Watson Explorer Engine et accéder aux ressources Watson Explorer Engine sous-jacentes dont elles ont besoin. Figure 1 montre les informations utilisateur dans l'outil d'administration Watson Explorer Engine pour un exemple d'utilisateur possédant des privilèges suffisants pour exécuter toutes les fonctions de l'API Watson Explorer Engine.

Figure 1. Informations utilisateur dans l'outil d'administration Watson Explorer Engine

Remarque : Les utilisateurs de l'outil d'administration Watson Explorer Engine lui-même auront généralement des privilèges supplémentaires au-delà de ceux requis par les applications orientées API. Consultez la section Management du Manuel de l'utilisateur Watson Explorer Engine pour plus d'informations sur les types différents d'utilisateurs Watson Explorer Engine et les privilèges dont ils ont besoin.

Tel qu'indiqué dans la Figure 1, l'outil d'administration Watson Explorer Engine affiche les versions conviviales des droits sous-jacents qui doivent exécuter les fonctions d'API Watson Explorer Engine. Les droits requis pour exécuter des fonctions API sont les suivants :

Admin Tool User - nommé en interne admin-user, il s'agit du privilège de base requis pour utiliser l'outil d'administration Watson Explorer Engine et l'API Watson Explorer Engine.
Modify Search Collections - nommé en interne vse-modify, ce privilège permet aux utilisateurs de créer et de modifier des collections de recherche.

La tentative d'exécuter une application SOAP écrite en Java qui utilise l'API Watson Explorer Engine et s'authentifie en tant qu'utilisateur sans privilèges suffisants pour utiliser l'API poussera votre application à générer une erreur SOAP générale telle que la suivante :

WARNING: javax.xml.ws.soap.SOAPFault
  Exception: The exception [rights-execute] was
  thrown.

Pour résoudre ce problème, utilisez l'outil d'administration Watson Explorer Engine pour ajouter les droits manquants à l'utilisateur Watson Explorer Engine que votre application utilise pour l'authentification.