PingOne for Enterprise

Introduction

This article provides a comprehensive guide on how to set up PingOne for Enterprise as an identity provider.

By integrating with PingOne, Harmony SASE can authenticate users using the Security Assertion Markup Language (SAML) protocol, ensuring a secure and streamlined login experience.

Steps

1. Log in to your PingOne for Enterprise account.
2. On the upper toolbar in your PingOne for Enterprise screen select Applications. This takes you to the My Applications screen.
3. Click on SAML. Open the Add Application drop-down and select New SAML Application
   
4. On the pop-up window, fill in the following details:

• Application Name: Harmony SASE
• Application Description: Harmony SASE SAML Connection
• Category: Information Technology
• Graphics: Add the Harmony SASE Logo (Optional)

6. Click Continue to Next Step to proceed.
7. On the Application Configuration window click on I have the SAML configuration.
8. Fill in the following information:

• Signing Certificate: PingOne Account Origination Certificate
• Protocol Version: SAML v 2.0
• Assertion Consumer Service (ACS): https://auth.perimeter81.com/login/callback?connection={{WORKSPACE}}-oc for US based platform or https://auth.eu.sase.checkpoint.com/login/callback?connection={{WORKSPACE}}-oc for EU based platform
• Entity ID: urn:auth0:perimeter81:{{WORKSPACE}}-oc for US based platform or urn:auth0:eu-sase-checkpoint:{{WORKSPACE}}-oc for EU based platform

Note: The workspace should be changed to your Harmony SASE tenant name.

9. Click Continue to Next Step to proceed. 

10. On the SSO Attribute Mapping window, you will need to map the following attributes: | Application Attribute | Identity Bridge Attribute or Literal Value |
| -- | -- |
| email| Email|
| given_name| First Name|
| family_name| Last Name|
| groups| memberOf|

11. Click Continue to Next Step to proceed.

12. On the Group Access window select the user groups that should have access to the PingOne for Enterprise Login Page. To allow access to all users we recommend adding Users@Directory.

13. Click Continue to Next Step to proceed.
14. On the Review Setup window copy the "idpid" and click on the Download link next to Signing Certificate.

15. Click Save and Close.
16. On My Applications screen verify that the Harmony SASE application is set to Enabled - Yes.

Configuring Harmony SASE

You need to configure the integration from the Harmony SASE side.

1. Log in to your Harmony SASE Management Platform, and navigate to Settings and then IdentityProviders.
2. Select + Add Provider.
   
3. Select SAML 2.0 Identity Cloud.
4. Fill in the Sign In URL with the following URL: https://sso.connect.pingidentity.com/sso/idp/SSO.saml2?idpid={{idpid}} (fill in the idpid from step 14).
5. Add your organization domains.
6. Paste the certification from the downloaded idp-signing.crt file (begin and end line included).
   
7. Select Save.

Recommendations

• Always replace placeholders like {{WORKSPACE}} with the appropriate values during setup.
• Ensure that the correct attributes are mapped in PingOne for accurate user authentication and authorization in Harmony SASE.
• Periodically review your PingOne configuration settings to ensure they align with any updates or changes made within the Harmony SASE platform.

Troubleshooting

If you encounter issues during or after the setup, try reviewing your settings to ensure everything matches the instructions. In particular, check the IP addresses and other details you entered during setup. If issues persist, please consult our dedicated support.

Support Contacts

If you have any difficulties or questions, don't hesitate to contact Harmony SASE's support team. We offer 24/7 chat support on our website at Perimeter81.com, or you can email us at support@perimeter81.com. We're here to assist you and ensure your VPN tunnel setup is a success