Hypergrid Protocol
From OpenSimulator
(Difference between revisions)
(→Introduction) |
(→As destination of teleport) |
||
| Line 26: | Line 26: | ||
=== As destination of teleport === | === As destination of teleport === | ||
* Verify's user agent with source installation's User Agent service. | * Verify's user agent with source installation's User Agent service. | ||
| + | * Relays inventory requests to home grid inventory service. | ||
| + | * On rezzing objects, inspects referenced assets and requests from home grid asset service. | ||
| + | ** If assets can be imported, then copies to local asset service. | ||
== Viewer == | == Viewer == | ||
Revision as of 11:30, 3 November 2014
Contents |
Introduction
This page begins to describe the protocol level details for Hypergrid. It will apply only to Hypergrid 2.0 and later.
Components
Grid Services
Gatekeeper service
- Provides information to callers about Hypergrid accessible regions on the grid.
- Controls and manages user agent access to the grid - similar to the login service for non-Hypergrid users.
- Authenticates an incoming connection with the source grid's User Agent VerifyAgent call.
User Agent service
- Provides a VerifyAgent call so that the Gatekeeper service can authenticate that an incoming user agent originates from its given source grid.
Simulator
As source of teleport
- Initiates teleport process once requested by a viewer.
- Makes contact with destination grid's gatekeeper service.
- On approval, signals client to begin teleport and starts hand off to source region.
- Part of this is sending attachments information over to the foreign region.
As destination of teleport
- Verify's user agent with source installation's User Agent service.
- Relays inventory requests to home grid inventory service.
- On rezzing objects, inspects referenced assets and requests from home grid asset service.
- If assets can be imported, then copies to local asset service.
Viewer
- Speaks to the current and target simulators using LLUDP and capabilities.
- No interation with grid services to complete teleport.
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 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 notifies destination region that a connection is incoming.
- 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.
- Receives incoming attachments for foreign agent.
