PingAuthorize

Configuring external PDP mode

To configure PingAuthorize Server to use external PDP mode, use the administrative console or dsconfig to create a Policy External Server to represent the Policy Editor, then assign the Policy External Server to the Policy Decision Service and set the PDP mode.

Before you begin

You need the following values to configure PingAuthorize Server to use external PDP mode:

  • The shared secret, which is chosen or generated when you install the Policy Editor.

  • The branch name, which corresponds to the policy branch you want to evaluate requests against in the Policy Editor.

  • The decision node, which is the ID of a node in the policy tree that will be considered first during policy processing. To find the decision node value:

    1. In the Policy Editor, go to Policies.

    2. Select the node that you want to use as the root node.

      This is typically the top-level node of your policy tree.

    3. Click the hamburger menu and select Copy ID to clipboard.

      Screen capture of the Policies tab showing the Copy ID to clipboard option

  • Using the administrative console

  • Using dsconfig

Configuring external PDP mode using the administrative console

Steps

  1. In the PingAuthorize administrative console, go to Configuration → Data Sources → External Servers.

  2. Click New External Server and select Policy External Server from the drop-down menu.

  3. In the New Policy External Server window, specify the following information:

    • Name

    • Base URL

    • Shared Secret

    • Decision Node

    • Branch

Screen capture of the New Policy External Server window with the Name, Base URL, Shared Secret, Decision Node, and Branch fields highlighted. The Save button is in the upper right of the screen.

  1. Click Save.

  2. Go to Authorization and Policies → Policy Decision Service.

  3. In the PDP Mode list, select external.

  4. In the Policy Server list, select the name you gave to the policy external server in step 3.

    Screen capture of the Edit Policy Decision Service window with the PDP Mode and Policy Server lists configured as specified

  5. Click Save To PingAuthorize Server Cluster.

Configuring external PDP mode using dsconfig

Steps

  • Use the dsconfig commands in the following code block to configure external PDP mode:

    dsconfig create-external-server \
  --server-name "{PAP_Name}" \
  --type policy \
  --set "base-url:https://<pap-hostname>:<pap-port>" \
  --set "shared-secret:pingauthorize" \
  --set "branch:Default Policies" \
  --set "decision-node:<your decision node ID value>"

dsconfig set-policy-decision-service-prop \
  --set pdp-mode:external \
  --set "policy-server:{PAP_Name}"