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 uom library read command:

print(uom.dump(uom.auth))

⇒

<...>

Sample JS request write command:

request.put({url:"auth/",body:<...>});

Browse more samples

Users list

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 JS request read command:

request.get({url:"auth/users/"},function(error,response,body) {console.log(body)});

⇒

Sample requests user account creation command:

requests.post('http://192.168.0.100/restapi/auth/users/',auth=auth,headers=headers,json={'password': '9vj3Gy_||en?O', 'is_admin': False, 'name': 'harry', 'is_allowed': True, 'outlet_access': [False, False, True, False, False, True, False, True]})

Browse more samples

User account

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 uom library write command (note that _user_account_index is a variable):

uom.auth.users[_user_account_index]={is_allowed=true,name="harry",outlet_access={true,false,false,true,false,true,true,true},password="u7-J`G%9';xz"}

Sample JS request read command (note that _user_account_index is a variable):

request.get({url:"auth/users/"+_user_account_index.toString()+"/"},function(error,response,body) {console.log(body)});

⇒

{"password":"6:mHiCrz","is_admin":true,"name":"admin","is_allowed":true,"outlet_access":[true,true,true,true,true,true,true,true]}

Browse more samples

User account: Username

string	auth/users/N/name/
Username

The value is subject to the following constraints: all of the following is true:

the value matches ^[a-zA-Z0-9]*$
name members of all values of users list are distinct

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

not administrative user
all of the following is true:
- administrative user
- protect admin login

This string represents a value in persistent storage.

Write operations must supply the current value of password if administrative user

Sample requests read command (note that _user_account_index is a variable):

print(requests.get('http://192.168.0.100/restapi/auth/users/'+str(_user_account_index)+'/name/',auth=auth,headers=headers).json())

⇒

'tom'

Sample CLI read command (note that user_account_index is a variable):

uom get "auth/users/${user_account_index}/name"

⇒

"harry"

Browse more samples

User account: Password

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:

Changing the value is denied if any of the following is true:

not administrative user
all of the following is true:
- administrative user
- protect admin login

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" "\"nn(pqw]T\""

Sample JS request write command (note that _user_account_index is a variable):

request.put({url:"auth/users/"+_user_account_index.toString()+"/password/",body:"]#.Boq@d\"XkcR/"});

Browse more samples

User account: User allowed

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 any of the following is true:

not administrative user
all of the following is true:
- administrative user
- protect admin login

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 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

Sample CLI write command (note that user_account_index is a variable):

uom set "auth/users/${user_account_index}/is_allowed" "true"

Browse more samples

User account: Administrative user

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 any of the following is true:

not administrative user
all of the following is true:
- administrative user
- protect admin login

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 requests read command (note that _user_account_index is a variable):

print(requests.get('http://192.168.0.100/restapi/auth/users/'+str(_user_account_index)+'/is_admin/',auth=auth,headers=headers).json())

⇒

True

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)});

⇒

false

Browse more samples

User account: Outlet access levels

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 any of the following is true:

not administrative user
all of the following is true:
- administrative user
- protect admin login

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 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/outlet_access/"

⇒

[false,false,false,false,true,false,false,true]

Sample CLI outlet access creation command (note that user_account_index is a variable):

uom insert "auth/users/${user_account_index}/outlet_access/7" "false"

Browse more samples

Outlet access

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 any of the following is true:

not administrative user
all of the following is true:
- administrative user
- protect admin login

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 read command (note that _user_account_index and _outlet_access_index are variables):

