Difference between revisions of "Current login protocols"

From Second Life Wiki
Jump to navigation Jump to search
m (tidying up format)
Line 24: Line 24:
The following explains the standard key value pairs, with an explanation of "options" at the end:
The following explains the standard key value pairs, with an explanation of "options" at the end:


''"first": <first>'' -- first name of the avatar.
:• '''"first": <first>'''
:• "last": <last> -- last name of the avatar.
::first name of the avatar.
:• "passwd": '$1$' + <passwd_md5> -- the avatar password encrypted using MD5 encryption.
:• '''"last": <last>'''
:• "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 "uri:<existing region name>&<x>&<y>&<z>".
::last name of the avatar.
:• "channel": <channel name> -- the name of the client. Used to differentiate official viewers from third party clients.
:• '''"passwd": '$1$'''' + '''<passwd_md5>'''
:• "version": <version string> -- version number of the client.
::the avatar password encrypted using MD5 encryption.
:• "platform": ["Lin" | "Mac" | "Win"] -- the platform of the client.  
:• '''"start": ["first" | "last" | <specific location> ]'''
:• "mac": <MAC Address> -- the MAC address associated with the client's computer.
::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 "uri:<existing region name>&<x>&<y>&<z>".
:• "options": <optional_login> -- optional array of character strings. ([[Current_login_protocols#Optional Parameters|See below]])
:• '''"channel": <channel name>''' 
:• "id0": "00000000-0000-0000-0000-000000000000" -- hardware hash (based on the serial number of the first hard drive in Windows) used for uniquely identifying computers.
::the name of the client. Used to differentiate official viewers from third party clients.
:• "agree_to_tos": ["true" | "false" | ""] -- whether or not the user has agreed to the Terms of Service.
:• '''"version": <version string>'''
:• "read_critical": ["true" | "false" | ""] -- whether or not the user has read important messages such as Terms of Service updates.
::version number of the client.
:• "viewer_digest": "00000000-0000-0000-0000-000000000000" -- MD5 hash of the viewer executable, only relevant when the channel is set to an official Second Life viewer.
:• '''"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. ([[Current_login_protocols#Optional Parameters|See below]])
:•''' "id0": "00000000-0000-0000-0000-000000000000"'''
::hardware hash (based on the serial number of the first hard drive in Windows) used for uniquely identifying computers.
:• '''"agree_to_tos": ["true" | "false" | ""]'''
::whether or not the user has agreed to the Terms of Service.
:• '''"read_critical": ["true" | "false" | ""]'''
::whether or not the user has read important messages such as Terms of Service updates.
:• '''"viewer_digest": "00000000-0000-0000-0000-000000000000"'''
::MD5 hash of the viewer executable, only relevant when the channel is set to an official Second Life viewer.


===Optional Parameters===
===Optional Parameters===

Revision as of 13:34, 23 April 2008

Rationale

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

Example code that shows how to do this is found here: Example_protocol_code.

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 superseded by a new login protocol, such as the login proposal by AWG or the strawman proposal from Linden Lab.

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.

Input parameters

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 "uri:<existing region name>&<x>&<y>&<z>".
"channel": <channel name>
the name of the client. Used to differentiate official viewers from third party clients.
"version": <version string>
version number of the client.
"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)
"id0": "00000000-0000-0000-0000-000000000000"
hardware hash (based on the serial number of the first hard drive in Windows) used for uniquely identifying computers.
"agree_to_tos": ["true" | "false" | ""]
whether or not the user has agreed to the Terms of Service.
"read_critical": ["true" | "false" | ""]
whether or not the user has read important messages such as Terms of Service updates.
"viewer_digest": "00000000-0000-0000-0000-000000000000"
MD5 hash of the viewer executable, only relevant when the channel is set to an official Second Life viewer.

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" -- "starter kit" inventory (?)
• "inventory-lib-root" -- unknown
• "inventory-lib-owner" -- unknown
• "inventory-skel-lib" -- LL supplied library of inventory items
• "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

Return Value

The valid (non-error) value returned by the login call is in standard xmlrpc name, value format. The most important of these is the "Login Seed-Capability" discussed below (not to be confused with the new "seed capability" for the new login procedure):

Note: Values associated with the optional string parameters are preceded by a "*" and placed at the end of the list.
Note: A complete dump of return values was moved to another page for clarity.


• last_name: lastname
• sim_ip: 64.129.40.58
• inventory-lib-owner: [{'agent_id': 'ba2a564a-f0f1-4b82-9c61-b7520bfcd09f'}]
• start_location: last
• seconds_since_epoch: 1195447316
• message: -=- http://blog.secondlife.com -=- Visit the Official Linden Blog for the latest world status updates!
• first_name: first_name
• circuit_code: 245160577
• sim_port: 13005
• secure_session_id: fdb501ca-22f1-4470-b515-2650f54b8117
• look_at: [r-0.85717299999999996274,r0.51502899999999995906,r0]
• agent_id: d5f403c7-7981-425d-a0b5-c65a3d0a4693
• inventory_host: inv12-mysql
• region_y: 244992
• region_x: 247808
• seed_capability: https://sim2054.agni.lindenlab.com:12043/cap/d373fdc9-d275-e484-3ad2-4a9b231f4e34
• agent_access: M
• session_id: 65a7213a-723a-4fcf-baca-7b247c4b43c5
• login: true
• *inventory-root: [{'folder_id': '547448bd-4b66-4bc9-bb87-2dc5c7a1fa8b'}]
• *inventory-skeleton: Array of parent folder UUID, version number, name, folder type and folder UUID
• *inventory-lib-root: [{'folder_id': '1c7a7fd0-104e-a8b1-51c6-32ea9b08e38b'}]
• *inventory-lib-owner: [{'agent_id': 'ba2a564a-f0f1-4b82-9c61-b7520bfcd09f'}]
• *inventory-skel-lib: Array of parent UUID, version number, name, type and folder ID
• *gestures: Array of asset UUID, item UUID
• *event_categories: Array of: category ID number and category name
• *event_notifications: []
• *classified_categories: Array of category ID number, category name
• *buddy-list: Array of buddy UUID, and numerical values for: buddy rights given, buddy rights has
• *ui-config: [{'allow_first_life': 'Y'}]
• *login-flags: [{'daylight_savings': 'N', 'stipend_since_login': 'N', 'gendered': 'Y', 'ever_logged_in': 'Y'}]
• *global-textures: [{'sun_texture_id': 'cce0f112-878f-4586-a2e2-a8f104bba271', 'cloud_texture_id': 'fc4b9f0b-d008-45c6-96a4-01dd947ac621', 'moon_texture_id': 'd07f6eed-b96a-47cd-b51d-400ad4a1c428'}]

Login Seed-Capability

The current Login Seed-Capability is a Capability associated with the login sim. It should not be confused with the Seed-Capability proposed for the new protocols.

See Current Sim Capabilities for more info.

External Links

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