Configuring PingOne for the Financial Services solution

Verify that your PingOne environment has the necessary configuration to run the Financial Services solution and enable all the features that you want to use.

About this task

These steps ensure that the PingOne configuration is correct and enable features such as magic links, agreements, and social sign-on.

Steps

Verify that you have an email server configured in PingOne.

Learn more about email servers in Configuring Trusted Email Addresses in the PingOne documentation.
1. Go to Settings > Sender.
2. Click the Pencil icon.
3. On the Email tab, in the Email Sender section, click Ping Server.
4. In the Domain list, select your trusted email domain.
5. Enter the sender details:
  
  From Name: Enter the name that appears as the sender’s name in the email message.
  
  From Address: Select an email address in the list, or click New to open the New Address page and create a new address.
6. Enter the reply-to details:
  
  Reply-To Name: Enter the name that appears as the reply-to name in the email message.
  
  Reply-To Address: Select an email address in the list, or click New to open the New Address page and create a new address.
7. Click Save.

Create or verify the required pre-generated notification templates in your PingOne environment.

Learn more about adding and customizing notification templates in Adding a notification and Editing a notification in the PingOne documentation.

Click one of the template links to view the corresponding template in the Ping Library:
Click Copy to copy the template HTML.
In PingOne, go to User Experience > Notification Templates.
Click to create a new template.
In the Type list, select General.
In the Name field, enter the template’s name as it is displayed on the Ping Library page.
Click Create.

In the Email section, in the Subject field, click the Pencil icon and enter a subject corresponding to the template:

Notification Template	Subject
Account Disabled	Critical security alert
Magic Link Authentication	Magic link authentication
New Device Sign-in Activity	Security alert
Password Changed	Password change
Suspicious Activity	Security alert

Notification Template

Subject

Account Disabled

Critical security alert

Magic Link Authentication

Magic link authentication

New Device Sign-in Activity

Security alert

Password Changed

Password change

Suspicious Activity

Security alert

Click the icon to save the subject changes.
Click the Edit icon in the New Email field, then paste the template HTML you copied in step b.
Click the Save icon to save the field changes.
Click the X icon to close the template.
Repeat steps a - l for each remaining template.

Create the Money Transfer/Payment Request template:

In PingOne, go to User Experience > Notification Templates.
Click to create a new template.
In the Type list, select General.
In the Name field, enter Money Transfer/Payment Request.
Click Create.
In the Subject field, configure a subject:
1. Click the Pencil icon.
2. Enter the subject Action Required: ${flowType} Request.
3. Click the icon.

In the New Email field, configure the message body:

Click the Pencil icon.

Enter a body for the new transaction message. For example:

<div style="display: block; width: 400px; margin: 0 auto; font-family: sans-serif; padding: 30px 20px; text-align: center;">
    <img src="https://assets.pingone.com/ux/ui-library/5.0.2/images/logo-pingidentity.png" alt="Company Logo" style="height: 65px; margin-bottom: 10px" />
    <h1>${flowType} Request</h1>
    <div style="margin-top: 20px; margin-bottom:25px; text-align:left">
        <p> A request for ${flowType} of ${currency}${amount} from ${moneyFrom} to ${moneyTo} has been made. If this wasn't you, do not approve this ${flowType} and change your password.</p>
        <p>
            <a href=${magicLink}>
                <button style="color: #fff; background-color: #007bff;
border: 1px solid transparent; padding: .375rem
.75rem; border-radius: .25rem ">Approve ${flowType}</button>
            </a>
        </p>
    </div>
</div>

Click the icon.

Click X to close the template.

Update the content of the existing New Device Paired notification template:
1. Open the New Device Paired template entry in the Ping Library.
2. Click Copy to copy the template HTML.
3. In PingOne, go to User Experience > Notification Templates.
4. Find the New Device Paired notification template and click ⋮ > Edit.
5. In the New Email field, click the Pencil icon, then paste the template HTML you copied in step b.
6. Click the Save icon to save the field changes.
7. Click the X icon to close the template.
Verify that you have a multi-factor authentication (MFA) policy configured in PingOne.

Learn more in the PingOne MFA policies documentation.
1. In PingOne, go to Authentication > MFA.
2. Click the MFA policy marked as the default and verify that its Allowed Authentication Methods include the authentication methods that you want to use from the following:
  - Email
  - SMS
  - FIDO2
  - Voice
  - TOTP
  - Mobile
Verify that the default population exists:
1. Go to Directory > Populations.
2. In the list of populations, verify that a population is marked as Default.
3. If no existing population is marked as Default, select a population and go to More options ( ) > Edit Population.
4. Click Make Default Population.
5. Click Switch.
6. Click Save.

Add the attributes required for the solution.

These attributes must be populated for the Financial Services to function correctly.

Go to Directory > User Attributes.
Click the icon.
Click Declared.
Click Next.

Enter the information for one of the following attributes:

Name Display Name Description

