Hypergrid Protocol - Revision history

Acryline at 05:53, 24 July 2021

2021-07-24T05:53:58Z

Justincc: /* Teleport of an agent into a foreign grid */

2014-12-23T20:24:52Z

‎Teleport of an agent into a foreign grid

Justincc: /* Teleport of an agent into a foreign grid */

2014-12-01T23:38:19Z

‎Teleport of an agent into a foreign grid

Justincc: /* Teleport of an agent into a foreign grid */

2014-12-01T23:36:36Z

‎Teleport of an agent into a foreign grid

Justincc: /* Teleport of an agent into a foreign grid */

2014-12-01T23:31:10Z

‎Teleport of an agent into a foreign grid

Justincc: /* Teleport of an agent into a foreign grid */

2014-12-01T23:30:55Z

‎Teleport of an agent into a foreign grid

Justincc: /* Teleport of an agent into a foreign grid */

2014-12-01T23:30:46Z

‎Teleport of an agent into a foreign grid

Justincc: /* Teleport of an agent into a foreign grid */

2014-12-01T23:30:29Z

‎Teleport of an agent into a foreign grid

Justincc: /* Teleport of an agent into a foreign grid */

2014-12-01T21:32:25Z

‎Teleport of an agent into a foreign grid

Justincc: /* Teleport of an agent into a foreign grid */

2014-11-21T21:47:15Z

‎Teleport of an agent into a foreign grid

← Older revision		Revision as of 05:53, 24 July 2021
Line 1:		Line 1:
		+	{{Quicklinks}}
		+
	=Introduction=		=Introduction=

@@ Line 48: / Line 48: @@
 ## On receipt verifies client with source grid's User Agent service that user agent originates from there.
 ## In the simulator this point is indicated in the log with a message such as ''"[SCENE]: Incoming client Joe Bloggs in region my-region via HG login"''.
-## Hence, the home grid of the incoming agent must have a UserAgent service that is reacahable by the simulator receiving the connection.
+## Hence, the home grid of the incoming agent must have a UserAgent service that is reachable by the simulator receiving the connection.
 ## If verification is successful, then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned true"''.
 ## If verification fails (often because the home grid's user agent service could not be contacted), then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned false"''.  The sending region will log the message ''"Failed to verify user presence in the grid for Joe Bloggs, access denied to region myregion."''
 # Destination region receives incoming attachments for foreign agent.
 [[Category:Hypergrid]]

@@ Line 50: / Line 50: @@
 ## Hence, the home grid of the incoming agent must have a UserAgent service that is reacahable by the simulator receiving the connection.
 ## If verification is successful, then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned true"''.
-## If verification fails (almost always because the user agent service could not be contacted), then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned false"''.  The sending region will log the message ''"Failed to verify user presence in the grid for Joe Bloggs, access denied to region myregion."''
+## If verification fails (often because the home grid's user agent service could not be contacted), then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned false"''.  The sending region will log the message ''"Failed to verify user presence in the grid for Joe Bloggs, access denied to region myregion."''
 # Destination region receives incoming attachments for foreign agent.
 [[Category:Hypergrid]]

@@ Line 50: / Line 50: @@
 ## Hence, the home grid of the incoming agent must have a UserAgent service that is reacahable by the simulator receiving the connection.
 ## If verification is successful, then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned true"''.
-## If verification fails (almost always because the user agent service could not be contacted), then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned false"''.  The user will be denied access to the region.
+## If verification fails (almost always because the user agent service could not be contacted), then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned false"''.  The sending region will log the message ''"Failed to verify user presence in the grid for Joe Bloggs, access denied to region myregion."''
 # Destination region receives incoming attachments for foreign agent.
 [[Category:Hypergrid]]

@@ Line 45: / Line 45: @@
 # Gatekeeper service authenticates with source grid's User Agent service that user agent originates from there.
 # Gatekeeper service notifies destination region that a connection is incoming.
-# Destination simulator waits for initial client seed [[capabilities]] connection.
+# Destination region waits for initial client seed [[capabilities]] connection.
 ## On receipt verifies client with source grid's User Agent service that user agent originates from there.
 ## In the simulator this point is indicated in the log with a message such as ''"[SCENE]: Incoming client Joe Bloggs in region my-region via HG login"''.
@@ Line 51: / Line 51: @@
 ## If verification is successful, then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned true"''.
 ## If verification fails (almost always because the user agent service could not be contacted), then one would see a simulator debug log message such as ''"[SCENE]: User Client Verification for Joe Bloggs in my-region returned false"''.  The user will be denied access to the region.
-# Destination simulator receives incoming attachments for foreign agent.
+# Destination region receives incoming attachments for foreign agent.
 [[Category:Hypergrid]]

@@ Line 37: / Line 37: @@
 = Protocol Flow =
 == Teleport of an agent into a foreign grid ==
-* Gatekeeper service receives a request from the source grid for information about a region with a given UUID.
+# Gatekeeper service receives a request from the source grid for information about a region with a given UUID.
-* If the gatekeeper can find the region in the grid service, the details are returned to the requester.
+# If the gatekeeper can find the region in the grid service, the details are returned to the requester.
-** The most crucial is the ExternalHostName and InternalPort (a misleading name as it is also the external port) as set up in the Regions configuration file.  This is the address (along with the simulators HTTP port) that the viewer will use to transfer to the destination region from its source region.
+## The most crucial is the ExternalHostName and InternalPort (a misleading name as it is also the external port) as set up in the Regions configuration file.  This is the address (along with the simulators HTTP port) that the viewer will use to transfer to the destination region from its source region.
-** If teleporting direct to regions is disallowed by the grid then the a gateway region may be returned instead.
+## If teleporting direct to regions is disallowed by the grid then the a gateway region may be returned instead.
-** If the region is not found then a failure response is returned.
+## If the region is not found then a failure response is returned.
-* Gatekeeper service receives login request for a given agent (e.g. Joe Bloggs @ http://grid-source.com:8002).
+# Gatekeeper service receives login request for a given agent (e.g. Joe Bloggs @ http://grid-source.com:8002).
-* Gatekeeper service authenticates with source grid's User Agent service that user agent originates from there.
+# Gatekeeper service authenticates with source grid's User Agent service that user agent originates from there.
-* Gatekeeper service notifies destination region that a connection is incoming.
+# Gatekeeper service notifies destination region that a connection is incoming.
-* Destination region waits for initial client seed [[capabilities]] connection.
+# Destination region waits for initial client seed [[capabilities]] connection.
-** On receipt verifies client with source grid's User Agent service that user agent originates from there.
+## On receipt verifies client with source grid's User Agent service that user agent originates from there.
-* Receives incoming attachments for foreign agent.
+## In the simulator this point is indicated in the log with the message "[SCENE]: Incoming client Joe Bloggs in region my-region via HG login".
 [[Category:Hypergrid]]