| 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 CLI write command:
uom set cred "{\"ip_address\":\"192.168.0.9\",\"is_admin\":true,\"name\":\"admin\",\"agent\":\"web ui\",\"outlet_access\":[true,true,true,true,true,true,true,true]}"
Sample CLI read command:
uom get cred
⇒
{"ip_address":"192.168.0.9","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 CLI read command:
uom get "cred/name"
⇒
"admin"
Sample curl read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/cred/name/"
⇒
"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 CLI read command:
uom get "cred/is_admin"
⇒
true
Sample curl read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/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 curl read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/cred/outlet_access/"
⇒
[true,true,true,true,true,true,true,true]
Sample requests read command:
print(requests.get('http://192.168.0.100/restapi/cred/outlet_access/',auth=auth,headers=headers).json())
⇒
[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 CLI read command (note that outlet_access_index is a variable):
uom get "cred/outlet_access/${outlet_access_index}"
⇒
true
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
Agent identifier
| string | cred/agent/ |
| Identifier of the agent performing request | |
This string does not support direct modification.
Sample uom library read command:
print(uom.dump(uom.cred.agent))
⇒
"web ui"
Sample curl read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/cred/agent/"
⇒
"web ui"
Client IP address, if any
| sum (optional string) | cred/ip_address/ |
| IP 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 | IPv4 address | IPv4 address in dotted quad notation | 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])$ |
| string | IPv6 address | IPv6 address in colon notation | the value matches ^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}(([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 CLI read command:
uom get "cred/ip_address"
⇒
"192.168.0.9"
Sample JS request read command:
request.get({url:"cred/ip_address/"},function(error,response,body) {console.log(body)});
⇒
"192.168.0.8"
