Ensure an exclusionary device code flow policy is considered
Description
Conditional Access Policies can be used to prevent the Device code authentication flow. Device code flow should be permitted only for users that regularly perform duties that explicitly require the use of Device Code to authenticate, such as utilizing Azure with PowerShell.
Rationale
Attackers use Device code flow in phishing attacks and, if successful, results in the attacker gaining access tokens and refresh tokens which are scoped to "user_impersonation", which can perform any action the user has permission to perform.
Impact
Microsoft Entra ID P1 or P2 is required.
This policy should be tested using the Report-only mode before implementation. Without a full and careful understanding of the accounts and personnel who require Device code authentication flow, implementing this policy can block authentication for users and devices who rely on Device code flow. For users and devices that rely on device code flow authentication, more secure alternatives should be implemented wherever possible.
Audit Procedure
Using Azure Portal
- From Azure Home open the Portal menu in the top left and select
Microsoft Entra ID. - Scroll down in the menu on the left and select
Security. - Select on the left side
Conditional Access. - Select
Policies. - Select the policy you wish to audit, then:
- Under
Assignments>Users, review the users and groups for the personnel the policy will apply to. - Under
Assignments>Target resources, review the cloud apps or actions for the systems the policy will apply to. - Under
Conditions>Authentication Flows, review the configuration to ensureDevice code flowis selected. - Under
Access Controls>Grant- Confirm thatBlock accessis selected.
- Under
Expected Result
At least one Conditional Access policy should exist that blocks the Device code authentication flow, targeting all users with appropriate exclusions for emergency access accounts.
Remediation
Remediate from Azure Portal
Part 1 of 2 - Create the policy and enable it in Report-only mode.
- From Azure Home open the portal menu in the top left and select
Microsoft Entra ID. - Scroll down in the menu on the left and select
Security. - Select on the left side
Conditional Access. - Select
Policies. - Click the
+ New policybutton, then: - Provide a name for the policy.
- Under
Assignments, selectUsersthen:- Under
Include, selectAll users. - Under
Exclude, check Users and groups and only select emergency access accounts.
- Under
- Under
Assignments, selectTarget resourcesthen:- Under
Include, selectAll cloud apps. - Leave
Excludeblank unless you have a well defined exception.
- Under
- Under
Conditions>Authentication Flows, set Configure toYesthen:- Select
Device code flow. - Select
Done.
- Select
- Under
Access Controls>Grant, selectBlock Access. - Set
Enable policytoReport-only. - Click
Create.
Allow some time to pass to ensure the sign-in logs capture relevant conditional access events. These events will need to be reviewed to determine if additional considerations are necessary for your organization (e.g. many legitimate use cases of device code authentication are observed).
NOTE: The policy is not yet 'live,' since Report-only is being used to audit the effect of the policy.
Part 2 of 2 - Confirm that the policy is not blocking access that should be granted, then toggle to On.
- With your policy now in report-only mode, return to the Microsoft Entra blade and click on
Sign-in logs. - Review the recent sign-in events - click an event then review the event details (specifically the
Report-onlytab) to ensure:- The sign-in event you're reviewing occurred after turning on the policy in report-only mode.
- The policy name from step 6 above is listed in the
Policy Namecolumn. - The
Resultcolumn for the new policy shows that the policy wasNot applied(indicating the device code authentication flow was not blocked).
- If the above conditions are present, navigate back to the policy name in Conditional Access and open it.
- Toggle the policy from
Report-onlytoOn. - Click
Save.
Default Value
This policy does not exist by default.
References
- https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-authentication-flows#device-code-flow
- https://learn.microsoft.com/en-us/security/benchmark/azure/mcsb-identity-management#im-7-restrict-resource-access-based-on--conditions
- https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-conditional-access-report-only
- https://learn.microsoft.com/en-us/entra/identity/conditional-access/policy-block-authentication-flows
CIS Controls
| Controls Version | Control | IG 1 | IG 2 | IG 3 |
|---|---|---|---|---|
| v8 | 6.1 Establish an Access Granting Process | x | x | x |
| v7 | 12.4 Deny Communication over Unauthorized Ports | x | x | x |
Profile
Level 2 | Manual