Connexion à un serveur IMu

Lorsqu’un programme basé sur IMu se connecte à un serveur IMu, un niveau d’accès par défaut aux modules EMu lui est attribué.

Un programme basé sur IM peut remplacer ce niveau d’accès en se connectant explicitement au serveur en tant qu’utilisateur enregistré d’EMu. Pour ce faire, utilisez la méthode login de IMuSession. Une fois que la méthode login a été appelée avec succès, la session reste authentifiée jusqu’à ce que la méthode logout soit appelée.

La méthode login

La méthode login permet d’authentifier le programme en tant qu’utilisateur enregistré d’EMu. Une fois authentifié avec succès, l’accès aux modules EMu s’effectue avec les droits de l’utilisateur authentifié plutôt qu’avec ceux de l’utilisateur imuserver par défaut.

Arguments

• username

  Le nom d’utilisateur avec lequel se connecter. Il doit s’agir du nom d’un utilisateur EMu enregistré sur le système.

• password

  Le mot de passe de l'utilisateur. Cet argument est facultatif ; s’il n’est pas fourni, sa valeur par défaut est null.

  Note: Il est rare de fournir un mot de passe null, mais cela peut parfois être valide. Si le serveur reçoit un mot de passe null, il tentera d’authentifier l’utilisateur à l’aide de méthodes côté serveur, telles que la vérification par rapport au fichier .rhosts d’EMu.

• spawn

  Une valeur booléenne indiquant si le serveur IMu doit créer un processus distinct dédié au traitement des requêtes de ce programme. Cet argument est facultatif ; s’il n’est pas fourni, sa valeur par défaut est true.

La méthode logout

La méthode logout met fin à l’accès accordé en tant qu’utilisateur précédemment authentifié.

Note: Cette méthode de connexion est très similaire à celle utilisée pour se connecter au même environnement EMu via le client EMu. L’accès aux enregistrements est contrôlé par une sécurité au niveau des enregistrements.

Avertissement

La connexion entraîne le démarrage par le serveur IMu d’un nouveau processus texserver pour gérer tous les accès aux modules EMu. Ce nouveau processus texserver utilisera une licence Texpress. La licence ne sera pas libérée tant que la méthode logout n’aura pas été appelée. Consultez la FAQ du serveur : Comment IMu utilise-t-il les licences Texpress ? pour plus d'informations.