Allow specified hosts to show Basic Authentication prompts to Office apps
Explanation
This policy setting allows you to specify which hosts can show Basic Authentication sign-in prompts to Office apps.
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, you need to enter the hosts by name, separating the host names with a semi-colon. For example: server1.contoso.com; server2.fabrikam.com.
Warning: Allowing Basic Authentication sign-in prompts isn’t recommended because it’s a security risk.
Basic Authentication sign-in prompts from all other hosts will be blocked and the user will be shown a message that the sign-in method isn’t allowed.
If you disable or don’t configure this policy setting, all Basic Authentication sign-in prompts 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
- not defined in the ADMX
Enable / disable values: not defined in the ADMX (see the options below).
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_BasicAuthPromptBehavior
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\identity'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Host names
Set-ItemProperty -Path $k -Name 'basichostallowlist' -Value '<value>' -Type ExpandStringDisable
# Disable: office16/L_BasicAuthPromptBehavior
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": office16/L_BasicAuthPromptBehavior
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\identity'
Remove-ItemProperty -Path $k -Name 'basichostallowlist' -ErrorAction SilentlyContinueOptions (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Host names:L_AuthenticationBasicAuthEnabledHostsID | Text boxtext | basichostallowlist | REG_EXPAND_SZ |
Application
Microsoft 365 Apps / Office (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.