Hypergrid Protocol

From OpenSimulator

Revision as of 11:30, 3 November 2014 by Justincc (Talk | contribs)

Jump to: navigation, search

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.
Personal tools
General
About This Wiki