%CSP.Login
class %CSP.Login extends %CSP.Page
Provide a default login and security-token pages for CSP applications. User can override the look of this page by creating a subclass and overriding the DrawTitle method and the LOGINTITLE and LOGO parameters.CORS processing for CSP pages that do not inherit from %CSP.REST is also provided here. To turn on CORS assign the application's login page to be a subclass %CSP.Login that has the HandleCorsRequest parameter = 1. In addition, OnHandleCorsRequest and/or OnHandleOptionsRequest methods may be overridden in order to override the default behavior for the application.
Method Inventory
- DrawCSS3STYLE()
- DrawHEAD()
- DrawSTHEAD()
- DrawSTTitle()
- DrawSTYLE()
- DrawTitle()
- DrawTitleSection()
- OnErrorSetup()
- OnHandleCorsRequest()
- OnHandleOptionsRequest()
- OnLoginPage()
- OnPage()
- OnPreHTTP()
- OnSecurityTokenPage()
- SupportedVerbs()
Parameters
parameter DOMAIN = %UtilityLogin;
Login page localization domain
parameter HandleCorsRequest;
This parameter influences the CORS support for the CSP application that has this login page assigned.
If set to true (1) then CORS processing is ON. Otherwise CORS processing is OFF.
parameter LOGINTITLE = Login Page;
Title displayed for login page.
Users can override this value to customize the login page.
Users can override this value to customize the login page.
parameter LOGO;
Corporate logo displayed in standard title.
No longer used.
No longer used.
parameter STYLESHEET;
Name of stylesheet used for login page.
Not used by default page: styles come from the DrawSTYLE method.
Not used by default page: styles come from the DrawSTYLE method.
Methods
classmethod DrawCSS3STYLE()
Draw the style definitions for the login page.
Users can override this method to customize the login page.
Users can override this method to customize the login page.
classmethod DrawHEAD(pTitle="")
Draw the HEAD section of the login page.
Users can override this method to customize the login page.
Users can override this method to customize the login page.
classmethod DrawSTHEAD()
Draw the HEAD section of the security token page.
Users can override this method to customize the security token page.
Users can override this method to customize the security token page.
classmethod DrawSTTitle(pTitle As %String)
Draw the title section of the security token page.
pTitle is the title for the page.
Users can override this method to customize the security token page.
pTitle is the title for the page.
Users can override this method to customize the security token page.
classmethod DrawSTYLE()
Draw the style definitions for the login page.
Users can override this method to customize the login page.
Users can override this method to customize the login page.
classmethod DrawTitle(pTitle As %String)
Draw the title section of the login page.
pTitle is the title for the page.
Users can override this method to customize the login page.
pTitle is the title for the page.
Users can override this method to customize the login page.
classmethod DrawTitleSection(ByRef msgs As %String)
Draw the title section of the page.
pTitle is the title for the page.
Users can override this method to customize the page title section.
pTitle is the title for the page.
Users can override this method to customize the page title section.
This is called before the OnPreHTTP and will handle the HyperEvents logout issues
It will refresh the main page by default unless a javascript function called
'cspRunServerMethodError' is defined in which case it will call this instead
This is the CORS request handler. User should override this method in their login page
if they don't want the default behavior.
This methods provides handling of the options request for this CSP application.
Note carefully: If authentication is required then this method will be
called before login and as such will have only limited privileges.
classmethod OnLoginPage() as %Status
classmethod OnPage() as %Status
Output the default login page as HTML
classmethod OnPreHTTP() as %Boolean
Determine if we need login CSRF tokens and if so add them.
If a login page subclass overrides this method it should call this implementation
to ensure we set the login CSRF tokens if needed.
classmethod OnSecurityTokenPage() as %Status
By default all methods are supported.
Inherited Members
Inherited Methods
- %ClassIsLatestVersion()
- %ClassName()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %Extends()
- %GetParameter()
- %IsA()
- %New()
- %OriginalNamespace()
- %PackageName()
- %SetModified()
- ConvertParameter()
- Decrypt()
- Encrypt()
- EscapeHTML()
- EscapeURL()
- HyperEventCall()
- HyperEventHead()
- Include()
- InsertHiddenField()
- InsertHiddenFields()
- IsPrivate()
- Link()
- OnHTTPHeader()
- OnPageError()
- OnPostHTTP()
- OnPostHyperEvent()
- OnPreHyperEvent()
- Page()
- QuoteJS()
- RewriteURL()
- ShowError()
- StartTimer()
- StopTimer()
- ThrowError()
- UnescapeHTML()
- UnescapeURL()