DLI DC3 Object Model Reference
20210819T152642Z
Authentication server object
objectauth/
Object representing the authentication server configuration
dot_inline_dotgraph_108.png

Retrieving the value is denied if not administrative user

This object contains the following items:

usersUsers list
clientsClients
realmRealm
cookie_timeoutCookie timeout
notificationsNotifications

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

...

Browse more samples

Users list

arrayauth/users/
List of user accounts
dot_inline_dotgraph_109.png

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

Browse more samples

User account

objectauth/users/N/
User account configuration
dot_inline_dotgraph_110.png

Removing the object from its parent collection is denied if administrative user

This object contains the following items:

nameUsername
passwordPassword
is_allowedUser allowed
is_adminAdministrative user
outlet_accessOutlet 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]}"

Browse more samples

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

User account: Username

stringauth/users/N/name/
Username
dot_inline_dotgraph_111.png

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"

Browse more samples

User account: Password

stringauth/users/N/password/
Password
dot_inline_dotgraph_112.png

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

Browse more samples

User account: User allowed

sum (boolean)auth/users/N/is_allowed/
Flag indicating whether user is allowed or denied
dot_inline_dotgraph_113.png

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 trueAllowedThe user is allowed to log in
constant falseDeniedThe 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

Browse more samples

User account: Administrative user

sum (boolean)auth/users/N/is_admin/
Flag indicating whether the user is an administrator
dot_inline_dotgraph_114.png

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 trueAdministratorThe user is an administrator
constant falseRegular userThe 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

Browse more samples

User account: Outlet access levels

arrayauth/users/N/outlet_access/
Access levels per outlet
dot_inline_dotgraph_115.png

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)

Browse more samples

Outlet access

sum (boolean)auth/users/N/outlet_access/N/
Access level for outlet by index
dot_inline_dotgraph_116.png

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 trueFullOutlet state can be manipulated by the user
constant falseNoneOutlet 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

Browse more samples

Clients

mapauth/clients/
Client accounts allowed scope-limited token-based access
dot_inline_dotgraph_117.png

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"

...

Browse more samples

Client

objectauth/clients/S/
API client properties
dot_inline_dotgraph_118.png

This object contains the following items:

nameName
secret_hashSecret hash, if any
redirect_urlsRedirect URL set
scopesScope set
refresh_tokensRefresh tokens
access_tokensAccess 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)

Browse more samples

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

Client: Name

stringauth/clients/S/name/
User-visible name of the client
dot_inline_dotgraph_119.png

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:[]});

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
dot_inline_dotgraph_120.png

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 nullNoneThe client does not have a secret to authenticate itself
stringSecret hashHash 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

Browse more samples

Client: Redirect URL set

mapauth/clients/S/redirect_urls/
Set of URLs permitted to receive redirection on successful login
dot_inline_dotgraph_121.png

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

Browse more samples

Allowed

constant trueauth/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)

Browse more samples

Client: Scope set

mapauth/clients/S/scopes/
Set of scopes that the authenticated client is authorized to access
dot_inline_dotgraph_122.png

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}

Browse more samples

Authorized

constant trueauth/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)

Browse more samples

Client: Refresh tokens

mapauth/clients/S/refresh_tokens/
Tokens that can be used to create access tokens
dot_inline_dotgraph_123.png

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

Browse more samples

Token properties

objectauth/clients/S/refresh_tokens/S/
Properties of the refresh token
dot_inline_dotgraph_124.png

Retrieving the value is denied if not administrative user

This object contains the following items:

expiry_timeExpiry time, if any
remaining_use_countRemaining 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+"/"});

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
dot_inline_dotgraph_125.png

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 nullIndefiniteThe token stays valid for an indefinite time
numberExpiry timeThe 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"

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
dot_inline_dotgraph_126.png

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 nullIndefiniteThe token may be used any number of times
numberRemaining use countThe 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

Browse more samples

Client: Access tokens

mapauth/clients/S/access_tokens/
Tokens that can be used to access the scopes
dot_inline_dotgraph_127.png

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

Browse more samples

Token properties

objectauth/clients/S/access_tokens/S/
Properties of the access token
dot_inline_dotgraph_128.png

Retrieving the value is denied if not administrative user

This object contains the following items:

