Access Control Policy Templates in AD FS
Active Directory Federation Services now supports the use of access control policy templates. By using access control policy templates, an administrator can enforce policy settings by assigning the policy template to a group of relying parties (RPs). Administrator can also make updates to the policy template and the changes will be applied to the relying parties automatically if there is no user interaction needed.
What are Access Control Policy Templates?
The AD FS core pipeline for policy processing has three phases: authentication, authorization and claim issuance. Currently, AD FS administrators have to configure a policy for each of these phases separately. This also involves understanding the implications of these policies and if these policies have inter-dependency. Also, administrators have to understand the claim rule language and author custom rules to enable some simple/common policy (ex. block external access).
What access control policy templates do is replace this old model where administrators have to configure Issuance Authorization Rules using claims language. The old PowerShell cmdlets of issuance authorization rules still apply but it is mutually exclusive of the new model. Administrators can choose either to use the new model or the old model. The new model allows administrators to control when to grant access, including enforcing multi-factor authentication.
Access control policy templates use a permit model. This means by default, no one has access and that access must be explicitly granted. However, this is not just an all or nothing permit. Administrators can add exceptions to the permit rule. For example, an administrator may wish to grant access based on a specific network by selecting this option and specifying the IP address range. But the administrator may add and exception, for instance, the administrator may add an exception from a specific network and specify that IP address range.
Screenshot that shows where to view the Access Control Policies.
Built-in access control policy templates vs custom access control policy templates
AD FS includes several built-in access control policy templates. These target some common scenarios which have the same set of policy requirements, for example client access policy for Office 365. These templates cannot be modified.
Screenshot that shows the built-in Access Control Policies.
To provide increased flexibility to address your business needs, administrators can create their own access policy templates. These can be modified after creation and changes to custom policy template will apply to all the RPs which are controlled by those policy templates. To add a custom policy template simply click Add Access Control Policy from within AD FS management.
To create a policy template, an administrator needs to first specify under which conditions a request will be authorized for token issuance and/or delegation. Condition and action options are shown in the table below. Conditions in bold can be further configured by the administrator with different or new values. Admin can also specify exceptions if there is any. When a condition is met, a permit action will not be triggered if there is an exception specified and the incoming request matches the condition specified in the exception.
| Permit Users | Except |
|---|---|
| From specific network | From specific networkFrom specific groupsFrom devices with specific trust levelsWith specific claims in the request |
| From specific groups | From specific networkFrom specific groupsFrom devices with specific trust levelsWith specific claims in the request |
| From devices with specific trust levels | From specific networkFrom specific groupsFrom devices with specific trust levelsWith specific claims in the request |
| With specific claims in the request | From specific networkFrom specific groupsFrom devices with specific trust levelsWith specific claims in the request |
| And require multi-factor authentication | From specific networkFrom specific groupsFrom devices with specific trust levelsWith specific claims in the request |
If an administrator selects multiple conditions, they are of AND relationship. Actions are mutually exclusive and for one policy rule you can only choose one action. If admin selects multiple exceptions, they are of an OR relationship. A couple of policy rule examples are shown below:
| Policy | Policy rules |
|---|---|
| Extranet access requires MFAAll users are permitted | Rule #1from extranetand with MFAPermitRule#2from intranetPermit |
| External access are not permitted except non-FTEIntranet access for FTE on workplace joined device are permitted | Rule #1From extranetand from non-FTE groupPermitRule #2from intranetand from workplace joined deviceand from FTE groupPermit |
| Extranet access requires MFA except "service admin"All users are permitted to access | Rule #1from extranetand with MFAPermitExcept service admin group****Rule #2alwaysPermit |
| non-work place joined device accessing from extranet requires MFAPermit AD fabric for intranet and extranet access | Rule #1from intranetAnd from AD Fabric groupPermitRule #2from extranetand from non-workplace joined deviceand from AD Fabric groupand with MFAPermitRule #3from extranetand from workplace joined deviceand from AD Fabric groupPermit |
Parameterized policy template vs non-parameterized policy template
A parameterized policy template is a policy template that has parameters. An Administrator needs to input the value for those parameters when assigning this template to RPs.An administrator cannot make changes to parameterized policy template after it has been created. An example of a parameterized policy is the built-in policy, Permit specific group. Whenever this policy is applied to an RP, this parameter needs to be specified.
Screenshot that shows an example of a parameterized policy template.
A non-parameterized policy template is a policy template that does not have parameters. An administrator can assign this template to RPs without any input needed and can make changes to a non-parameterized policy template after it has been created. An example of this is the built-in policy, Permit everyone and require MFA.
Screenshot that shows an example of a non-parameterized policy template.
How to create a non-parameterized access control policy
To create a non-parameterized access control policy use the following procedure
To create a non-parameterized access control policy
-
From AD FS Management on the left select Access Control Policies and on the right click Add Access Control Policy.
-
Enter a name and a description. For example: Permit users with authenticated devices.
-
Under Permit access if any of the following rules are met, click Add.
-
Under permit, place a check in the box next to from devices with specific trust level
-
At the bottom, select the underlined specific
-
From the window that pops-up, select authenticated from the drop-down. Click Ok.
Screenshot that shows how to select the device trust level.
-
Click Ok. Click Ok.
Screenshot that shows how to accept the policy change.
How to create a parameterized access control policy
To create a parameterized access control policy use the following procedure
To create a parameterized access control policy
-
From AD FS Management on the left select Access Control Policies and on the right click Add Access Control Policy.
-
Enter a name and a description. For example: Permit users with a specific claim.
-
Under Permit access if any of the following rules are met, click Add.
-
Under permit, place a check in the box next to with specific claims in the request
-
At the bottom, select the underlined specific
-
From the window that pops-up, select Parameter specified when the access control policy is assigned. Click Ok.
Screenshot that shows the Parameter specified when the access control policy is assigned option.
-
Click Ok. Click Ok.
Screenshot that shows how to accept the selected option.
How to create a custom access control policy with an exception
To create a access control policy with an exception use the following procedure.
To create a custom access control policy with an exception
-
From AD FS Management on the left select Access Control Policies and on the right click Add Access Control Policy.
-
Enter a name and a description. For example: Permit users with authenticated devices but not managed.
-
Under Permit access if any of the following rules are met, click Add.
-
Under permit, place a check in the box next to from devices with specific trust level
-
At the bottom, select the underlined specific
-
From the window that pops-up, select authenticated from the drop-down. Click Ok.
-
Under except, place a check in the box next to from devices with specific trust level
-
At the bottom under except, select the underlined specific
-
From the window that pops-up, select managed from the drop-down. Click Ok.
-
Click Ok. Click Ok.
Screenshot that shows the Screen Editor dialog box.
How to create a custom access control policy with multiple permit conditions
To create a access control policy with multiple permit conditions use the following procedure
To create a parameterized access control policy
-
From AD FS Management on the left select Access Control Policies and on the right click Add Access Control Policy.
-
Enter a name and a description. For example: Permit users with a specific claim and from specific group.
-
Under Permit access if any of the following rules are met, click Add.
-
Under permit, place a check in the box next to from a specific group and with specific claims in the request
-
At the bottom, select the underlined specific for the first condition, next to groups
-
From the window that pops-up, select Parameter specified when the policy is assigned. Click Ok.
-
At the bottom, select the underlined specific for the second condition, next to claims
-
From the window that pops-up, select Parameter specified when the access control policy is assigned. Click Ok.
-
Click Ok. Click Ok.
access control policies
How to assign an access control policy to a new application
Assigning an access control policy to a new application is pretty straight forward and has now been integrated into the wizard for adding an RP. From the Relying Party Trust Wizard you can select the access control policy that you wish to assign. This is a requirement when creating a new relying party trust.
Screenshot that shows the Choose Access Control Policy screen.
How to assign an access control policy to an existing application
Assigning an access control policy to a existing application simply select the application from Relying Party Trusts and on the right click Edit Access Control Policy.
Screenshot that shows the Retrying Party Trusts application.
From here you can select the access control policy and apply it to the application.
Screenshot that shows how to edit the Access Control Policy.
See Also
Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
