This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Publishing a XACML Policy

Before you begin

Before publishing a XACML policy to the Policy Decision Point (PDP), you need to create the policy first. For more information on how to create a XACML policy, see Creating a XACML Policy.

In order to use a XACML policy for authorization in WSO2 Identity Server, you need to publish it to the Policy Decision Point (PDP) where the authorization decision is made. The policy will not be enforced unless it is published.

At the point of publishing the policy, the policy in the Policy Administration Point(PAP) policy store will sync up with PDP policy store. The PDP will access one or more policies in the Policy Administration Point(PAP), and other additional information such as subject, resource, action and environmental resources in the Policy Information Point(PIP) to make the decision. For more information about this process, see XACML system architecture

You can publish a XACML policy to PDP for runtime evaluation using the instructions in this topic.

  1. Sign in. Enter your username and password to log on to the Management Console.
  2. Navigate to the Main menu to access the Entitlement menu. Click Policy Administration under PAP.
    1. The policies that you created are listed in the Available Entitlement Policies table. 
    2. You can publish policies using one of the following options.
      1. Click Publish to My PDP next to the policy you wish to publish - This will publish the specific policy to PDP.
      2. Select the specific policies you wish to publish using the checkboxes available and click Publish This will allow us to publish multiple policies at the same time to the PDP. 
      3. Click Publish All to publish all the available policies - This will publish all the policies available in the "Available Entitlement Policy" to the PDP 
    3. The Publish Policy page appears.
    4. Here you can do the following by clicking on an option from each section.
      1. Select policy publishing action.

        ActionDiscription
        Add PolicyThe target action of the policy is "CREATE". This option works only for the initial policy publishing process. The policy is published to the PDP and can be viewed by navigating to PDP>Policy View.
        Update PolicyThe target action of the policy is "UPDATE". This option updates an existing policy that has already been published to the PDP. The existing policy listed in the Policy View will be updated.
        Order Policy

        The target action of the policy is "ORDER". This option is used to put the existing published policies in order. The policies will be ordered in descending order in the Policy View.

        This is notrelevantforthe initial policy publishing process.

        Enable Policy

        The target action of the policy is "ENABLE". This option enables the policy in the PDP. 

        This is notrelevantforthe initial policy publishing process. 

        Disable Policy

        The target action of the policy is "DISABLE". This option disables the policy in the PDP.

        This is notrelevantforthe initial policy publishing process.

        Delete PolicyThe target action of the policy is "DELETE". This option deletes an existing published policy in the PDP. The relevant policy will be removed from the Policy View in the PDP.
      2. Select policy Enable/Disable.
        • Publish As Enabled Policy - Allows you to enable the policy to be published. This is available by default when publishing to PDP.
        • Publish As Disabled Policy - Allows you to disable the policy to be published.
      3. Select policy order.
        • Use default policy order - Sets the default order of a policy as "0".
        • Define policy order - Allows you to set a policy order according to your preference. 
  3. Click Publish.
  4. Once you publish, you can see published policies in the Policy View in the Entitlement menu under PDP.

  5. By clicking "Edit Order"(2), you can edit the order of the policy and the order will be displayed in the policy view(1).
      When you have multiple policies published, you can select a policy combining algorithm from(3) and click "Update".

When you have multiple ordered policies, the least order will evaluate first and the policies will evaluate in the ascending order of the order number(priority). When the priority is high, the order number is low.

For further details on Policy Combining algorithms read the below section here.