Service Help – UserLogon
The Sharperlight service offers a wide variety of presentation methods, each with its own set of parameters.
In this post, we will introduce the following method from among the various presentation methods available.
http://abcd.com/mdService1Rest/UserLogon/…
{sharperlight service url}/Help#UserLogon
|
After the user logon details have been entered the page is redirected to the url specified. An user session id e.g. usid=64919ad6e54348a4925faee2146e1b60Z is appended to the redirect url by default but this can be suppressed Note: This should not be used if the Service is setup for NTLM or Windows Authentication as the browser will Sign in the user and pass the details on the header |
|
| title=[text] | Override the default Title of logon page |
| language=[languageCode] | Override the default language e.g. &language=ja |
| redirect=[url] |
After the user has logged on the user will be redirected to this url address.
The url is always encoded as FromBase64String then zip memory compressed |
| redirectBase64=[url] |
After the user has logged on the user will be redirected to this url address.
The url is always encoded as FromBase64String |
| redirectSimple=[url] |
After the user has logged on the user will be redirected to this url address.
The url is not encoded except for the url char protection e.g space is %20 etc |
| appendUsid=[1|0] | Enable or disable logic to append user session id to the redirect url |
| *** Custom Header *** |
Import your own custom CSS styling and Javascript into the html page head section of the User Logon html from the Service MetaData Custom Folder Create the file UserLogonHeader.html under the MetaData folder on the Server and it’s contents will be included. The DataModel folder can be found in \ProgramData\Sharperlight\MetaData. Note Instances have their own MetaData folder Any SharperLight special variables tags like {_rootURL} will be resolved PRIMARY INSTANCE C:\ProgramData\SharperLight\MetaData\Custom\UserLogonHeader.html
INSTANCE 123f
C:\ProgramData\SharperLight\Instance\123f\MetaData\Custom\UserLogonHeader.html
EXAMPLE OF THE FILE CONTENT
<img src=’File/Custom/sharperlight.png’>
FAVICON To change the web page favicon.ico icon you create add a file called favicon.icon on the app Server with this path A Service Restart is required before the new icon will take affect. Also you may have to clear the browser cache. PRIMARY INSTANCE
C:\ProgramData\SharperLight\MetaData\Custom\favicon.ico
C:\ProgramData\SharperLight\Instance\123f\MetaData\Custom\favicon.ico |
| *** Custom Body *** |
Import your own custom HTML, CSS styling and Javascript into the body section of the User Logon html from the Service MetaData Custom Folder Create the folder custom and the file UserLogonBody.html under the Metadata folder on the Server and it’s contents will be included. The DataModel folder can be found in \ProgramData\Sharperlight\MetaData. Note Instances have their own MetaData folder Any SharperLight special variables tags like {_rootURL} will be resolved PRIMARY INSTANCE
C:\ProgramData\SharperLight\MetaData\Custom\UserLogonBody.html
C:\ProgramData\SharperLight\Instance\123f\MetaData\Custom\UserLogonBody.html EXAMPLE OF THE FILE CONTENT
<style>
h2 { background-color: #740a0a; background-image: none; color: white; } <style> |
| options=[create|createanyone|delete|reset|change|pwdchange|2fachange] |
Override the normal User Logon display to focus on just one aspect like the reseting of passwords for example.
If the service has the flag enabled to allow users to maintain their own accounts then you can create an new account with &options=create To show password change and Two Factor Authentication details use &options=change To show password change only use &options=pwdchange To show Two Factor Authentication only use &options=2fachange To show both change and reset password details use &options=change+reset |