OneLogin
  • 30 Jan 2024
  • 2 Minutes to read
  • Contributors

    OneLogin


      Article Summary

      Introduction

      This article outlines the steps to configure Auth0 as an identity provider.

      By integrating with Auth0, Harmony SASE can authenticate users seamlessly, leveraging the capabilities of the Security Assertion Markup Language (SAML) protocol.


      Steps

      1. Log in to your OneLogin account. If you don't already have one, you will need to create one.
      2. Select Apps and then Add Apps.
        httpsfilesreadmeio7ba1605-onelogin-add-app.png
      3. Search for saml, and select SAML Test Connector (IdP w/attr).
        httpsfilesreadmeio5037520-onelogin-search-app.png
      4. Change the Display Name to Harmony SASE. Select Save.
        httpsfilesreadmeio0bce989-onelogin-save-app.png
      5. Go to the SSO tab, and copy the values for SAML 2.0 Endpoint (HTTP) and SLO Endpoint (HTTP).
      6. Select the View Details link at the X.509 Certificate field.
        httpsfilesreadmeioe97de03-onelogin-copy-values.png
      7. Download the X.509 certificate onelogin.pem.
        httpsfilesreadmeio52c7389-onelogin-download-cert.png
      8. Go back to the Configuration tab.
      9. Enter the following values into the appropriate fields:

      httpsfilesreadmeiofdcb36c-onelogin-set-values.png
      10. On the Parameters tab, select Add Parameter.
      httpsfilesreadmeioc6a695c-custom-attr-01.png
      11. In the popup, set a name for your new custom attribute using the Field name text box. Make sure you check the Include in the SAML assertion flag. Select Save.
      12. The new attribute you created is displayed. Select the Value field, which is currently displaying - No default.
      13. Select the Value dropdown menu and select Macro.
      14. Add the following set of properties:

      • Field Name: email, Macro text box value: {email}, SAML assertion flag: Checked

      • Field Name: given_name, Macro text box value: {firstname}, SAML assertion flag: Checked

      • Field Name: family_name, Macro text box value: {lastname}, SAML assertion flag: Checked

      httpsfilesreadmeio3bce951-custom-attr-03.png
      At this point, we're ready to configure Harmony SASE.

      Configuring Harmony SASE

      1. Log in to your Harmony SASE Management Platform, and navigate to Settings and then IdentityProviders.
        360008599540addprovider1.png
      2. Select + Add Provider.
      3. Choose SAML 2.0 Identity Providers.
      4. Fill Sign In URL, Signing Certificate as follows:
      • The SAML 2.0 Endpoint (HTTP) value you saved above into the Sign In URL field

      • The SLO Endpoint (HTTP) value into the Sign Out URL field.

      • Finally, upload the onelogin.pem certificate using Upload Certificate.

      1. Select Done.
        360007808859okta-addonp81.png

      Recommendations

      • Always replace placeholders like {{WORKSPACE}} with the appropriate values during setup.
      • Ensure that the correct attributes are mapped in OneLogin for accurate user authentication and authorization in Harmony SASE.
      • Periodically review your OneLogin 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


      Was this article helpful?