Enables you to implement a mechanism to log the user into the Pega Platform.

An instance of the PegaAuthenticator object is created by calling the authenticator method.

PegaAuthenticator can operate in one of the following two modes, based on the value of the Pega-AppDefinition/authentication_type dynamic system setting. The dynamic system setting can take the following values:


The authentication mechanism attempts to authenticate the user by sending login credentials to the Pega Platform instance.


The authentication mechanism attempts to authenticate the user by sending login credentials to the OAuth2 server, whose address is defined in the Pega-AppDefinition/OAuth2/token_endpoint dynamic system setting. If the credentials are recognized, the OAuth2 server returns an access token that is used as a loginActivity token to login to the Pega Platform server.


All relevant dynamic system settings are set in the Pega Platform and passed to the Pega Mobile Client at application building phase. For details, see Configuring user authentication with Oauth2 tokens.


This object belongs to the Authentication product module.


Name Description Type Use
loginActivity The LoginActivityType enum that defines a login activity used for the selected Pega Platform instance. object optional
url A URL address of the Pega Platform instance that you want to log the user into. You must set a URL for each authenticator instance. Once set, all three methods (logIn, logOff, isLoggedIn) will use the same URL and optionally loginActivity. If you are using the oauth2 mode, you must provide the URL which points to the custom servlet bound to the PRPC Authentication Service which uses OAuth token validation. string required


Name Description

Attempts to authenticate the user.


Logs the user out of the Pega Platform instance and calls the LogOut activity on the server to close the session on the server side.


Verifies if the user is logged in to the Pega Platform instance (in the basic mode) or if the access token is still valid (in oauth2 mode).

Related topics

Legal notice | Copyright © 2018 and Confidential to Pegasystems Inc. All rights reserved
PDN | Feedback