RemoteAdmin:admin create user
From OpenSimulator
Revision as of 09:47, 10 December 2011 by Michelle Argus (Talk | contribs)
admin_create_user remotely allows to create a new user
Contents |
Enabling admin_create_user
If not all functions are enabled, use admin_create_user to enable the function in the [RemoteAdmin] section
enabled_methods = admin_create_user,...
Parameters
Required Parameters
These parameters are required
| parameter | Description | Values |
|---|---|---|
| user_firstname | first name of user | |
| user_lastname | last name of user | |
| user_password | password of user | |
| start_region_x | start region x position in grid | |
| start_region_y | start region y position in grid |
Optional Parameters
These parameters are optional and do not need to be set
| parameter | Description | Values |
|---|---|---|
| user_email | email adress of user |
Returned Parameters
Returned Parameters
These parameters are returned by Remote Admin
| parameter | Description | Values |
|---|---|---|
| success | true when successfull | true, false |
| avatar_uuid | new avatar uuid, zero uuid when error occured |
Error messages
avatar_uuid returnes zero uuid when an error occures
Notes
- This function is only available to Robust
- This function is the same Identical to admin_create_user_email.
Example
C# .NET
This example needs the Nwc.XmlRpc library, located in your OpenSim bin folder.
public void CreateUser(Uri url, string adminPassword, string firstName, string lastName, string password, string email, int regionX, int regionY) { var address = Dns.GetHostEntry(url.DnsSafeHost).AddressList[0]; var ht = new Hashtable(); ht["password"] = adminPassword; ht["user_firstname"] = firstName; ht["user_lastname"] = lastName; ht["user_password"] = password; ht["user_email"] = email; ht["start_region_x"] = regionX; ht["start_region_y"] = regionY; var parameters = new List<Hashtable> { ht }; var rpc = new XmlRpcRequest("admin_create_user", parameters); rpc.Invoke(url.ToString()); } [Test] public void NativeUserRegistrationTest() { CreateUser(new Uri("http://yourgrid.com:9000/"), "secret", "Test2", "user2", "apassword", "email@address.com", 0, 0); }
PHP
<?php // Including the RemoteAdmin PHP class. include('RemoteAdmin.php'); // Instantiate the class with parameters identical to the Python example above $myRemoteAdmin = new RemoteAdmin('127.0.0.1', 9000, 'secret'); // Invoke admin_create_user (multiple parameters) $parameters = array('user_firstname' => 'John', 'user_lastname' => 'Doe', 'user_password' => 'secret', 'start_region_x' => 10000, 'start_region_y' => 10000); $myRemoteAdmin->SendCommand('admin_create_user', $parameters); ?>
