Open in the explorer

Allow specified hosts to show Basic Authentication prompts to Office apps

Type
User
GPO path
User Configuration › Policies › Administrative Templates › Microsoft Office 2016 › Security Settings
Supported on
At least Windows Server 2008 R2 or Windows 7
ADMX file
office16.admx
Internal name
office16/L_BasicAuthPromptBehavior

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 ExpandString

Disable

# 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 SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Host names:L_AuthenticationBasicAuthEnabledHostsIDText boxtextbasichostallowlistREG_EXPAND_SZ

Application

Microsoft 365 Apps / Office (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.