La méthode open établit une connexion avec le serveur Launcher.
Si « UseLdap=Yes » dans le fichier launcher.ini, cette méthode permet aussi d’authentifier (LDAP) le client auprès du web service Launcher REST Gateway. Il doit inclure son nom d’utilisateur et mot de passe (LDAP – Active Directory) dans le corps de la requête pour s’authentifier.
Voici un exemple d’un appel à la méthode open qui permet d’établir une connexion au serveur Launcher hébergé sur localhost au port numéro 6078 (qui sont d’ailleurs les valeurs par défaut) :
POST /launcher/open HTTP/1.1
Host: localhost:9090
Content-Type: application/JSON
{ "open": { "server":"localhost",
"port":"6078", "username":"aura",
"password":"aura" } }
La requête POST ci-dessus est envoyée à l’URL https://<IP machine>:9090/launcher/open.
Si l’authentification réussit et que Launcher REST Gateway parvient à établir une connexion avec le serveur Launcher, un entier représentant l’ID du client (de la connexion Launcher) sera retourné au client. Le client doit inclure cet ID dans toutes les requêtes ultérieures.