request.get({url:"auth/users/"+_user_account_index.toString()+"/outlet_access/"+_outlet_access_index.toString()+"/"},function(error,response,body) {console.log(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/"

⇒

true

Browse more samples

Clients

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 requests read command:

print(requests.get('http://192.168.0.100/restapi/auth/clients/',auth=auth,headers=headers).json())

⇒

Sample uom library client creation command:

uom.insert(uom.auth.clients,"i",{access_tokens={["510b8e84050bf0146ddfa7bd9cab270f"]={expiry_time=1615594611,remaining_use_count=32}},redirect_urls={["https://%e0]]]"]=true,["https://]W%0E"]=true},refresh_tokens={["1ae40535935555ffdf7274ca5ac29698"]={expiry_time=null,remaining_use_count=87}},scopes={["dli+object+read:/"]=true,["dli+object+read:/config/"]=true,["dli+object+read:/relay/"]=true},secret_hash="98c4aa2825f41ba71e81efe854d1dd15"})

Browse more samples

Client

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 uom library write command (note that _client is a variable):

uom.auth.clients[_client]={access_tokens={["3d6b02478f3cda845b22555e68e4eac1"]={expiry_time=1630650490,remaining_use_count=null}},redirect_urls={["https://L%Da"]=true,["https://]]]%8E%Cf"]=true},refresh_tokens={["270f77c9e06dacaa97ece238d9507f23"]={expiry_time=null,remaining_use_count=82},a7aaff517d1fef82a3ac647ba251dbe0={expiry_time=null,remaining_use_count=null},e068cb504a42643bbb4a282a56cd1178={expiry_time=null,remaining_use_count=29}},scopes={["dli+object+full:/config/links/"]=true,["dli+object+read:/config/"]=true,["dli+object+read:/relay/outlets/6/"]=true},secret_hash="fb1c76aba57b5802933755b5ca98df3a"}

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/"

⇒

Browse more samples

Client: Name

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 write command (note that _client is a variable):

uom.auth.clients[_client].name={}

Sample requests write command (note that _client is a variable):

requests.put('http://192.168.0.100/restapi/auth/clients/'+_client+'/name/',auth=auth,headers=headers,json={})

Browse more samples

Client: Secret hash, if any

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 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/secret_hash/"

⇒

null

Sample uom library read command (note that _client is a variable):

print(uom.dump(uom.auth.clients[_client].secret_hash))

⇒

"d08639be5d75085b739b0a70fd2c730f"

Browse more samples

Client: Redirect URL set

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 JS request write command (note that _client is a variable):

request.put({url:"auth/clients/"+_client+"/redirect_urls/",body:{"https://]](":true,"https://%87":true,"https://]#":true}});

Sample uom library write command (note that _client is a variable):

uom.auth.clients[_client].redirect_urls={["https://%0B]"]=true,["https://%6F%C3]]"]=true}

Browse more samples

Allowed

constant true	auth/clients/S/redirect_urls/S/
The given URL is allowed to receive redirection on successful login

Sample curl read command (note that :client and :allowed are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/clients/:client/redirect_urls/:allowed/"

⇒

true

Sample requests read command (note that _client and _allowed are variables):

print(requests.get('http://192.168.0.100/restapi/auth/clients/'+_client+'/redirect_urls/'+_allowed+'/',auth=auth,headers=headers).json())

⇒

True

Browse more samples

Client: Scope set

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:/":true,"dli+object+read:/":true,"dli+object+full:/relay/outlets/6/":true}

Sample CLI authorized creation command (note that client is a variable):

uom insert "auth/clients/${client}/scopes/dli+object+read:/config/links/" "true"

Browse more samples

Authorized

constant true	auth/clients/S/scopes/S/
The client is authorized to access the given scope

Sample JS request deletion command (note that _client and _authorized are variables):

request.delete({url:"auth/clients/"+_client+"/scopes/"+_authorized+"/"});

Sample curl deletion command (note that :client and :authorized are URL template arguments):

curl --digest -u admin:1234 -H "X-CSRF: x" -X DELETE -H "Accept: application/json" "http://192.168.0.100/restapi/auth/clients/:client/scopes/:authorized/"

Browse more samples

Client: Refresh tokens

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 uom library write command (note that _client is a variable):

uom.auth.clients[_client].refresh_tokens={b4a20de1330b43f003a4e275e6fc30d6={expiry_time=1640177374,remaining_use_count=100},c074cbf2e8b4128879bcf2bbc42d8f35={expiry_time=1639963354,remaining_use_count=null}}

Sample JS request token properties creation command (note that _client is a variable):

request.put({url:"auth/clients/"+_client+"/refresh_tokens/49dce6c36c3ae4832371598b9ad81bf0/",body:{"expiry_time":1647292661,"remaining_use_count":8}});

Browse more samples

Token properties

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 requests write command (note that _client and _token_properties are variables):

requests.put('http://192.168.0.100/restapi/auth/clients/'+_client+'/refresh_tokens/'+_token_properties+'/',auth=auth,headers=headers,json={'expiry_time': 1646029378, 'remaining_use_count': None})

Sample CLI deletion command (note that client and token_properties are variables):

uom remove "auth/clients/${client}/refresh_tokens/${token_properties}"

Browse more samples

Expiry time, if any

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 CLI read command (note that client and token_properties are variables):

uom get "auth/clients/${client}/refresh_tokens/${token_properties}/expiry_time"

⇒

1664828220

Sample uom library read command (note that _client and _token_properties are variables):

print(uom.dump(uom.auth.clients[_client].refresh_tokens[_token_properties].expiry_time))

⇒

null

Browse more samples

Remaining use count, if any

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:

the value is an integer
the value is greater or equal to 0

Sample CLI write command (note that client and token_properties are variables):

uom set "auth/clients/${client}/refresh_tokens/${token_properties}/remaining_use_count" "54"

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 "67" "http://192.168.0.100/restapi/auth/clients/:client/refresh_tokens/:token_properties/remaining_use_count/"

Browse more samples

Client: Access tokens

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 token properties creation command (note that client is a variable):

uom insert "auth/clients/${client}/access_tokens/81c7612aff459084c343c6be6f138e33" "{\"expiry_time\":null,\"remaining_use_count\":73}"

Sample requests write command (note that _client is a variable):

requests.put('http://192.168.0.100/restapi/auth/clients/'+_client+'/access_tokens/',auth=auth,headers=headers,json={'0c49c441f8f7cac8e15eaab9903639a7': {'expiry_time': 1648776586, 'remaining_use_count': None}, '6a774c25fde898c6245f4cb8aa9de6da': {'expiry_time': 1692658200, 'remaining_use_count': 26}})

Browse more samples

Token properties

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\":1634142516,\"remaining_use_count\":null}" "http://192.168.0.100/restapi/auth/clients/:client/access_tokens/:token_properties/"

Sample curl deletion command (note that :client and :token_properties are URL template arguments):

curl --digest -u admin:1234 -H "X-CSRF: x" -X DELETE -H "Accept: application/json" "http://192.168.0.100/restapi/auth/clients/:client/access_tokens/:token_properties/"

Browse more samples

Expiry time, if any

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 CLI read command (note that client and token_properties are variables):

uom get "auth/clients/${client}/access_tokens/${token_properties}/expiry_time"

⇒

1615746369

Sample JS request write command (note that _client and _token_properties are variables):

request.put({url:"auth/clients/"+_client+"/access_tokens/"+_token_properties+"/expiry_time/",body:null});

Browse more samples

Remaining use count, if any

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:

the value is an integer
the value is greater or equal to 0

Sample CLI read command (note that client and token_properties are variables):

uom get "auth/clients/${client}/access_tokens/${token_properties}/remaining_use_count"

⇒

null

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))

⇒

Browse more samples

Realm

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 uom library read command:

print(uom.dump(uom.auth.realm))

⇒

{}

Sample JS request read command:

request.get({url:"auth/realm/"},function(error,response,body) {console.log(body)});

⇒

[]

Browse more samples

Cookie timeout

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 uom library read command:

print(uom.dump(uom.auth.cookie_timeout))

⇒

Sample requests read command:

print(requests.get('http://192.168.0.100/restapi/auth/cookie_timeout/',auth=auth,headers=headers).json())

⇒

Browse more samples

Notifications

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 requests read command:

print(requests.get('http://192.168.0.100/restapi/auth/notifications/',auth=auth,headers=headers).json())

⇒

<...>

Sample curl read command:

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/notifications/"

⇒

...

Browse more samples

Events

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 requests read command:

print(requests.get('http://192.168.0.100/restapi/auth/notifications/events/',auth=auth,headers=headers).json())

⇒

<...>

Sample curl read command:

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/auth/notifications/events/"

⇒

...

Browse more samples

Notifications: Parameter kinds

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

Username

string	auth/notifications/parameter_kinds/auth_login/
The name of the user

Client name

string	auth/notifications/parameter_kinds/auth_client_name/
The name of the client

Client identifier

string	auth/notifications/parameter_kinds/auth_client_id/
The identifier of the client

IP address

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])$