Name	Display Name	Description
`minPaymentLimit`	`minPaymentLimit`	The user’s minimum payment size.
`maxPaymentLimit`	`maxPaymentLimit`	The user’s maximum payment size.
`currency`	`currency`	The currency symbol for the user’s locale.
`userPaymentOnline`	`userPaymentOnline`	Indicates whether online transactions are enabled or disabled.
`userPaymentThreshold`	`userPaymentThreshold`	A threshold above which approval is required for transfer and payment.
`userPaymentLimit`	`userPaymentLimit`	A limit above which online payment or transfer requests are denied.
`checkingBalance`	`checkingBalance`	The user’s checking account balance.
`savingsBalance`	`savingsBalance`	The user’s savings account balance.
`accountVisibility`	`accountVisibility`	Contains user preferences for sharing data with third parties.
`mortgageAccount`	`mortgageAccount`	Contains user mortgage account data including balance and account number.
`creditCardAccount`	`creditCardAccount`	Contains user credit card data including balance and account number.

minPaymentLimit

The user’s minimum payment size.

maxPaymentLimit

The user’s maximum payment size.

currency

The currency symbol for the user’s locale.

userPaymentOnline

Indicates whether online transactions are enabled or disabled.

userPaymentThreshold

A threshold above which approval is required for transfer and payment.

userPaymentLimit

A limit above which online payment or transfer requests are denied.

checkingBalance

The user’s checking account balance.

savingsBalance

The user’s savings account balance.

accountVisibility

Contains user preferences for sharing data with third parties.

mortgageAccount

Contains user mortgage account data including balance and account number.

creditCardAccount

Contains user credit card data including balance and account number.

Click Save.
Repeat steps b - f for each remaining attribute.
Populate these attributes with values for each user. Learn more in the PingOne User Attribute documentation.

(Optional) If you plan to use PingOne Protect and you don’t want to use the default risk policy, create a new risk policy according to the PingOne Protect documentation.
Create a PingOne Authorize policy:
1. Go to Authorization > Policies.
2. Click the Plus icon and select Add Policy.
3. In the Name field, enter Payment checks.
4. Add a maximum payment rule:
  1. Click + Add Rule.
  2. In the Name field, enter Deny payments over maximum payment limit.
  3. In the hamburger menu, click Add "Applies When".
  4. In the Applies When section, click Comparison, then enter the parameters Amount, Greater Than, and PingOne.User.userPaymentLimit.
  5. In the Effect list, select Deny.
  6. Click Save Changes.
5. Add a rule to allow payments between the minimum and the maximum threshold:
  1. Click + Add Rule.
  2. In the Name field, enter Permit payment more than minimum payment limit and less than threshold limit.
  3. In the hamburger menu, click Add "Applies When".
  4. In the Applies When section, click Comparison, then enter the parameters Amount, Greater Than, and PingOne.User.userPaymentThreshold.
  5. In the Applies When section, click Comparison, then enter the parameters Amount, Less Than or Equal, and PingOne.User.userPaymentLimit.
  6. In the Effect list, select Permit.
  7. Click Save Changes.
6. Add a maximum payment rule:
  1. Click + Add Rule.
  2. In the Name field, enter Require approval for payment more than payment threshold limit.
  3. In the hamburger menu, click Add "Applies When".
  4. In the Applies When section, click Comparison, then enter the parameters Amount, Less Than or Equal, and PingOne.User.userPaymentThreshold.
  5. In the Effect list, select Permit.
  6. Click + Add Statement.
  7. In the Name field, enter Approval required when amount more than threshold limit.
  8. Click Save Changes.
Add the transaction amount as an attribute:
1. Go to Authorization > Trust Framework.
2. Click the plus icon and select Add Policy.
3. Click the Attributes tab, then click Create new Attribute.
4. In the Name field, enter Amount.
5. Click Add Resolver and select the Request Parameter resolver type.
6. In the Type list, select Number.
7. Click Save Changes.
(Optional) If you plan to use FIDO2, verify that the default Passkeys policy is selected.

Learn more about FIDO policies in the PingOne FIDO policies documentation.
1. Go to Authentication > FIDO.
2. Verify that the Passkeys policy is set as the default.
3. If the Passkeys policy is not the default, go to ⋮ > Make Default, then click Save.
(Optional) If you plan to use an agreement, verify that you have an agreement configured in PingOne and copy the agreement ID.

Learn more about configuring agreements in Adding an agreement in the PingOne documentation.
1. Go to User Experience > Agreements.
2. Verify that the agreement exists and is enabled.
3. Click the agreement to open the details panel.
4. On the API tab, copy the ID.
The agreement ID is used in a later procedure to configure the flows in DaVinci.
(Optional) Verify that you have an external identity provider (IdP) configured in PingOne for each valid third party you want to use as a social sign-on option.

Learn more about how IdPs are used in PingOne in Identity Providers in the PingOne documentation.
1. If you want to use Google as a social sign-on option, verify that Google is configured as an IdP according to the procedure in Adding an identity provider - Google. During configuration, use the following property mappings:
  
  Google Property PingOne Property
  
  email address
  
  username
  
  email address
  
  email
  
  family name
  
  family name
  
  given name
  
  given name
2. If you want to use Facebook as a social sign-on option, verify that Facebook is configured as an IdP according to the procedure in Adding an identity provider - Facebook. During configuration, use the following property mappings:
  
  Facebook Property PingOne Property
  
  email address
  
  username
  
  email address
  
  email
  
  family name
  
  family name
  
  given name
  
  given name
3. If you want to use Apple as a social sign-on option, verify that Apple is configured as an IdP according to the procedure in Adding an identity provider - Apple. During configuration, use the following property mappings:
  
  Apple Property PingOne Property
  
  email address
  
  username
  
  email address
  
  email