DLI DC3 Object Model Reference
|
object | auth/ |
Object representing the authentication server configuration |
Retrieving the value is denied if not administrative user
This object contains the following items:
users | Users list |
clients | Clients |
realm | Realm |
cookie_timeout | Cookie timeout |
notifications | Notifications |
Sample CLI write command:
uom set auth ...
Sample curl
read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/"
⇒
...
array | auth/users/ |
List of user accounts |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This array represents a value in persistent storage.
This array represents an unordered set (order of its elements doesn't matter, and each value should not be supplied more than once).
This array contains User account elements.
Sample requests
user account creation command:
requests.post('http://192.168.0.100/restapi/auth/users/',auth=auth,headers=headers,json={'password': '6apE&j|6', 'name': 'harry', 'is_allowed': True, 'outlet_access': [False, True, True, True, True, True, True, True]})
Sample JS request
write command:
request.put({url:"auth/users/",body:[{"password":"wM8g- :`-yw#-`eZ","is_admin":false,"name":"admin","is_allowed":true,"outlet_access":[true,true,true,true,true,true,true,true]},{"password":"fUr@ao<e8","is_admin":false,"name":"tom","is_allowed":true,"outlet_access":[false,true,false,true,true,false,false,true]},{"password":"&;ifHc^Lq@3L","name":"dick","is_allowed":false,"outlet_access":[false,false,true,true,true,false,true,false]},{"password":"O9R>cT&\\oVb+","is_admin":false,"name":"harry","is_allowed":true,"outlet_access":[true,true,false,true,true,true,false,true]}]});
object | auth/users/N/ |
User account configuration |
Removing the object from its parent collection is denied if administrative user
This object contains the following items:
name | Username |
password | Password |
is_allowed | User allowed |
is_admin | Administrative user |
outlet_access | Outlet access levels |
Sample JS request
deletion command (note that _user_account_index
is a variable):
request.delete({url:"auth/users/"+_user_account_index.toString()+"/"});
Sample CLI write command (note that user_account_index
is a variable):
uom set "auth/users/${user_account_index}" "{\"password\":\"\\\\_3EhZ3`V8W\",\"name\":\"admin\",\"is_allowed\":true,\"outlet_access\":[true,true,true,true,true,true,true,true]}"
See also User account: Username
See also User account: Password
See also User account: User allowed
See also User account: Administrative user
See also User account: Outlet access levels
string | auth/users/N/name/ |
Username |
The value is subject to the following constraints: all of the following is true:
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Write operations must supply the current value of password if administrative user
Sample uom
library read command (note that _user_account_index
is a variable):
print(uom.dump(uom.auth.users[_user_account_index].name))
⇒
"tom"
Sample JS request
read command (note that _user_account_index
is a variable):
request.get({url:"auth/users/"+_user_account_index.toString()+"/name/"},function(error,response,body) {console.log(body)});
⇒
"harry"
string | auth/users/N/password/ |
Password |
The value is subject to the following constraints: the value matches ^[ -~]*$
Retrieving the value is denied if any of the following is true:
Using the string as a field for indexing into the grandparent collection is denied
This string represents a value in persistent storage.
This string should be displayed in a secure manner.
Write operations must supply the current value of the value if administrative user
Sample CLI write command (note that user_account_index
is a variable):
uom set "auth/users/${user_account_index}/password" "\"P={ JebWzz'GG\""
Sample uom
library write command (note that _user_account_index
is a variable):
uom.auth.users[_user_account_index].password="7m:(5fH%3:uM?<"
sum (boolean) | auth/users/N/is_allowed/ |
Flag indicating whether user is allowed or denied |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum does not support direct modification if administrative user.
This sum represents a value in persistent storage.
This sum can assume the following values:
constant true | Allowed | The user is allowed to log in | |
constant false | Denied | The user is denied login |
Sample CLI write command (note that user_account_index
is a variable):
uom set "auth/users/${user_account_index}/is_allowed" "true"
Sample curl
read command (note that :user_account_index
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/users/:user_account_index/is_allowed/"
⇒
true
sum (boolean) | auth/users/N/is_admin/ |
Flag indicating whether the user is an administrator |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum does not support direct modification.
This sum represents a value in persistent storage.
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 JS request
read command (note that _user_account_index
is a variable):
request.get({url:"auth/users/"+_user_account_index.toString()+"/is_admin/"},function(error,response,body) {console.log(body)});
⇒
true
Sample uom
library read command (note that _user_account_index
is a variable):
print(uom.dump(uom.auth.users[_user_account_index].is_admin))
⇒
false
array | auth/users/N/outlet_access/ |
Access levels per outlet |
The value is subject to the following constraints: length of the value is equal to length of outlets
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This array is composite, i.e. is modified as a whole.
This array does not support direct modification if administrative user.
This array represents a value in persistent storage.
This array contains Outlet access elements.
Sample uom
library write command (note that _user_account_index
is a variable):
uom.auth.users[_user_account_index].outlet_access={true,true,true,false,false,false,false,false}
Sample requests
outlet access creation command (note that _user_account_index
is a variable):
requests.post('http://192.168.0.100/restapi/auth/users/'+str(_user_account_index)+'/outlet_access/',auth=auth,headers=headers,json=False)
sum (boolean) | auth/users/N/outlet_access/N/ |
Access level for outlet by index |
The value is subject to the following constraints: outlets[index of the value]
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification if administrative user.
This sum represents a value in persistent storage.
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
write command (note that _user_account_index
and _outlet_access_index
are variables):
request.put({url:"auth/users/"+_user_account_index.toString()+"/outlet_access/"+_outlet_access_index.toString()+"/",body:true});
Sample curl
read command (note that :user_account_index
and :outlet_access_index
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/users/:user_account_index/outlet_access/:outlet_access_index/"
⇒
false
map | auth/clients/ |
Client accounts allowed scope-limited token-based access |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map represents a value in persistent storage.
This map contains Client elements.
Sample curl
client creation command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "{\"redirect_urls\":{\"https://F\":true,\"https://$]&%DC\":true},\"refresh_tokens\":{\"8f3b800ae4d61bdbe4ea30df87de448c\":{\"expiry_time\":1676322625,\"remaining_use_count\":82},\"87bd52e0f9f48a88770f4e397fe37b00\":{\"expiry_time\":1678096669,\"remaining_use_count\":null}},\"secret_hash\":null,\"access_tokens\":{\"b8e573d1b6936885c2dc013b24ee16dd\":{\"expiry_time\":null,\"remaining_use_count\":null},\"6f18b71fea837a13a2764b53cb1aadd0\":{\"expiry_time\":null,\"remaining_use_count\":null}},\"scopes\":{\"dli+object+read:/script/\":true,\"dli+object+read:/\":true}}" "http://192.168.0.100/restapi/auth/clients/xgYlhVa/"
Sample CLI read command:
uom get "auth/clients"
⇒
...
object | auth/clients/S/ |
API client properties |
This object contains the following items:
name | Name |
secret_hash | Secret hash, if any |
redirect_urls | Redirect URL set |
scopes | Scope set |
refresh_tokens | Refresh tokens |
access_tokens | Access tokens |
Sample JS request
deletion command (note that _client
is a variable):
request.delete({url:"auth/clients/"+_client+"/"});
Sample requests
deletion command (note that _client
is a variable):
requests.delete('http://192.168.0.100/restapi/auth/clients/'+_client+'/',auth=auth,headers=headers)
See also Client: Name
See also Client: Secret hash, if any
See also Client: Redirect URL set
See also Client: Scope set
See also Client: Refresh tokens
See also Client: Access tokens
string | auth/clients/S/name/ |
User-visible name of the client |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Sample uom
library read command (note that _client
is a variable):
print(uom.dump(uom.auth.clients[_client].name))
⇒
{}
Sample JS request
write command (note that _client
is a variable):
request.put({url:"auth/clients/"+_client+"/name/",body:[]});
sum (optional string) | auth/clients/S/secret_hash/ |
Hash of the client secret in an implementation-defined format, if any |
Retrieving the value is denied if not administrative user
This sum does not support direct modification.
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | None | The client does not have a secret to authenticate itself | |
string | Secret hash | Hash of the client secret in an implementation-defined format |
Sample uom
library read command (note that _client
is a variable):
print(uom.dump(uom.auth.clients[_client].secret_hash))
⇒
null
Sample JS request
read command (note that _client
is a variable):
request.get({url:"auth/clients/"+_client+"/secret_hash/"},function(error,response,body) {console.log(body)});
⇒
null
map | auth/clients/S/redirect_urls/ |
Set of URLs permitted to receive redirection on successful login |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map represents a value in persistent storage.
This map contains Allowed elements.
Sample curl
read command (note that :client
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/clients/:client/redirect_urls/"
⇒
{"https://%1f%D7]%B61%bc]]%3b":true,"https://(":true}
Sample requests
write command (note that _client
is a variable):
requests.put('http://192.168.0.100/restapi/auth/clients/'+_client+'/redirect_urls/',auth=auth,headers=headers,json={'https://%ab]]': True})
constant true | auth/clients/S/redirect_urls/S/ |
The given URL is allowed to receive redirection on successful login |
Sample JS request
deletion command (note that _client
and _allowed
are variables):
request.delete({url:"auth/clients/"+_client+"/redirect_urls/"+_allowed+"/"});
Sample requests
write command (note that _client
and _allowed
are variables):
requests.put('http://192.168.0.100/restapi/auth/clients/'+_client+'/redirect_urls/'+_allowed+'/',auth=auth,headers=headers,json=True)
map | auth/clients/S/scopes/ |
Set of scopes that the authenticated client is authorized to access |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map represents a value in persistent storage.
This map contains Authorized elements.
Sample JS request
read command (note that _client
is a variable):
request.get({url:"auth/clients/"+_client+"/scopes/"},function(error,response,body) {console.log(body)});
⇒
{"dli+object+full:/relay/outlets/":true,"dli+object+read:/":true}
Sample requests
read command (note that _client
is a variable):
print(requests.get('http://192.168.0.100/restapi/auth/clients/'+_client+'/scopes/',auth=auth,headers=headers).json())
⇒
{'dli+object+full:/': True, 'dli+object+read:/': True}
constant true | auth/clients/S/scopes/S/ |
The client is authorized to access the given scope |
Sample requests
write command (note that _client
and _authorized
are variables):
requests.put('http://192.168.0.100/restapi/auth/clients/'+_client+'/scopes/'+_authorized+'/',auth=auth,headers=headers,json=True)
Sample uom
library deletion command (note that _client
and _authorized
are variables):
uom.remove(uom.auth.clients[_client].scopes,_authorized)
map | auth/clients/S/refresh_tokens/ |
Tokens that can be used to create access tokens |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map represents a value in persistent storage.
This map can change as if by itself or indirectly because of other actions.
Changes to this map cannot be tracked.
This map contains Token properties elements.
Sample requests
read command (note that _client
is a variable):
print(requests.get('http://192.168.0.100/restapi/auth/clients/'+_client+'/refresh_tokens/',auth=auth,headers=headers).json())
⇒
{'bda3daaa1fdf9da576e882023061172c': {'expiry_time': 1679076443, 'remaining_use_count': 15}, '79d2c29da8ff7d743dafab9c91138a0f': {'expiry_time': 1689297649, 'remaining_use_count': 2}}
Sample JS request
token properties creation command (note that _client
is a variable):
request.put({url:"auth/clients/"+_client+"/refresh_tokens/674be2d7e1f6f260fce9e1b5413666ad/",body:{"expiry_time":null,"remaining_use_count":null}});
object | auth/clients/S/refresh_tokens/S/ |
Properties of the refresh token |
Retrieving the value is denied if not administrative user
This object contains the following items:
expiry_time | Expiry time, if any |
remaining_use_count | Remaining use count, if any |
Sample curl
write command (note that :client
and :token_properties
are URL template arguments):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "{\"expiry_time\":1613651244,\"remaining_use_count\":70}" "http://192.168.0.100/restapi/auth/clients/:client/refresh_tokens/:token_properties/"
Sample JS request
deletion command (note that _client
and _token_properties
are variables):
request.delete({url:"auth/clients/"+_client+"/refresh_tokens/"+_token_properties+"/"});
sum (optional number) | auth/clients/S/refresh_tokens/S/expiry_time/ |
The time at which the token is invalidated, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | Indefinite | The token stays valid for an indefinite time | |
number | Expiry time | The time at which the token is invalidated |
Sample uom
library write command (note that _client
and _token_properties
are variables):
uom.auth.clients[_client].refresh_tokens[_token_properties].expiry_time=null
Sample CLI write command (note that client
and token_properties
are variables):
uom set "auth/clients/${client}/refresh_tokens/${token_properties}/expiry_time" "1603159367"
sum (optional number) | auth/clients/S/refresh_tokens/S/remaining_use_count/ |
The number of times the token can be used before it is is invalidated, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can change as if by itself or indirectly because of other actions.
Changes to this sum cannot be tracked.
This sum can assume the following values:
constant null | Indefinite | The token may be used any number of times | |
number | Remaining use count | The number of times the token can be used before it is is invalidated | all of the following is true: |
Sample curl
read command (note that :client
and :token_properties
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/clients/:client/refresh_tokens/:token_properties/remaining_use_count/"
⇒
null
Sample JS request
read command (note that _client
and _token_properties
are variables):
request.get({url:"auth/clients/"+_client+"/refresh_tokens/"+_token_properties+"/remaining_use_count/"},function(error,response,body) {console.log(body)});
⇒
2
map | auth/clients/S/access_tokens/ |
Tokens that can be used to access the scopes |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map represents a value in persistent storage.
This map can change as if by itself or indirectly because of other actions.
Changes to this map cannot be tracked.
This map contains Token properties elements.
Sample CLI write command (note that client
is a variable):
uom set "auth/clients/${client}/access_tokens" "{\"e86ef2ece67d7593a2f07c89e93f3f41\":{\"expiry_time\":1672051795,\"remaining_use_count\":45},\"f3c5aad041a61bed37cdbb0a022c2991\":{\"expiry_time\":null,\"remaining_use_count\":48},\"057462b7da4121fdcf8d2a9443609d89\":{\"expiry_time\":1698556199,\"remaining_use_count\":null}}"
Sample CLI token properties creation command (note that client
is a variable):
uom insert "auth/clients/${client}/access_tokens/578be070e98720211446c789de9f897d" "{\"expiry_time\":1698490247,\"remaining_use_count\":null}"
object | auth/clients/S/access_tokens/S/ |
Properties of the access token |
Retrieving the value is denied if not administrative user
This object contains the following items:
expiry_time | Expiry time, if any |
remaining_use_count | Remaining use count, if any |
Sample curl
write command (note that :client
and :token_properties
are URL template arguments):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "{\"expiry_time\":null,\"remaining_use_count\":null}" "http://192.168.0.100/restapi/auth/clients/:client/access_tokens/:token_properties/"
Sample JS request
write command (note that _client
and _token_properties
are variables):
request.put({url:"auth/clients/"+_client+"/access_tokens/"+_token_properties+"/",body:{"expiry_time":1689017762,"remaining_use_count":null}});
sum (optional number) | auth/clients/S/access_tokens/S/expiry_time/ |
The time at which the token is invalidated, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | Indefinite | The token stays valid for an indefinite time | |
number | Expiry time | The time at which the token is invalidated |
Sample curl
write command (note that :client
and :token_properties
are URL template arguments):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "null" "http://192.168.0.100/restapi/auth/clients/:client/access_tokens/:token_properties/expiry_time/"
Sample curl
read command (note that :client
and :token_properties
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/clients/:client/access_tokens/:token_properties/expiry_time/"
⇒
1686310200
sum (optional number) | auth/clients/S/access_tokens/S/remaining_use_count/ |
The number of times the token can be used before it is is invalidated, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can change as if by itself or indirectly because of other actions.
Changes to this sum cannot be tracked.
This sum can assume the following values:
constant null | Indefinite | The token may be used any number of times | |
number | Remaining use count | The number of times the token can be used before it is is invalidated | all of the following is true: |
Sample uom
library read command (note that _client
and _token_properties
are variables):
print(uom.dump(uom.auth.clients[_client].access_tokens[_token_properties].remaining_use_count))
⇒
55
Sample curl
write command (note that :client
and :token_properties
are URL template arguments):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "58" "http://192.168.0.100/restapi/auth/clients/:client/access_tokens/:token_properties/remaining_use_count/"
string | auth/realm/ |
The realm to be announced in authentication responses |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Sample requests
write command:
requests.put('http://192.168.0.100/restapi/auth/realm/',auth=auth,headers=headers,json={})
Sample CLI read command:
uom get "auth/realm"
⇒
[]
number | auth/cookie_timeout/ |
The amount of time for which a cookie is valid |
The value represents time, the standard unit of which is the second (s).
The value is subject to the following constraints: the value is greater than 0
Changing the value is denied if not administrative user
This number represents a value in persistent storage.
Sample CLI write command:
uom set "auth/cookie_timeout" "30000"
Sample curl
write command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "30000" "http://192.168.0.100/restapi/auth/cookie_timeout/"
object | auth/notifications/ |
Authentication-related notifications |
Retrieving the value is denied if not administrative user
This object does not support direct modification.
This object contains the following items:
parameter_kinds | Parameter kinds |
events | Events |
Sample CLI read command:
uom get "auth/notifications"
⇒
...
Sample uom
library read command:
print(uom.dump(uom.auth.notifications))
⇒
<...>
See also Notifications: Parameter kinds
map | auth/notifications/events/ |
Event templates |
Retrieving the value is denied if not administrative user
This map is composite, i.e. is modified as a whole.
This map does not support direct modification.
This map contains Event elements.
Creating elements in this collection is not supported.
Sample CLI read command:
uom get "auth/notifications/events"
⇒
...
Sample uom
library read command:
print(uom.dump(uom.auth.notifications.events))
⇒
<...>
See also Events: Event
object | auth/notifications/parameter_kinds/ |
Kinds of event parameters |
This object does not correspond to an actual resource.
This object contains the following items:
auth_login | Username |
auth_client_name | Client name |
auth_client_id | Client identifier |
auth_ip | IP address |
auth_method | Method |
auth_reason | Reason |
auth_allowed | Authentication allowed |
user_state | User state |
string | auth/notifications/parameter_kinds/auth_login/ |
The name of the user |
string | auth/notifications/parameter_kinds/auth_client_name/ |
The name of the client |
string | auth/notifications/parameter_kinds/auth_client_id/ |
The identifier of the client |
string | auth/notifications/parameter_kinds/auth_ip/ |
The IP address of the user |
The value is subject to the following constraints: 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 | auth/notifications/parameter_kinds/auth_method/ |
The authentication method |
string | auth/notifications/parameter_kinds/auth_reason/ |
The reason for authentication decision |
sum (boolean) | auth/notifications/parameter_kinds/auth_allowed/ |
Authentication decision result |
This sum can assume the following values:
constant true | Allowed | The user is allowed to log in | |
constant false | Denied | The user is denied to log in |
sum (variant) | auth/notifications/parameter_kinds/user_state/ |
The state of the user |
This sum can assume the following values:
constant true | Existing | The user exists | |
constant false | Deleted | The user has been deleted | |
constant "new" | New | The user has been created |
object | auth/notifications/events/S/parameters/N/ |
Properties of a parameter associated with the event |
This object is a part of a composite value which is modified as a whole.
This object contains the following items:
id | Identifier |
has_fixed_value | Fixed value flag |
fixed_value | Fixed value |
Sample CLI read command (note that event
and event_parameter_index
are variables):
uom get "auth/notifications/events/${event}/parameters/${event_parameter_index}"
⇒
{"fixed_value":null,"has_fixed_value":false,"id":"auth_login"}
Sample uom
library write command (note that _event
and _event_parameter_index
are variables):
uom.auth.notifications.events[_event].parameters[_event_parameter_index]={fixed_value=null,has_fixed_value=false,id="auth_login"}
string | auth/notifications/events/S/parameters/N/id/ |
Parameter identifier |
The value is subject to the following constraints: parameter kinds[the value]
Retrieving the value is denied if not administrative user
This string is a part of a composite value which is modified as a whole.
This string does not support direct modification.
Sample uom
library read command (note that _event
and _event_parameter_index
are variables):
print(uom.dump(uom.auth.notifications.events[_event].parameters[_event_parameter_index].id))
⇒
"auth_ip"
Sample requests
read command (note that _event
and _event_parameter_index
are variables):
print(requests.get('http://192.168.0.100/restapi/auth/notifications/events/'+_event+'/parameters/'+str(_event_parameter_index)+'/id/',auth=auth,headers=headers).json())
⇒
'auth_ip'
sum (boolean) | auth/notifications/events/S/parameters/N/has_fixed_value/ |
Flag indicating that the parameter's value for this event is fixed |
Retrieving the value is denied if not administrative user
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 | Fixed | The value is fixed | |
constant false | Variable | The value is variable |
Sample requests
read command (note that _event
and _event_parameter_index
are variables):
print(requests.get('http://192.168.0.100/restapi/auth/notifications/events/'+_event+'/parameters/'+str(_event_parameter_index)+'/has_fixed_value/',auth=auth,headers=headers).json())
⇒
False
Sample JS request
read command (note that _event
and _event_parameter_index
are variables):
request.get({url:"auth/notifications/events/"+_event+"/parameters/"+_event_parameter_index.toString()+"/has_fixed_value/"},function(error,response,body) {console.log(body)});
⇒
false
sum (variant) | auth/notifications/events/S/parameters/N/fixed_value/ |
Fixed parameter value for this particular event |
Retrieving the value is denied if not administrative user
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 null | Null | Null | |
constant true | True | True | |
constant false | False | False | |
string | String | This string | |
number | Number | This number |
Sample curl
read command (note that :event
and :event_parameter_index
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/notifications/events/:event/parameters/:event_parameter_index/fixed_value/"
⇒
"new"
Sample CLI read command (note that event
and event_parameter_index
are variables):
uom get "auth/notifications/events/${event}/parameters/${event_parameter_index}/fixed_value"
⇒
"new"
object | auth/notifications/events/S/ |
Event template |
This object is a part of a composite value which is modified as a whole.
This object contains the following items:
message_template | Message template |
severity | Severity |
parameters | Event parameters |
Sample uom
library write command (note that _event
is a variable):
uom.auth.notifications.events[_event]={message_template={"login allowed for ",0,"@",1," (",2,")"},parameters={{fixed_value=null,has_fixed_value=false,id="auth_login"},{fixed_value=null,has_fixed_value=false,id="auth_ip"},{fixed_value=null,has_fixed_value=false,id="auth_method"},{fixed_value=true,has_fixed_value=true,id="auth_allowed"}},severity=6}
Sample curl
write command (note that :event
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "{\"severity\":6,\"message_template\":[\"protection violation attempt: \",0],\"parameters\":[{\"fixed_value\":null,\"has_fixed_value\":false,\"id\":\"auth_reason\"}]}" "http://192.168.0.100/restapi/auth/notifications/events/:event/"
array | auth/notifications/events/S/message_template/ |
Template for human-readable message generation |
Retrieving the value is denied if not administrative user
This array is a part of a composite value which is modified as a whole.
This array does not support direct modification.
This array contains Message template element elements.
Creating elements in this collection is not supported.
Sample JS request
read command (note that _event
is a variable):
request.get({url:"auth/notifications/events/"+_event+"/message_template/"},function(error,response,body) {console.log(body)});
⇒
[0,"@",1," session closed"]
Sample curl
read command (note that :event
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/notifications/events/:event/message_template/"
⇒
["protection violation attempt: ",0]
sum (variant) | auth/notifications/events/S/message_template/N/ |
Element of human-readable message template |
Retrieving the value is denied if not administrative user
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:
string | String | Fixed string | |
number | Parameter | Index of message parameter to insert | event parameters[the value] |
Sample uom
library read command (note that _event
and _message_template_element_index
are variables):
print(uom.dump(uom.auth.notifications.events[_event].message_template[_message_template_element_index]))
⇒
" ("
Sample CLI read command (note that event
and message_template_element_index
are variables):
uom get "auth/notifications/events/${event}/message_template/${message_template_element_index}"
⇒
"created user "
sum (enumerated number) | auth/notifications/events/S/severity/ |
Severity rating assigned to the event |
Retrieving the value is denied if not administrative user
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 1 | Emergency | Treat the event as an emergency | |
constant 2 | Alert | Treat the event as an alert | |
constant 3 | Critical | Treat the event as critical | |
constant 4 | Error | Treat the event as an error | |
constant 5 | Warning | Treat the event as a warning | |
constant 6 | Notice | Treat the event as a notice | |
constant 7 | Informational | Treat the event as informational | |
constant 8 | Debug | Treat the event as debugging-related |
Sample uom
library read command (note that _event
is a variable):
print(uom.dump(uom.auth.notifications.events[_event].severity))
⇒
6
Sample curl
read command (note that :event
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/notifications/events/:event/severity/"
⇒
6
array | auth/notifications/events/S/parameters/ |
Additional data associated with the event |
Retrieving the value is denied if not administrative user
This array is a part of a composite value which is modified as a whole.
This array does not support direct modification.
This array contains Event parameter elements.
Creating elements in this collection is not supported.
Sample uom
library read command (note that _event
is a variable):
print(uom.dump(uom.auth.notifications.events[_event].parameters))
⇒
{{fixed_value=null,has_fixed_value=false,id="auth_login"},{fixed_value=true,has_fixed_value=true,id="user_state"}}
Sample curl
read command (note that :event
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/notifications/events/:event/parameters/"
⇒
[{"fixed_value":null,"has_fixed_value":false,"id":"auth_login"},{"fixed_value":"new","has_fixed_value":true,"id":"user_state"}]
See also Event parameters: Event parameter