Hypergrid Protocol
From OpenSimulator
Contents |
Introduction
This page is extremely incomplete as of this time
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.
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.