Method

string	auth/notifications/parameter_kinds/auth_method/
The authentication method

Reason

string	auth/notifications/parameter_kinds/auth_reason/
The reason for authentication decision

Authentication allowed

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

User state

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

Event parameters: Event parameter

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 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()+"/"},function(error,response,body) {console.log(body)});

⇒

{"fixed_value":true,"has_fixed_value":true,"id":"auth_allowed"}

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]))

⇒

{fixed_value=null,has_fixed_value=false,id="auth_login"}

Browse more samples

Identifier

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 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()+"/id/"},function(error,response,body) {console.log(body)});

⇒

"auth_login"

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_login"

Browse more samples

Fixed value flag

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 CLI read command (note that event and event_parameter_index are variables):

uom get "auth/notifications/events/${event}/parameters/${event_parameter_index}/has_fixed_value"

⇒

false

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/has_fixed_value/"

⇒

true

Browse more samples

Fixed value

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 CLI read command (note that event and event_parameter_index are variables):

uom get "auth/notifications/events/${event}/parameters/${event_parameter_index}/fixed_value"

⇒

false

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].fixed_value))

⇒

false

Browse more samples

Events: Event

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 read command (note that _event is a variable):

print(uom.dump(uom.auth.notifications.events[_event]))

⇒

{message_template={"deleted user ",0},parameters={{fixed_value=null,has_fixed_value=false,id="auth_login"},{fixed_value=false,has_fixed_value=true,id="user_state"}},severity=6}

