Skip to content

Add FAQ about MFA #3672

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions docs-conceptual/azps-14.2.0/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,36 @@ Update-AzConfig -EnableLoginByWam $false
- WAM popup window to select an account isn't easy to find. Minimize other windows to locate the
popup window.

## SharedTokenCacheCredential authentication unavailable

If you receive this error when running an Azure PowerShell cmdlet that creates or modifies Azure
resources, it's likely that you're blocked by the Microsoft Entra ID Conditional Access policy.

The complete error message is as follows:

```Output
SharedTokenCacheCredential authentication unavailable. Token acquisition failed for user
[email protected]. Ensure that you have authenticated with a developer tool that supports
Azure single sign on.
```

To resolve this issue, update to one of the following versions:

- **Az** PowerShell module version 14.X.Y or later
- Or equivalently, **Az.Accounts** PowerShell module version 5.X.Y or later

These versions provide improved error messages that identify the specific Conditional Access policy
causing the issue and offer guidance for resolving it.

For example, if your organization requires multifactor authentication (MFA), you see an error
message like:

```powershell
{Placeholder for error message}
```

To complete sign-in using MFA, follow the instructions in the error message.

## Installation

This section contains a list of solutions to common problems when installing the Az PowerShell
Expand Down