Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip
titleBefore 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 will be is "CREATEDCREATE". The This option works only for the initial policy publishing process. The policy will be is published to the PDP and view in the "Policy View" under PDPcan be viewed by navigating to PDP>Policy View.
        Update PolicyThe The target action of  of the policy will be is "UPDATE". This can be used to update a policy which is already published to option updates an existing policy that has already been published to the PDP. The existing policy which is listed in "the Policy View" will  will be updated.
        Order Policy

        The target action of the policy

        will be

        is "ORDER". This

        does not work for the initial policy publishing process. This can be

        option is used to put the existing published policies in order.

        These

        The policies will be ordered in descending order in

        the "

        the Policy View

        "

        .

        This is notrelevantforthe initial policy publishing process.

        Enable Policy

        The target action of the policy will be is "ENABLE". This does not work for the option enables the policy in the PDP. 

        Image Added

        This is notrelevantforthe initial policy publishing process. This will enable the policy to the PDP. You can display that in the action column of the "Policy View". Image Removed 

        Disable Policy

        The target action of the policy will be is "DISABLE". This does not work for the initial policy publishing process. This will disable the policy to the PDP. You can display that in the action column of the "Policy View".

        Image Removed

        option disables the policy in the PDP.

        Image Added

        This is notrelevantforthe initial policy publishing process.

        Delete PolicyThe target action of the policy will be is "DELETE". This can be used to delete option deletes an existing published policy in the PDP. The relevant policy will be removed from the "the Policy View" in  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).
    Image Added  When you have multiple policies published, you can select a policy combining algorithm from(3) and click "Update".

Info

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.

Info

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