| object | cred/ |
| Security attributes of agent performing request | |
This object contains the following items:
| name | Client username, if any |
| is_admin | Administrative user |
| outlet_access | Outlet access permissions |
| agent | Agent identifier |
| ip_address | Client IP address, if any |
Sample requests read command:
print(requests.get('http://192.168.0.100/restapi/cred/',auth=auth,headers=headers).json())
⇒
{'ip_address': '192.168.0.75', 'is_admin': True, 'name': 'admin', 'agent': 'web ui', 'outlet_access': [True, True, True, True, True, True, True, True]}
Sample JS request write command:
request.put({url:"cred/",body:{"ip_address":"192.168.0.30","is_admin":true,"name":"admin","agent":"web ui","outlet_access":[true,true,true,true,true,true,true,true]}});
Client username, if any
| sum (optional string) | cred/name/ |
| Username of the client, as verified by the agent, if any | |
This sum does not support direct modification.
This sum can assume the following values:
| constant null | Username absent or unknown | Username could not be obtained | |
| string | Client username | Username of the client, as verified by the agent | |
Sample JS request read command:
request.get({url:"cred/name/"},function(error,response,body) {console.log(body)});
⇒
"admin"
Sample requests read command:
print(requests.get('http://192.168.0.100/restapi/cred/name/',auth=auth,headers=headers).json())
⇒
'admin'
Administrative user
| sum (boolean) | cred/is_admin/ |
| Flag indicating whether the user is an administrator | |
This sum does not support direct modification.
This sum can assume the following values:
| constant true | Administrator | The user is an administrator | |
| constant false | Regular user | The user is a regular user | |
Sample uom library read command:
print(uom.dump(uom.cred.is_admin))
⇒
true
Sample CLI read command:
uom get "cred/is_admin"
⇒
true
Outlet access permissions
| sum (variant) | cred/outlet_access/ |
| Access settings for outlets | |
The value is subject to the following constraints: any of the following is true:
- the value is equal to
true - the value is equal to
false - length of the value is equal to length of outlets
This sum is composite, i.e. is modified as a whole.
This sum does not support direct modification.
This sum can assume the following values:
| constant true | Full | State of all outlets can be manipulated by the user | |
| constant false | None | Outlet states cannot be neither seen nor manipulated by the user | |
| array | Outlet access levels | Access levels per outlet | |
Sample uom library read command:
print(uom.dump(uom.cred.outlet_access))
⇒
{true,true,true,true,true,true,true,true}
Sample JS request read command:
request.get({url:"cred/outlet_access/"},function(error,response,body) {console.log(body)});
⇒
[true,true,true,true,true,true,true,true]
See also Outlet access permissions: Outlet access levels
Outlet access permissions: Outlet access levels
| (possibly) array | cred/outlet_access/ |
| Access levels per outlet | |
This array is a part of a composite value which is modified as a whole.
This array contains Outlet access elements.
Creating elements in this collection is not supported.
Outlet access
| sum (boolean) | cred/outlet_access/N/ |
| Access level for outlet by index | |
The value is subject to the following constraints: outlets[index of the value]
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification.
This sum can assume the following values:
| constant true | Full | Outlet state can be manipulated by the user | |
| constant false | None | Outlet state cannot be neither seen nor manipulated by the user | |
Sample JS request read command (note that _outlet_access_index is a variable):
request.get({url:"cred/outlet_access/"+_outlet_access_index.toString()+"/"},function(error,response,body) {console.log(body)});
⇒
true
Sample uom library read command (note that _outlet_access_index is a variable):
print(uom.dump(uom.cred.outlet_access[_outlet_access_index]))
⇒
true
Agent identifier
| string | cred/agent/ |
| Identifier of the agent performing request | |
This string does not support direct modification.
Sample JS request read command:
request.get({url:"cred/agent/"},function(error,response,body) {console.log(body)});
⇒
"web ui"
Sample requests read command:
print(requests.get('http://192.168.0.100/restapi/cred/agent/',auth=auth,headers=headers).json())
⇒
'web ui'
Client IP address, if any
| sum (optional string) | cred/ip_address/ |
| IPv4 address of the client performing request, if any | |
This sum does not support direct modification.
This sum can assume the following values:
| constant null | Client IP address absent or unknown | The request is performed locally, or its origin is unknown | |
| string | Client IP address | IPv4 address of the client performing request | the value matches ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5]).){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ |
Sample requests read command:
print(requests.get('http://192.168.0.100/restapi/cred/ip_address/',auth=auth,headers=headers).json())
⇒
'192.168.0.44'
Sample CLI read command:
uom get "cred/ip_address"
⇒
"192.168.0.82"
