Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This document explains how to enable delivery from Kitely Market in to grids that aren't open to the Hypergrid. The target audience is grid managers.

We will do the following:

  • Enable a few Hypergrid services

  • Use the firewall to allow access only from Kitely

Since the grid is non-Hypergrid, we assume that it's currently using the configuration file Robust.ini. That is the only configuration file that will be modified; there's no need to modify any of the Simulators.

...

Robust uses two main ports:

  • Port 8002 - for services that that are open to the world, mostly because Viewers need to access them. E.g.: the Login service. This port usually can't have firewall restrictions because it's accessed directly from users' computers. (It's possible to use access restrictions only if all of the users are expected to connect from within a certain network.)

  • Port 8003 - for services that are open to the grid's simulators. E.g.: Assets, Inventory. If all of the simulators are known to run within a certain network then it's possible to create firewall rules that restrict access to this port.

Your grid might be using other ports than these. In that case, simply replace every place where we mention one of these ports with the ports that you're actually using.

...

In order to enable delivery from Kitely Market, you will need to make some Hypergrid services available. But you only want to allow Kitely to access these services. This can be accomplished by running the services on a special port, and using the firewall to allow access to this port only from *.kitely.com. We suggest using the following port:

  • Port 8102 - open only to Kitely (using the firewall). The number "8102" is meant as a reminder that the services that use this port usually use port 8002.

The Helo, Home and Gatekeeper Services

...

  • [Hypergrid]

  • [GatekeeperService]

  • [UserAgentService]

  • [HGInventoryService]

  • [HGAssetService]

  • [HGInstantMessageService]

Replace every instance of "127.0.0.1" with the address of your grid, e.g. "yourgrid.com".

You may have noticed that the [GateekeeperService] section has some rules regarding who may teleport into the grid. We don't bother to set these rules since the Gatekeeper service isn't actually accessible.

4. Add the following line at the end of the [UserAgentService] section:

...

After you have configured your grid, test that it now supports Kitely Market. Login to your Kitely account; go to the Shopping Cart; click on the "Grid Manager" link; and add your grid. E.g.: enter "http://mygridyourgrid.com:8002". You will be asked to Verify your grid: this is a process where Kitely sends a Notecard to your avatar. If the Verification process succeeds then you have successfully configured your grid to support Kitely Market!

...

Next, you will want to tell your users how they can use Kitely Market. The basic instructions are these:

  1. Go to Kitely Market (

    http

    https://www.kitely.com/market )

  2. Create a Kitely account

  3. Enable the "Export" filter: it's at the bottom-left corner of the Kitely Market page. Only Exportable items can be delivered to other grids.

  4. Browse the market and add items to the Shopping Cart

  5. In the Shopping Cart, select "Deliver to: Other

    Grid

    Avatar"

  6. If this is the first time the user is using Kitely Market then they need to add your grid to their list of grids. To do so, click on the Grid Manager and Add the grid

    : http

    :

    //

    yourgrid.com:8002 (or whatever your grid's address is). If the grid was already added by this user then they can just select it in the drop-down list.

  7. Enter the receiving Avatar name, and click Pay

Your users will not be asked to Verify the grid, because that only needs to be done once and you have already done it .