system.perspective.login

Triggers a login event that will allow the user to login with the project's configured Identity Provider (IdP). For this function to work, an Identity Provider must be set in Perspective project properties. This is particularly useful when you want it to be possible to start a session without authentication and sign in to access certain restricted features.

Note that calling this function after a user is already logged in will not log out the previous user. 

system.perspective.login([sessionId], [pageId], [forceAuth])

• Parameters

String sessionId - Identifier of the Session to target. If omitted, the current Session will be used automatically. When targeting a different session, then the pageId parameter must be included in the call. [optional]

String pageId - Identifier of the Page to target. If omitted, the current Page will be used automatically. [optional]

Boolean forceAuth- Determines if Ignition should ask the Identity Provider to re-authenticate the user, even if the user is already signed into the Identity Provider. If set to true, then the Identity Provider will ask the user to re-enter their credentials. If set to false, then the Gateway will request that the Identity Provider use the last provided credentials for the session, potentially allowing re-authentication without requiring the user to re-type their credentials. Note that support for this argument is determined by the Identity Provider; the IdP may choose to ignore this request. If this parameter is omitted, then the function will use the re-authentication setting defined under Project Properties. [optional]

• Returns

None

• Scope

Perspective Session

system perspective login, perspective.login