Child pages
  • Security

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Cache
indextrue
refresh100d
showRefreshtrue
iddoc
titleRefresh page
showDatetrue
retryEnable

servoy sReturnTypes2100%height: 30px;2Supported ClientssWordListSmartClientsWordListWebClientsWordListNGClientsWordListMobileClient

servoy sSummary12%30%58%height: 30px;3Constants SummaryConstant representing the accessible flag for form security.Constant representing the delete flag for table security.Constant representing the insert flag for table security.Constant representing the read flag for table security.Constant representing the tracking flag for table security (tracks sql insert/update/delete).Constant representing the tracking flag for table security (tracks sql select).Constant representing the update flag for table security.Constant representing the viewable flag for form security.

servoy sSummary12%30%58%height: 30px;3Methods SummaryAdds an user to a named group.Authenticate the given credentials against the mobile service solution.Authenticate to the Servoy Server using one of the installed authenticators or the Servoy default authenticator.Authenticate to the Servoy Server using one of the installed authenticators or the Servoy default authenticator.Returns whether form is accessible.Returns whether element from form is accessible.Returns a boolean value for security rights.Returns a boolean value for security rights.Returns a boolean value for security rights.Returns a boolean value for security rights.Returns whether form is viewable.Returns whether element from form is viewable.Changes the groupname of a group.Changes the username of the specified userUID.Returns true if the password for that userUID is correct, else false.Creates a group, returns the groupname (or null when group couldn't be created).Creates a new user, returns new uid (or null when group couldn't be created or user alreay exist).Creates a new user, returns new uid (or null when group couldn't be created or user alreay exist).Deletes a group, returns true if no error was reported.Deletes an user.Returns the client ID.Returns the form elements UUID's as dataset, the one with no name is the form itself.Get all the groups (returns a dataset).Retrieves the username of the currently logged in user on operating system level.Retrieve the tenant value for this Client, this value will be used as the value for all tables that have a column marked as a tenant column.Get all the groups of the current user.Get all the groups for given user UID.Get the current user name (null if not logged in), finds the user name for given user UID if passed as parameter.Get the current user name (null if not logged in), finds the user name for given user UID if passed as parameter.Get the current user UID (null if not logged in); finds the userUID for given user_name if passed as parameter.Get the current user UID (null if not logged in); finds the userUID for given user_name if passed as parameter.Get all the users in the security settings (returns a dataset).Get all the users in the security settings (returns a dataset).Check whatever the current user is part of the specified groupCheck whatever the user specified as parameter is part of the specified group.Login to be able to leave the solution loginForm.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.Removes an user from a group.Set a new password for the given userUID.voidSets the security settings; the entries contained in the given dataset will override those contained in the current security settings.voidSet the tenant value for this Client, this value will be used as the value for all tables that have a column marked as a tenant column.Set a new userUID for the given userUID.

constantservoy sDetail2100%height:30px2Constants DetailsACCESSIBLEname

ACCESSIBLE

dessIndent
Constant representing the accessible flag for form security.
ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRowDELETEname

DELETE

dessIndent
Constant representing the delete flag for table security.
ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
INSERTname

INSERT

dessIndent
Constant representing the insert flag for table security.
ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
READname

READ

dessIndent
Constant representing the read flag for table security.
ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
TRACKINGname

TRACKING

dessIndent
Constant representing the tracking flag for table security (tracks sql insert/update/delete).
ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
TRACKING_VIEWSname

TRACKING_VIEWS

dessIndent
Constant representing the tracking flag for table security (tracks sql select).
ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
UPDATEname

UPDATE

dessIndent
Constant representing the update flag for table security.
ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
VIEWABLEname

VIEWABLE

dessIndent
Constant representing the viewable flag for form security.
ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow

functionservoy sDetail2100%height:30px2Methods DetailsaddUserToGroupname

addUserToGroup(a_userUID, groupName)

dessIndent
Adds an user to a named group.
Note: this method can only be called by an admin.
prs

Parameters

sIndenta_userUIDthe user UID to be addedgroupNamethe group to add to
ret

Returns

sIndent true if added
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRowauthenticatename

authenticate(credentials)

dessIndent
Authenticate the given credentials against the mobile service solution.
It will set the credentials and then do a sync call to the server.
prs

Parameters

sIndentcredentialsarray whose elements are passed as arguments to the authenticator method, in case of servoy built-in authentication this should be [username, password]
ret

Returns

sIndent authentication result from authenticator solution or boolean in case of servoy built-in authentication
clients

Supported Clients

sIndentNGClient,MobileClient
sam

Sample

sIdentjavascript
lastDetailRow
authenticatename

authenticate(authenticator_solution, method)

dessIndent
Authenticate to the Servoy Server using one of the installed authenticators or the Servoy default authenticator.

Note: this method should be called from a login solution.
prs

Parameters

sIndentauthenticator_solutionauthenticator solution installed on the Servoy Server, null for servoy built-in authenticationmethodauthenticator method, null for servoy built-in authentication
ret

Returns

sIndent authentication result from authenticator solution or boolean in case of servoy built-in authentication
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
authenticatename

authenticate(authenticator_solution, method, credentials)

dessIndent
Authenticate to the Servoy Server using one of the installed authenticators or the Servoy default authenticator.

Note: this method should be called from a login solution, once logged in, the authenticate method has no effect.
prs

Parameters

sIndentauthenticator_solutionauthenticator solution installed on the Servoy Server, null for servoy built-in authenticationmethodauthenticator method, null for servoy built-in authenticationcredentialsarray whose elements are passed as arguments to the authenticator method, in case of servoy built-in authentication this should be [username, password]
ret

Returns

sIndent authentication result from authenticator solution or boolean in case of servoy built-in authentication
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
canAccessname

canAccess(formName)

dessIndent
Returns whether form is accessible.

security.canAccess(formName)
prs

Parameters

sIndentformNameform name
ret

Returns

sIndent true if accessible
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
canAccessname

canAccess(formName, elementName)

dessIndent
Returns whether element from form is accessible.

security.canAccess(formName,elementName)
prs

Parameters

sIndentformNameform nameelementNameelement name from specified form
ret

Returns

sIndent true if accessible
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
canDeletename

canDelete(dataSource)

dessIndent
Returns a boolean value for security rights.
prs

Parameters

sIndentdataSourcethe datasource
ret

Returns

sIndent true if allowed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
canInsertname

canInsert(dataSource)

dessIndent
Returns a boolean value for security rights.
prs

Parameters

sIndentdataSourcethe datasource
ret

Returns

sIndent true if allowed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
canReadname

canRead(dataSource)

dessIndent
Returns a boolean value for security rights.
prs

Parameters

sIndentdataSourcethe datasource
ret

Returns

sIndent true if allowed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
canUpdatename

canUpdate(dataSource)

dessIndent
Returns a boolean value for security rights.
prs

Parameters

sIndentdataSourcethe datasource
ret

Returns

sIndent true if allowed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
canViewname

canView(formName)

dessIndent
Returns whether form is viewable.

security.canView(formName)
prs

Parameters

sIndentformNameform name
ret

Returns

sIndent true if viewable
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
canViewname

canView(formName, elementName)

dessIndent
Returns whether element from form is viewable.

security.canView(formName,elementName)
prs

Parameters

sIndentformNameform nameelementNameelement name from specified form
ret

Returns

sIndent true if viewable
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
changeGroupNamename

changeGroupName(oldGroupName, newGroupName)

dessIndent
Changes the groupname of a group.
Note: this method can only be called by an admin.
prs

Parameters

sIndentoldGroupNamethe old namenewGroupNamethe new name
ret

Returns

sIndent true if changed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
changeUserNamename

changeUserName(a_userUID, username)

dessIndent
Changes the username of the specified userUID.
Note: this method can only be called by an admin user or a normal logged in user changing its own userName.
prs

Parameters

sIndenta_userUIDthe userUID to work onusernamethe new username
ret

Returns

sIndent true if changed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
checkPasswordname

checkPassword(a_userUID, password)

dessIndent
Returns true if the password for that userUID is correct, else false.
prs

Parameters

sIndenta_userUIDthe userUID to check the password forpasswordthe new password
ret

Returns

sIndent true if password oke
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
createGroupname

createGroup(groupName)

dessIndent
Creates a group, returns the groupname (or null when group couldn't be created).
Note: this method can only be called by an admin.
prs

Parameters

sIndentgroupNamethe group name to create
ret

Returns

sIndent the created groupname
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
createUsername

createUser(username, password)

dessIndent
Creates a new user, returns new uid (or null when group couldn't be created or user alreay exist).
Note: this method can only be called by an admin.
prs

Parameters

sIndentusernamethe usernamepasswordthe user password
ret

Returns

sIndent the userUID the created userUID, will be same if provided
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
createUsername

createUser(username, password, userUID)

dessIndent
Creates a new user, returns new uid (or null when group couldn't be created or user alreay exist).
Note: this method can only be called by an admin.
prs

Parameters

sIndentusernamethe usernamepasswordthe user passworduserUIDthe user UID to use
ret

Returns

sIndent the userUID the created userUID, will be same if provided
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
deleteGroupname

deleteGroup(groupName)

dessIndent
Deletes a group, returns true if no error was reported.
Note: this method can only be called by an admin.
prs

Parameters

sIndentgroupNamethe name of the group to delete
ret

Returns

sIndent true if deleted
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
deleteUsername

deleteUser(userUID)

dessIndent
Deletes an user. returns true if no error was reported.
Note: this method can only be called by an admin.
prs

Parameters

sIndentuserUIDThe UID of the user to be deleted.
ret

Returns

sIndent true if the user is successfully deleted.
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getClientIDname

getClientID()

dessIndent
Returns the client ID.
ret

Returns

sIndent the clientId as seen on the server admin page
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getElementUUIDsname

getElementUUIDs(formname)

dessIndent
Returns the form elements UUID's as dataset, the one with no name is the form itself.
prs

Parameters

sIndentformnamethe formname to retieve the dataset for
ret

Returns

sIndent dataset with element info
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getGroupsname

getGroups()

dessIndent
Get all the groups (returns a dataset).
first id column is deprecated!, use only the group name column.
ret

Returns

sIndent dataset with all the groups
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getSystemUserNamename

getSystemUserName()

dessIndent
Retrieves the username of the currently logged in user on operating system level.
ret

Returns

sIndent the os user name
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getTenantValuename

getTenantValue()

dessIndent
Retrieve the tenant value for this Client, this value will be used as the value for all tables that have a column marked as a tenant column.
This results in adding a table filter for that table based on that column and the this value.
<p>
 A client with tenant value will only receive databroadcasts from other clients that have no or a common tenant value set
 Be sure to not access or depend on records having different tenant values, as no databroadcasts will be received for those
</p>
ret

Returns

sIndent An array of tenant values for this client.
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getUserGroupsname

getUserGroups()

dessIndent
Get all the groups of the current user.
ret

Returns

sIndent dataset with groupnames
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getUserGroupsname

getUserGroups(userUID)

dessIndent
Get all the groups for given user UID.
prs

Parameters

sIndentuserUIDto retrieve the user groups
ret

Returns

sIndent dataset with groupnames
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getUserNamename

getUserName()

dessIndent
Get the current user name (null if not logged in), finds the user name for given user UID if passed as parameter.
ret

Returns

sIndent the user name
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient,MobileClient
sam

Sample

sIdentjavascript
lastDetailRow
getUserNamename

getUserName(userUID)

dessIndent
Get the current user name (null if not logged in), finds the user name for given user UID if passed as parameter.
prs

Parameters

sIndentuserUIDthe user UID used to retrieve the name
ret

Returns

sIndent the user name
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getUserUIDname

getUserUID()

dessIndent
Get the current user UID (null if not logged in); finds the userUID for given user_name if passed as parameter.
ret

Returns

sIndent the userUID
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getUserUIDname

getUserUID(username)

dessIndent
Get the current user UID (null if not logged in); finds the userUID for given user_name if passed as parameter.
prs

Parameters

sIndentusernamethe username to find the userUID for
ret

Returns

sIndent the userUID
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getUsersname

getUsers()

dessIndent
Get all the users in the security settings (returns a dataset).
ret

Returns

sIndent dataset with all the users
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getUsersname

getUsers(groupName)

dessIndent
Get all the users in the security settings (returns a dataset).
prs

Parameters

sIndentgroupNamethe group to filter on
ret

Returns

sIndent dataset with all the users
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
isUserMemberOfGroupname

isUserMemberOfGroup(groupName)

dessIndent
Check whatever the current user is part of the specified group
prs

Parameters

sIndentgroupNamename of the group to check
ret

Returns

sIndent dataset with groupnames
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
isUserMemberOfGroupname

isUserMemberOfGroup(groupName, userUID)

dessIndent
Check whatever the user specified as parameter is part of the specified group.
prs

Parameters

sIndentgroupNamename of the group to checkuserUIDUID of the user to check
ret

Returns

sIndent dataset with groupnames
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
loginname

login(username, a_userUID, groups)

dessIndent
Login to be able to leave the solution loginForm.

Example: Group names may be received from LDAP (Lightweight Directory Access Protocol) - a standard protocol used in web browsers and email applications to enable lookup queries that access a directory listing.
prs

Parameters

sIndentusernamethe username, like
'JamesWebb'a_userUIDthe user UID to process login forgroupsthe groups arrayret

Returns

sIndent'JamesWebb'a_userUIDthe user UID to process login forgroupsthe groups arrayret

Returns

sIndent true if loggedin
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
logoutname

logout()

dessIndent
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient,MobileClient
sam

Sample

sIdentjavascript
lastDetailRow
logoutname

logout(solutionToLoad)

dessIndent
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
prs

Parameters

sIndentsolutionToLoadthe solution to load after logout
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
,MobileClientsam

Sample

sIdentjavascript
lastDetailRow
logoutname

logout(solutionToLoad, argument)

dessIndent
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
prs

Parameters

sIndentsolutionToLoadthe solution to load after logoutargumentthe argument to pass to the (login) solution onOpen
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
logoutname

logout(solutionToLoad, method)

dessIndent
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
prs

Parameters

sIndentsolutionToLoadthe solution to load after logoutmethodthe method to run in the solution to load
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
logoutname

logout(solutionToLoad, method, argument)

dessIndent
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
prs

Parameters

sIndentsolutionToLoadthe solution to load after logoutmethodthe method to run in the solution to loadargumentthe argument to pass to the method to run
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
removeUserFromGroupname

removeUserFromGroup(a_userUID, groupName)

dessIndent
Removes an user from a group.
Note: this method can only be called by an admin.
prs

Parameters

sIndenta_userUIDthe user UID to be removedgroupNamethe group to remove from
ret

Returns

sIndent true if removed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
setPasswordname

setPassword(a_userUID, password)

dessIndent
Set a new password for the given userUID.
Note: this method can only be called by an admin user or a normal logged in user changing its own password.
prs

Parameters

sIndenta_userUIDthe userUID to set the new password forpasswordthe new password
ret

Returns

sIndent true if changed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
setSecuritySettingsname

setSecuritySettings(dataset)

dessIndent
Sets the security settings; the entries contained in the given dataset will override those contained in the current security settings.

NOTE: The security.getElementUUIDs and security.setSecuritySettings functions can be used to define custom security that overrides Servoy security.
For additional information see the function security.getElementUUIDs.
prs

Parameters

sIndentdatasetthe dataset with security settings
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
setTenantValuename

setTenantValue(value)

dessIndent
Set the tenant value for this Client, this value will be used as the value for all tables that have a column marked as a tenant column.
This results in adding a table filter for that table based on that column and the this value.
<p>
This value will be auto filled in for all the columns that are marked as a tenant column. If you give an array of values then the first array value is used for this.
</p>
<p>
 When a tenant value is set the client will only receive databroadcasts from other clients that have no or a common tenant value set
 Be sure to not access or depend on records having different tenant values, as no databroadcasts will be received for those
</p>
prs

Parameters

sIndentvaluea single tenant value or an array of tenant values to filter tables having a column flagged as Tenant column by.
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
setUserUIDname

setUserUID(a_userUID, newUserUID)

dessIndent
Set a new userUID for the given userUID.
Note: this method can only be called by an admin.
prs

Parameters

sIndenta_userUIDthe userUID to set the new user UID fornewUserUIDthe new user UID
ret

Returns

sIndent true if changed
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow