Summary:
Adds a new user to the specified realm.
Request specification:
Name |
Min/Max |
Type |
Description |
|
|
|
|
|
|
|
|
|
|
The new user information. |
|
|
|
|
A password to set for the new user. |
|
|
|
|
Returns:
OK/Error
Description:
The user name can be specified as a distinguished name (DN) or as a plain name. If you use a fully qualified DN, the user will be created in the specified location in the directory tree. If you use just a plain name, the user will be created in the default container for this realm. To find out what the default DN is, use the get_realm
call.
Note: The call will try to create a new directory object of class User
(objectClass=User
). Your directory schema must have the User
class in it or the call will fail.
Example:
Creating a new user named Test_User
in the specified realm. The user name is specified as a plain name so it will be created in the default container for this Realm.
Input
<packet version="4.0.0" id="2">
<target>authm</target>
<data>
<authm>
<add_user>
<user>
<name>VGVzdF9Vc2Vy</name>
<realm>3e761571-6607-1344-a064-a42679da8ed9</realm>
<data>
<attr>
<name>description</name>
<value>VGhpcyBpcyBhIHRlc3QgdXNlcg==</value>
</attr>
</data>
</user>
<password>bXlwYXNzd2Q=</password>
</add_user>
</authm>
</data>
</packet>
Output
<?xml version="1.0" encoding="UTF-8"?><packet xmlns:ns1="http://www.swsoft.com/webservices/vzl/4.0.0/protocol" xmlns:ns2="http://www.swsoft.com/webservices/vzl/4.0.0/authm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="23c469e077at4db7r4b4" time="2007-07-18T08:57:51+0000" priority="0" version="4.0.0">
<ns1:origin>authm</ns1:origin>
<ns1:target>vzclient4-2cbbe469-8f57-7f46-97fb-fd987231d957</ns1:target>
<ns1:dst>
<ns1:director>gend</ns1:director>
</ns1:dst>
<ns1:data>
<ns2:authm>
<ns1:ok/>
</ns2:authm>
</ns1:data>
<ns1:src>
<ns1:director>gend</ns1:director>
</ns1:src>
</packet>