Hypergrid Protocol
From OpenSimulator
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.
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.