Current login protocols

Rationale

The current login involves sending an xmlrpc message to a Second Life login server and parsing the returned value.

The login parameters are all "structs": key, value pairs. All keys and values are simple key, value pairs, except the value associated with "options" which is an array of zero or more character strings. The order of the required structs doesn't seem to matter. Likewise, the character strings in the options array may appear in any order.

The information on this page will eventually be supplanted by new login protocols.

Conventions

On this page the following conventions are used:

"in quotes is a literal string"

[ represents a list of choices | separated by a vertical bar ]

< represents a value which can be substituted by an appropriate string described inside >

'represents a string that must be quoted, but how will be implementation specific' for example in LSL "" denotes a string and " will be used in place of the single quote (').

+ means to concatenate the two parts, though how will be implementation specific, for example + can be used to concatenate strings.

Required parameters

The following explains the standard key value pairs, with an explanation of "options" at the end:

"first": <first> -- first name of the avatar.

"last": <last> -- last name of the avatar.

"passwd": '$1$' + <passwd_md5> -- the avatar password encrypted using MD5 encryption.

"start": ["first" | "last" | <specific location> ] -- attempt to log in to this sim, though if it is full or not available, or the agent is not allowed, another sim will be selected by the grid from its list of choices. "First" means home location. If home is filled then the grid will try last. If last is filled and home is set, the grid will try home. In either case the last choice will be from a list of telehubs. For a log in to a specific location the format is <existing simulator>/<x>/<y>/<z> as in an SURL.

"major": <major revision> -- the major revision number of the client as a string. Currently always 1.

"minor": <minor revision> -- the minor revision number of the client as a string.

"patch": <patch number> -- patch number of the client as a string.

"build": <build> -- build number of the client as a string.

"platform": ["Lin" | "Mac" | "Win"] -- the platform of the client.

"mac": <MAC Address> -- the MAC address associated with the client's computer.

"options": <optional_login> -- optional array of character strings. (See below)

"user-agent": "sl.py 0.1" -- unknown.

"id0": "" -- unknown.

"agree_to_tos": ["true" | "false" | ""] -- whether or not the user has agreed to the Terms of Service.

"viewer_digest": "09d93740-8f37-c418-fbf2-2a78c7b0d1ea" -- unknown.

Optional Parameters

Zero or more of the following character strings may appear in any order in the array following the "options" keyword:

"inventory-root" -- refers to the UUID of the root inventory folder in the client's inventory window

"inventory-skeleton" -- unknown

"inventory-lib-root" -- unknown

"inventory-lib-owner" -- unknown

"inventory-skel-lib" -- unknown

"gestures" -- refers to the list of UUIDs that an avatar will perform

"event_categories" -- unknown

"event_notifications" -- unknown

"classified_categories" -- unknown

"buddy-list" -- unknown

"ui-config" -- unknown

"login-flags" -- unknown

"global-textures" unknown

External Links

[1] -- libsl login page, includes sample code.