RemoteAdmin:admin create user
From OpenSimulator
(Difference between revisions)
m (Robot: Cosmetic changes) |
m (Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name) |
||
| Line 86: | Line 86: | ||
=== C# .NET === | === C# .NET === | ||
| − | This example needs the Nwc.XmlRpc library, located in your | + | This example needs the Nwc.XmlRpc library, located in your OpenSimulator bin folder. |
<source lang="csharp"> | <source lang="csharp"> | ||
Revision as of 22:56, 3 March 2012
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 OpenSimulator 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); ?>
