RemoteAdmin:admin authenticate user

admin_authenticate_user remotely allows to authenticate an user remotely. This feature is part of the development branch, after the 0.7.6 OpenSim release.

Enabling admin_authenticate_user
If not all functions are enabled, use admin_authenticate_user to enable the function in the [RemoteAdmin] section

Required Parameters
These parameters are required

Returned Parameters
These parameters are returned by Remote Admin

Error Messages
error is set to "scene does not exist" in case no scene is available.

error is set to "avatar FIRSTNAME LASTNAME does not exist" in case the avatar with FIRSTNAME LASTNAME does not exist.

error is set to "no password provided for FIRSTNAME LASTNAME" in case the call did not include a password for the avatar named FISTNAME LASTNAME.

error is set to "no token lifetime provided for FISTNAME LASTNAME" if the token parameter has been omitted from the call.

error is set to "token lifetime longer than 30s for FISTNAME LASTNAME" in case the request asked for token_lifetime larger than 30.

error is set to "no authentication module loaded" in case no authentication module could be loaded.

error is set to "authentication failed for FIRSTNAME LASTNAME" in case the authentication failed for user FISTNAME LASTNAME.

= Examples =

Using the wasRemoteAdmin class from Wizardry and Steamworks remote admin page, a call can be made to admin_authenticate_user to authenticate the avatar Kira Komarov using Remote Admin:

which sends the request to OpenSim and returns an XML structure documented in the following section.

Return XML
admin_authenticate_user returns an XML structure indicating whether an error occurred or if the call was successful.

Success
On a successful call to admin_authenticate_user, the following is an example of the returned XML.

Failure
On an unsuccessful call to admin_authenticate_user, the following is an example of the returned XML.