You're currently browsing the Ignition 8.0 docs. Click here to view the latest docs.

This function is used in Python Scripting.


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. 

Be advised that this function should not be used in the same script, or in the same triggering event as system.perspective.logout. Logging in and Logging out should always triggered by separate events altogether. 


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


  • Scope

Perspective Session

Code Examples
Force Authentication
# When forceAuth is True, the user will always be required to type in their credentials, even if they're already logged in. 

system perspective login, perspective.login

  • No labels