Personalized Portal¶
Personalized Portals provide two access options:
- Personalized Secure Link: A unique, personalized link is provided to identify the context of the link and securely provide access to the relevant information or functionality.
- Personalized OTP: The user is uniquely identified in IFS Cloud using a configurable unique identifier based on the required context. This identifier could be a User ID, Document ID, or another relevant business identifier. An OTP is then sent to the user's configured email address for verification.
How to configure a Personalized OTP app¶
To create an OTP-based app, you need to create two apps:
- Challenge App: This is the login page used to send and verify the OTP. Once the OTP is successfully verified, the user will be redirected to the Protected App.
- Protected App: This is the main application where users can access and view the business data.
Configure Challenge app
To create a new challenge app:
Create a new app:
- Use case: Public Portal
- Add the System provider.
- Add a form for the challenge app input parameters. See below for details.
- Add an action to get the data needed by the challenge app. This action maps to fields in the challenge app input parameters form. See below for details.
- For challenge apps you do NOT configure the authentication settings. You do this in the app you want to protect.
- Make the app live. Only the live version can be used when configuring the authentication settings in a personalized portal.
Add components¶
Note: Refer to the challenge app as an example of how to configure the user interface of the app.
For example:
- Add a component to get the user's sign in details and a button to submit their choice. For the input field(s), you can use UI elements such as text boxes or numbers. The data type is important as the input fields in the protected app must match the data type in the challenge app.
- Add another component with UI elements to let the user enter the OTP challenge and a button to submit it.
You can use display tasks to show and hide the components.
Configure the events to initiate authentication, for example an OnClick event can run the initiate authentication action set.
Action sets and actions for challenge apps¶
Note: Refer to the challenge app for details of the required actions.
Action sets here are used to authenticate the protected apps assigned under any unique identifier. Optionally you can also invoke an OTP challenge.
| initiate authentication | Starts the authentication process by passing the details entered by the user to the protected app. The protected app is configured for authentication and requests the configured provider for the details needed to authenticate. | Action runs when users click the Sign In button. |
| initiate otp challenge | Using the details returned by the protected app, such as the user's communication methods, their phone number, email address and so on, to set up the OTP challenge. | Action runs when users click the Send Passcode or Link button. |
| invoke authentication | Requests that the one-time passcode (for example) entered by the user is validated. If correct, redirects the user to the protected app. | Action runs when users click the Submit or Try Again buttons. |
The Initiate authentication action¶
Note: Refer to the challenge app for details of the required actions.
When creating the initiate authentication action:
- Select the provider type
PublicPortalAuthentication. - Select the provider method as
InitiateAuthentication. In Parameter Mapping assign an optional parameter for each input field.
In the challenge app, there is only one input field for a user id 4. Select the Publish Topic check box. This is needed by the rules and display tasks. Subscribe the topic in the form to make them available to use in rule and display tasks.
The invoke authentication action¶
Note: Refer to the challenge app for details of the required actions.
- Select the provider type
PublicPortalAuthentication. - Select the provider method as
InvokeAuthentication. In the Parameter Mapping assign a suggested parameter to the field that has the one-time passcode entered by the user.
In the challenge app this is the component with the identifier OTP Authentication and a text box for entering the passcode. 4. Select the Publish Topic check box.