Hypergrid Protocol/fr

=Introduction=

Cette page décrit les détails du protocole de l'Hypergrid. Ce descriptif s'applique uniquement à Hypergrid 2.0 et aux versions ultérieures.

= Composants =

Service Gatekeeper

 * Fournit des informations aux appelants au sujet des régions accessibles par Hypergrid sur le réseau.
 * Contrôle et gère l'accès des utilisateurs à la grille - similaire au service de connexion pour les utilisateurs non-Hypergrid.
 * Authentifie une connexion entrante en appelant VerifyAgent pour l'utilisateur de la grille source.

Service User Agent

 * Fournit un appel VerifyAgent afin que le service Gatekeeper puisse authentifier l'utilisateur entrant comme étant originaire d'une grille source donnée.

Comme source de téléportation

 * Lance le processus de téléportation une fois demandé par un viewer.
 * Prend contact avec le service gatekeeper de la grille de destination.
 * Après approbation, il signale au client de commencer la téléportation et commence à transmettre les données à la région source.
 * Il s'agit notamment d'envoyer des informations sur les attachements à la région de destination.

Comme destination de téléportation

 * Vérifier l'agent utilisateur avec le service User Agent de l'installation source.
 * Transmet les demandes d'inventaire au service d'inventaire de la grille d'origine.
 * Lors du "rezzing" des objets, il inspecte les assets référencés et envoie des requêtes au service des assets de la grille d'origine.
 * Si les assets peuvent être importés, alors, ils sont copiés dans le service d'assets local.

Viewer

 * Parle aux simulateurs de départ et d'arrivée en utilisant LLUDP et les capacités.
 * N'a aucune interaction avec les services de la grille pour compléter la téléportation.

= Flux du protocole =

Téléportation d'un agent dans une grille étrangère

 * 1) Le service Gatekeeper reçoit une demande de la grille source pour des informations sur une région avec un UUID donné.
 * 2) Si le gatekeeper peut trouver la région dans le service de grille, les détails sont renvoyés au demandeur.
 * 3) Le plus important est le nom de l'hôte externe (ExternalHostName) et le port interne (InternalPort) (un nom trompeur car il s'agit également du port externe) définis dans le fichier de configuration des régions.  Il s'agit de l'adresse (ainsi que du port HTTP du simulateur) que le viewer utilisera pour accéder à la région de destination depuis sa région source.
 * 4) Si la grille n'autorise pas la téléportation directe vers des régions, une région passerelle peut être renvoyée à la place.
 * 5) Si la région n'est pas trouvée, un message d'échec est renvoyée.
 * 6) Le service Gatekeeper reçoit une demande de connexion pour un agent donné (par exemple, Joe Bloggs @ http://grid-source.com:8002).
 * 7) Le service Gatekeeper authentifie avec le service User Agent de la grille source que l'agent utilisateur provient de là.
 * 8) Le service Gatekeeper notifie à la région de destination qu'une connexion est entrante.
 * 9) La région de destination attend la connexion initiale des capacités d'amorçage du client.
 * 10) À la réception, le client vérifie auprès du service User Agent de la grille source que l'agent utilisateur provient de cette grille.
 * 11) Dans le simulateur, ce point est indiqué dans le journal par un message tel que "[SCENE]: Incoming client Joe Bloggs in region my-region via HG login".
 * 12) Par conséquent, la grille d'origine de l'agent entrant doit avoir un service UserAgent accessible par le simulateur qui reçoit la connexion.
 * 13) Si la vérification est réussie, un message de débogage du simulateur s'affiche comme suit "[SCENE]: User Client Verification for Joe Bloggs in my-region returned true".
 * 14) Si la vérification échoue (souvent parce que le service d'agent utilisateur de la grille d'origine n'a pas pu être contacté), un message de débogage du simulateur s'affiche, comme suit "[SCENE]: User Client Verification for Joe Bloggs in my-region returned false".  La région de destination enregistrera le message "Failed to verify user presence in the grid for Joe Bloggs, access denied to region myregion."
 * 15) La région de destination reçoit les attachemments entrants pour l'agent étranger.