Save User

1 min

POST

{{url}}/aioc-rest-web/rest/user/saveUser

Overview

This method adds a new user to KRON PAM.

Mandatory fields in request body:

Parameters

name and surname: These fields are used to identify the user.
eid: An alternative way to reference users. It's a unique identifier for each user.
email: The email address of the user. It's essential for communication and might be used for notifications or password recovery.
phoneNumber: Contact number of the user.
groups: A list of groups to which the user belongs.
- For example, a user can be part of "DEFAULT_GROUP_SYSYEM_USERS" and "DEFAULT_GROUP_SYSYEM_ADMINS". Or it can be a member of one of your founded User Groups like "Linux_users".
password: A required field for internal users. It's the password that the user will use to log in.
passwordAlgorithm: The algorithm used to hash the password. In this case, "MD5" is used

Path Parameters

urlstring
Default
url

Header Parameters

Content-Typestring
Default
application/json
X-XSRF-TOKENstring
Default
{{csrftoken}}

Body Parameters

bodyobject
Default
{ "internal":true, "personelId":"123123","name":"test","surname":"user","eid":"testuser","email":"[email protected]","phoneNumber":"5550000000","groups":["DEFAULT_GROUP_SYSYEM_USERS", "DEFAULT_GROUP_SYSYEM_ADMINS"], "password":"admin", "passwordAlgorithm":"MD5" }

Responses

200Add User

curl

curl --request POST \
     --url {{url}}/aioc-rest-web/rest/user/saveUser \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-xsrf-token: {{csrftoken}}' \
     --data-raw '"{\r\n\t\"internal\":true,\r\n\"personelId\":\"123123\",\"name\":\"test\",\"surname\":\"user\",\"eid\":\"testuser\",\"email\":\"[email protected]\",\"phoneNumber\":\"5550000000\",\"groups\":[\"DEFAULT_GROUP_SYSYEM_USERS\", \"DEFAULT_GROUP_SYSYEM_ADMINS\"], \"password\":\"admin\", \"passwordAlgorithm\":\"MD5\"\r\n}"'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
myHeaders.append("x-xsrf-token", "{{csrftoken}}");

var raw = JSON.stringify("{\r\n\t\"internal\":true,\r\n\"personelId\":\"123123\",\"name\":\"test\",\"surname\":\"user\",\"eid\":\"testuser\",\"email\":\"[email protected]\",\"phoneNumber\":\"5550000000\",\"groups\":[\"DEFAULT_GROUP_SYSYEM_USERS\", \"DEFAULT_GROUP_SYSYEM_ADMINS\"], \"password\":\"admin\", \"passwordAlgorithm\":\"MD5\"\r\n}");

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("{{url}}/aioc-rest-web/rest/user/saveUser", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("{{url}}/aioc-rest-web/rest/user/saveUser")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request["x-xsrf-token"] = "{{csrftoken}}"
request.body = JSON.dump("{\r\n\t\"internal\":true,\r\n\"personelId\":\"123123\",\"name\":\"test\",\"surname\":\"user\",\"eid\":\"testuser\",\"email\":\"[email protected]\",\"phoneNumber\":\"5550000000\",\"groups\":[\"DEFAULT_GROUP_SYSYEM_USERS\", \"DEFAULT_GROUP_SYSYEM_ADMINS\"], \"password\":\"admin\", \"passwordAlgorithm\":\"MD5\"\r\n}")

response = http.request(request)
puts response.read_body

python

import requests
import json

url = "{{url}}/aioc-rest-web/rest/user/saveUser"

payload = json.dumps("{\r\n\t\"internal\":true,\r\n\"personelId\":\"123123\",\"name\":\"test\",\"surname\":\"user\",\"eid\":\"testuser\",\"email\":\"[email protected]\",\"phoneNumber\":\"5550000000\",\"groups\":[\"DEFAULT_GROUP_SYSYEM_USERS\", \"DEFAULT_GROUP_SYSYEM_ADMINS\"], \"password\":\"admin\", \"passwordAlgorithm\":\"MD5\"\r\n}")
headers = {
   'accept': 'application/json',
   'content-type': 'application/json',
   'x-xsrf-token': '{{csrftoken}}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

200

{
    "id": "3c040987-adb7-45ab-9a50-264f04fbe13a",
    "eid": "testuser",
    "personelId": "123123",
    "name": "test",
    "passwordAlgorithm": "MD5",
    "password": "21232f297a57a5a743894a0e4a801fc3",
    "email": "[email protected]",
    "surname": "user",
    "internal": true,
    "properties": {
        "phoneNumber": "5550000000",
        "ubaThreshold": "50"
    },
    "groups": [
        "DEFAULT_GROUP_SYSYEM_ADMINS",
        "DEFAULT_GROUP_SYSYEM_USERS"
    ],
    "managerGroups": null,
    "lastLogin": null,
    "lastLoginIp": null,
    "recordLimit4Search": null,
    "passwordDirty": false,
    "passwordAutoGenerated": false,
    "phoneNumber": "5550000000",
    "forceChangePasswordOnNextLogin": false,
    "lockReason": null,
    "unlockOnPasswordChanged": false,
    "unlockTime": null,
    "tempUserEndTime": null,
    "tempUserStartTime": null,
    "tempUser": false,
    "externalDirectorySource": null,
    "userPropertyKey4Search": null,
    "userPropertyValue4Search": null,
    "locked": false
}