PingOne IdP with Salesforce

OPSWAT MetaAccess can be easily integrated with an existing PingOne & Salesforce integration to ensure that a device is compliant with the organization's security policy before it is granted access to Salesforce. This ensures that the device is not only authenticated by the IdP, but also tested for risks and vulnerabilities such as infections or unpatched versions of operating systems, BEFORE it access an organization's cloud services.

To get started with implementing OPSWAT MetaAccess integration to enforce device posture check before granting a device to access Salesforce with PingOne Single Sign On (SSO) service, you need to have SSO set up between PingOne and Salesforce. If you haven't already done so, please follow the instructiosn here to set it up.

You can learn more details for each step here at 3.1.1. How to set it up?

Step 1. Enable Access Control on your MetaAccess account

  1. Login to the MetaAccess console

  2. Navigate to Access Control and then Configurations

  3. Check on the box "Enable access control" and configure a port for the cross-domain API. Note that you must select a port which no applications on endpoints is running.

  4. Click SAVE.

    images/download/attachments/335123/image2018-3-9_13-43-24.png

Step 2. Import Identity Providers and Applications

  1. The next step is importing an PingOne certificate to MetaAccess. This allows MetaAccess to verify users signing though a trusted IdP. Each identity provider has a unique X.509 certificate. Download the PingOne certificate by following these steps:

    1. Login to PingOne as Administrator

    2. Go to Applications dashboard

    3. Select Salesforce application

    4. Click Download on Singning Certificate to download certificate

      images/download/attachments/335123/image2019-7-11_14-30-26.png

  2. Collect Salesforce Login URL

    1. In PingOne, go to Applications page then select the Salesforce app

    2. Copy ACS URL
      images/download/attachments/335123/tempsnip.png

  3. Collect Salesforce Logout URL: you can find this URL inside of Salesforce

    1. Log in to Salesforce

    2. You can find "Logout" link when you click on your name

    3. Right-click Logout link and select "Copy link address" to copy logout URL

      images/download/attachments/335123/image2017-8-30_13-53-19.png

  4. Add the PingOne Identity Provider. If you already have PingOne IdP settings on your MetaAccess account, go to 5 to add Salesforce application.

    1. Login to the MetaAccess console

    2. Navigate to Access Control and then Configurations

    3. On the Identity Providers tab, click "Add New Identity Provider" to add your IdP

    4. Fill in required fields for the Identity Provider

      1. IdP Name: an IdP name, for example: PingOne

      2. IdP Certificate: upload PingOne certificate you downloaded in Step 2.1

        images/download/attachments/335123/image2019-7-11_14-51-37.png

    5. Click Add IDP

    6. Click SAVE

  5. Add the Salesforce application:

    1. Expand the PingOne IdP settings you have just added in Step 2.4 above.

    2. Click Add New Application

    3. Enter required field

      1. Application: application name, for example: Salesforce

      2. IdP Login URL: get IdP SSO login URL from your PingOne account

      3. Application Login URL: application login URL which you have from Step 2.2

      4. Application Logout URL: application logout URL which you have from Step 2.3

      5. Access Mode: pick an access mode you prefer. See details on the access modes at Step 2. Import Identity Providers and Applications

        images/download/attachments/335123/image2019-7-11_14-54-29.png
    4. Click SAVE

  6. After saving your changes sucessfully, click the Setup Instructions button of the Salesforce application you have just added and then copy the URL MetaAccess generated there. This URL is used to replace Salesforce login URL on PingOne in Step 4.

    images/download/attachments/335123/image2019-7-11_15-26-28.png

Note: you can add Salesforce application (step 2.5) when you add PingOne IdP settings.

Step 3. Configure Access Rules

  1. On MetaAccess console, navigate to Access Control and then Configurations

  2. On Access Rules tab, click "ADD NEW RULE" to add a new rule for this application OR you can update existing access rules to add this application

  3. With a new access rule, you need to specify how you would like to block/allow access a device from the application

    1. Rule name: a rule name, for example Block non-compliant devices

    2. Action: Block or Allow

    3. Configure conditions to do the action. Details at Step 3. Configure Access Rules

  4. Click ADD RULE

    images/download/attachments/335123/image2018-3-9_13-55-33.png

Step 4. Update Applications settings on Identity Provider

  1. Login to PingOne

  2. Go to Applications then My Applications

  3. Select Salesforce application and click the Edit button

  4. Click Continue to Next Step

  5. Replace ACS URL with the MetaAccess URL which you got from Step 2.6

    images/download/attachments/335123/image2019-7-11_14-57-9.png

  6. Click Save

Step 5. Configure SSO settings on applications

  1. On MetaAccess console, navigate to Access Control > Configurations

  2. Click Download OPSWAT certificate to download a self-signed certificate MetaAccess generated for your account

    images/download/attachments/335123/image2018-3-5_16-13-57.png

  3. Login to Salesforce as administrator

  4. Navigate to Setup > Security Controls > Single Sign-On Settings, click Edit on the SAML Single Sign-On Settings of the PingOne IdP

    images/download/attachments/335123/image2017-8-30_16-48-46.png

  5. Upload OPSWAT certificate from your MetaAccess account which you downloaded from Step 5.1

  6. Click Save

Step 6: Test your integration

Follow guideline at Step 6: Test your integration to test your integration to verify if it works as your expectation.

DONE! CONGRATULATIONS.