You can set custom organization policy on child nodes, which will overwrite or merge with the inherited policy based on the rules of hierarchy evaluation.
Before you begin
Read the Understanding constraints page to learn about what a constraint is.
Read the overview of the Organization Policy Service to learn about how organization policy works.
In the resource hierarchy diagram below, each node sets a custom organization policy and defines whether it inherits its parent node's policy. The colored shapes represent the values that the organization policy allows or denies.
A Constraint is a definition of the behaviors that are controlled by an organization policy. The Constraint in the above example has a default behavior that allows all values. The nodes below it define custom policies that overwrite this behavior by allowing or denying values.
The effective policy on each node is evaluated based on the rules of inheritance. If a custom organization policy is not set, the node will inherit the default constraint behavior. If you do set an organization policy, your custom policy is used instead. In the above example, the Organization Node defines a policy that allows red square and green circle.
The resource nodes that are in the hierarchy below the Organization Node are evaluated as follows:
Resource 1 defines a custom policy that sets
TRUEand allows blue diamond. The policy from the Organization Node is inherited and merged with the custom policy, and the effective policy evaluates to allow red square, green circle, and blue diamond.
Resource 2 defines a custom policy that sets
TRUEand denies green circle. Deny values always take precedence during policy reconciliation. The policy from the Organization Node is inherited and merged with the custom policy, and the effective policy evaluates to allow only red square.
Resource 3 defines a custom policy that sets
FALSEand allows yellow hexagon. The policy from the Organization Node is not inherited, so the effective policy evaluates to only allow yellow hexagon.
Resource 4 defines a custom policy that sets
FALSEand includes the
restoreDefaultvalue. The policy from the Organization Node is not inherited, and the default constraint behavior is used, so the effective policy evaluates to allow all.
Hierarchy evaluation rules
The following rules govern how an organization policy is evaluated at a given resource. You need the Organization Policy Administrator role to set organization policy.
No organization policy set
If you don't set an organization policy, then a resource node inherits from its parent. If the parent is the organization node or the parent node doesn't have an organization policy, then the default behavior of the constraint is enforced.
A resource node that has an organization policy set by default supersedes any
policy set by its parent nodes in the hierarchy. However, if a resource node has
inheritFromParent = true, then the effective Policy of the parent resource
is inherited, merged, and reconciled to evaluate the resulting effective
policy. For example:
- A folder denies the value
- A project underneath that folder denies the value
The two policies are merged, and in this case result in an effective policy that
If a resource hierarchy node has a policy that includes
inheritFromParent = false, it doesn't inherit the organization policy from
its parent. Instead, the node inherits the constraint's default behavior unless
you set a policy with allowed or denied values.
Reconciling policy conflicts
When a child node inherits organization policies based on
list constraints, the inherited policies
are merged and reconciled with the node's organization policy. In list policy
DENY values always take precedence. For example:
- A folder denies the value
- A project underneath that folder allows the value
The policies are merged and the
DENY value takes precedence. The effective
policy denies all values, and will evaluate the same way whether the parent or
child node denies the value. It's best not to include a value in both the
allowed and denied lists. Doing so can make it harder to understand your
Organization policies that are derived from
boolean constraints do not merge and
reconcile policies. If a policy is specified on a resource node, that
FALSE value is used to determine the effective policy. For example:
A folder sets
A project underneath that folder sets
enforced: true value set on the folder is ignored because
enforced: false is defined on the project itself. The organization policy will
not enforce the constraint for that project.
Reset to default policy
RestoreDefault, the organization policy will use the default
behavior of the constraint for this resource hierarchy node. Child nodes will
also inherit this behavior.