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 lot
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.
Removed the "recommended" approach, since it doesn't seem to address the actual use case. Waiting to hear back from dev before we add something back.
The recommend approach to logging out a user, and then quickly logging in as different user, is to set the
forceAuth parameter to "True" on the system.perspective.login function.