Allow Basic Authentication prompts from network proxies
Explanation
This policy setting controls whether network proxies are allowed to show Basic Authentication prompts.
By default, all Basic Authentication sign-in prompts are blocked, and the user is shown a message that the sign-in method isn’t allowed.
If you enable this policy setting, then network proxies will be allowed to show Basic Authentication prompts.
Warning: Allowing Basic Authentication sign-in prompts isn’t recommended because it’s a security risk.
If you disable or don’t configure this policy setting, all Basic Authentication sign-in prompts from network proxes will be blocked, and the user will be shown a message that the sign-in method isn’t allowed.
Note: This policy setting only applies to subscription versions of Office, such as Microsoft 365 Apps for enterprise, and to subscription versions of Project and Visio.
For more information, see https://go.microsoft.com/fwlink/p/?linkid=2199001.
Registry
HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\common\identity- Value name
basicauthproxybehavior
| State | Value written |
|---|---|
| Enabled | REG_DWORD = 1 |
| Disabled | REG_DWORD = 0 |
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: office16/L_BasicAuthProxyBehavior
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\identity'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'basicauthproxybehavior' -Value 1 -Type DWordDisable
# Disable: office16/L_BasicAuthProxyBehavior
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\identity'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'basicauthproxybehavior' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": office16/L_BasicAuthProxyBehavior
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\identity'
Remove-ItemProperty -Path $k -Name 'basicauthproxybehavior' -ErrorAction SilentlyContinueApplication
Microsoft 365 Apps / Office (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.