expiry_timeExpiry time, if any
remaining_use_countRemaining 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}});

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
dot_inline_dotgraph_129.png

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 nullIndefiniteThe token stays valid for an indefinite time
numberExpiry timeThe 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

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
dot_inline_dotgraph_130.png

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 nullIndefiniteThe token may be used any number of times
numberRemaining use countThe 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/"

Browse more samples

Realm

stringauth/realm/
The realm to be announced in authentication responses
dot_inline_dotgraph_131.png

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"

[]

Browse more samples

Cookie timeout

numberauth/cookie_timeout/
The amount of time for which a cookie is valid
dot_inline_dotgraph_132.png

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

Browse more samples

Notifications

objectauth/notifications/
Authentication-related notifications
dot_inline_dotgraph_133.png

Retrieving the value is denied if not administrative user

This object does not support direct modification.

This object contains the following items:

parameter_kindsParameter kinds
eventsEvents

Sample CLI read command:

uom get "auth/notifications"

...

Sample uom library read command:

print(uom.dump(uom.auth.notifications))

<...>

Browse more samples

See also Notifications: Parameter kinds

Events

mapauth/notifications/events/
Event templates
dot_inline_dotgraph_134.png

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

<...>

Browse more samples

See also Events: Event

Notifications: Parameter kinds

objectauth/notifications/parameter_kinds/
Kinds of event parameters

This object does not correspond to an actual resource.

This object contains the following items:

auth_loginUsername
auth_client_nameClient name
auth_client_idClient identifier
auth_ipIP address
auth_methodMethod
auth_reasonReason
auth_allowedAuthentication allowed
user_stateUser state

Username

stringauth/notifications/parameter_kinds/auth_login/
The name of the user

Client name

stringauth/notifications/parameter_kinds/auth_client_name/
The name of the client

Client identifier

stringauth/notifications/parameter_kinds/auth_client_id/
The identifier of the client

IP address

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

stringauth/notifications/parameter_kinds/auth_method/
The authentication method

Reason

stringauth/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 trueAllowedThe user is allowed to log in
constant falseDeniedThe 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 trueExistingThe user exists
constant falseDeletedThe user has been deleted
constant "new"NewThe user has been created

Event parameters: Event parameter

objectauth/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:

idIdentifier
has_fixed_valueFixed value flag
fixed_valueFixed 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"}

Browse more samples

Identifier

stringauth/notifications/events/S/parameters/N/id/
Parameter identifier
dot_inline_dotgraph_135.png

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'

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
dot_inline_dotgraph_136.png

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 trueFixedThe value is fixed
constant falseVariableThe 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

Browse more samples

Fixed value

sum (variant)auth/notifications/events/S/parameters/N/fixed_value/
Fixed parameter value for this particular event
dot_inline_dotgraph_137.png

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 nullNullNull
constant trueTrueTrue
constant falseFalseFalse
stringStringThis string
numberNumberThis 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"

Browse more samples

Events: Event

objectauth/notifications/events/S/
Event template
dot_inline_dotgraph_138.png

This object is a part of a composite value which is modified as a whole.

This object contains the following items:

message_templateMessage template
severitySeverity
parametersEvent 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/"

Browse more samples

Message template

arrayauth/notifications/events/S/message_template/
Template for human-readable message generation
dot_inline_dotgraph_139.png

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]

Browse more samples

Message template element

sum (variant)auth/notifications/events/S/message_template/N/
Element of human-readable message template
dot_inline_dotgraph_140.png

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:

stringStringFixed string
numberParameterIndex of message parameter to insertevent 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 "

Browse more samples

Severity

sum (enumerated number)auth/notifications/events/S/severity/
Severity rating assigned to the event
dot_inline_dotgraph_141.png

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 1EmergencyTreat the event as an emergency
constant 2AlertTreat the event as an alert
constant 3CriticalTreat the event as critical
constant 4ErrorTreat the event as an error
constant 5WarningTreat the event as a warning
constant 6NoticeTreat the event as a notice
constant 7InformationalTreat the event as informational
constant 8DebugTreat 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

Browse more samples

Event parameters

arrayauth/notifications/events/S/parameters/
Additional data associated with the event
dot_inline_dotgraph_142.png

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

Browse more samples

See also Event parameters: Event parameter