SecurityManager.updateLoggedOnUser

If the user identified by userId is currently logged on, the specific System Logon Service identified by parameter webServiceName is invoked and all sessions where the user is logged on are updated; if the user is not currently logged on no action is taken.

This function is intended to be used to update roles and/or credentials of logged on users without the need for the user to re-logon. It cannot be used to logoff a user or to change their userid. Also there is no point in repeating userid/password validation in the Logon Service as no action can be taken as a result.

Further documentation.

Javascript example:

 try {
   system.securityManager.updateLoggedOnUser( "testLogonService", fields.USER.value, [
          ["Update", fields.USER.value] 
         ] );
 }
 catch (e) {
   event.owner.addErrorMessage(e.javaException.message);
 }