Sample JS request write command (note that _event is a variable):

request.put({url:"auth/notifications/events/"+_event+"/",body:{"severity":6,"message_template":["protection violation attempt: ",0],"parameters":[{"fixed_value":null,"has_fixed_value":false,"id":"auth_reason"}]}});

Browse more samples

Message template

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 requests read command (note that _event is a variable):

print(requests.get('http://192.168.0.100/restapi/auth/notifications/events/'+_event+'/message_template/',auth=auth,headers=headers).json())

⇒

['login denied for ', 0, '@', 1, ' (', 2, '): ', 3]

Sample uom library read command (note that _event is a variable):

print(uom.dump(uom.auth.notifications.events[_event].message_template))

⇒

{"deleted user ",0}

Browse more samples

Message template element

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]))

⇒

"login allowed for "

Sample JS request read command (note that _event and _message_template_element_index are variables):

request.get({url:"auth/notifications/events/"+_event+"/message_template/"+_message_template_element_index.toString()+"/"},function(error,response,body) {console.log(body)});

⇒

"login denied for "

Browse more samples

Severity

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 JS request read command (note that _event is a variable):

request.get({url:"auth/notifications/events/"+_event+"/severity/"},function(error,response,body) {console.log(body)});

⇒

Sample uom library read command (note that _event is a variable):

print(uom.dump(uom.auth.notifications.events[_event].severity))

⇒

Browse more samples

Event parameters

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 CLI read command (note that event is a variable):

uom get "auth/notifications/events/${event}/parameters"

⇒

[{"fixed_value":null,"has_fixed_value":false,"id":"auth_login"},{"fixed_value":null,"has_fixed_value":false,"id":"auth_ip"}]

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=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"}}

Browse more samples