Utilisation des services Web › Appel des services Web › Appel des méthodes de connexion et de déconnexion par les clients

Appel des méthodes de connexion et de déconnexion par les clients

Lorsque vous appelez des services Web avec un client Java, les clients appellent des méthodes de connexion et de déconnexion pour chaque service Web. Le processus standard est le suivant :

1. Le client utilise une méthode pour la connexion et l'authentification.

   Chaque service Web comporte un ensemble de méthodes de connexion. Les applications clientes peuvent utiliser plusieurs méthodes de connexion pour l'authentification. Par exemple, la méthode logIn utilise les mêmes paramètres que la fenêtre de connexion : ID d'utilisateur, Mot de passe et Unité business.

   Pour plus d'informations sur les paramètres des méthodes, notamment sur les signatures, consultez les sources suivantes :

   • La documentation relative à l'API des services Web
   • L'interface d'administration SOAP pour déployer ou annuler le déploiement des services Web
2. Le système de catalogues authentifie l'utilisateur et détermine son rôle.

   Les appels de méthode suivants fonctionnent dans le cadre établi par les droits d'accès de l'utilisateur, comme si l'utilisateur avait accédé à l'IUG.

3. Le client effectue les tâches suivantes :
   • Indique l'état du service appelé.
   • Indique le nom de méthode et les paramètres correspondants avant d'initialiser l'appel de procédure à distance.
   • Vérifie le fichier WSDL à la recherche de ces informations, si elles ne sont pas connues.

     Généralement, le client dispose déjà de ces informations.

4. Le service Web renvoie un ID de session. Cet ID de session est un paramètre requis que le client utilise pour les appels de service Web restants. Dans la mesure où le protocole de transport sous-jacent peut être de type HTTP ou non, l'authentification utilise un service Web de connexion courant.

   Vous pouvez partager l'ID de session sur tous les services Web. Par exemple, vous pouvez utiliser la méthode UserService logIn pour obtenir un ID de session, et l'utiliser dans un appel vers une méthode de service Web d'unité business.

5. Cette session est terminée dans l'un des cas suivants :
   • Le client appelle la méthode de service Web logOut.

     Lorsque vous n'avez plus besoin d'un ID de session, vous appelez le service Web logOut pour mettre fin à la session et annuler la validation de l'ID de session. Une telle gestion efficace des sessions vous permet d'obtenir les meilleures performances.

   • Le client est inactif sur une période supérieure à la valeur du délai d'expiration de la session.

     Le client peut utiliser l'ID de session plusieurs fois au cours de la période d'expiration. Si la session expire, l'ID devient non valide.

     Pour modifier la valeur du délai d'expiration, procédez à la mise à jour du paramètre de configuration d'administration nommé Paramètres par défaut de l'utilisateur : Délai de la session (en minutes).

     Remarque : Pour consulter les instructions relatives à la modification des paramètres de configuration, reportez-vous au Manuel d'implémentation.