Web services authentifiés (ws)
De Wiki1000
L'exécution d'une requête Web service nécessite une session pour fournir le contexte d'exécution, par défaut le serveur crée une session anonyme attachée au contexte de l'utilisateur du serveur.
L'exécution des requêtes Web Services sans authentification est possible cependant l'authentification est nécessaire dans le cadre du multi-société.
Différentes solutions sont possibles pour authentifier un Web Service, dans tous les cas il faut fournir au serveur un identifiant de session correspondant à un contexte utilisateur.
Déclarer qu'un service requiert une authentification
- Pour un paquet de service local
- Les requêtes publiées comme service requièrent toutes une authentification
Obtenir un identifiant de session
Plusieurs solutions sont possibles pour obtenir un identifiant de session :
- Appel de l'écran de connexion du serveur
- (Pour un service interactif)
- La navigation vers l'url suivante permet à l'utilisateur de saisir ses informations d'authentification dans une fenetre (+ positionnement contexte société le cas échéant).
http://hostname/servicename/server/connect.l1000?cburl=about:blank&SID=NO_SID
- cburl représente une url vers la quelle le serveur vous redirige à l'issue d'une authentification réeussie.
- Lors de cette redirection, le serveur positionne l'identifiant de session comme paramètre de l'url.
- Avec l'appel précédent, l'url vers laquelle on est redirigé est "about:blank?SID=XXXXXX-123456789"
- Il est possible également de récupérer en retour l'identifiant de session positionné par le serveur dans un cookie de la réponse.
- Appel du service REST de gestion des sessions
- (Pour un service non interactif)
- Invoquer la méthode du service web d'authentification
- (Pour un service non interactif)
- Ce service est accessible à l'adresse suivante :
http://hostname/servicename/server/soap.l1000?wsdl=Sage1000Authentication
Passer un identifiant de session
Plusieurs solutions sont possibles pour passer un identifiant de session :
- En affectant sessionId dans l'en tête soap du message
- Cette approche est aisée avec les outils qui consomment les services web
- Par un cookie http positionné dans l’en tête http du message
- Cette approche peut être délicate à implémenter
- Par un paramètre passé dans chaque appel de service métier.
- Cette approche nécessite que le code métier change le contexte de session avant d’exécuter le service.
