Office Admin Explorer

Allow specified hosts to show Basic Authentication prompts to Office apps

Registry value
basichostallowlist
Group PolicyAllow specified hosts to show Basic Authentication prompts to Office apps
German versionZulassen, dass angegebene Hosts Aufforderungen zur Standardauthentifizierung für Office-Anwendungen anzeigen
Intune settings catalogAllow specified hosts to show Basic Authentication prompts to Office apps (User)
ScopeUser · HKCU
ADMXoffice16.admx · L_BasicAuthPromptBehavior
Open in the interactive explorer+ Add to my collection

Group Policy path

User Configuration\Policies\Administrative Templates\Microsoft Office 2016\Security Settings
Benutzerkonfiguration\Richtlinien\Administrative Vorlagen\Microsoft Office 2016\Sicherheitseinstellungen

Registry

ValueData
HKCU\Software\policies\microsoft\office\16.0\common\identity
basichostallowlisttext

Not configured = the value does not exist – the application default applies and users may change the setting.

PowerShell

Check the current value (read-only)

# --- Settings ---
$root = 'HKCU:'   # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'

$key = "$root\Software\policies\microsoft\office\16.0\common\identity"
foreach ($name in @('basichostallowlist')) {
    try   { '{0} = {1}' -f $name, (Get-ItemPropertyValue -Path $key -Name $name -ErrorAction Stop) }
    catch { '{0}: not configured' -f $name }
}

Admin rights needed: HKCU\Software\Policies is read-only for standard users. An elevated session writes to the admin's own HKCU – to set it for another signed-in user, change $root to Registry::HKEY_USERS\<SID>.

Enable

# --- Settings ---
$root = 'HKCU:'   # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'

try {
    $key = "$root\Software\policies\microsoft\office\16.0\common\identity"
    if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
    New-ItemProperty -Path $key -Name 'basichostallowlist' -PropertyType String -Value '<value>' -Force -ErrorAction Stop | Out-Null   # your value
    'Done.'
}
catch { Write-Error "Failed: $($_.Exception.Message)" }
Reset to Not configured
# --- Settings ---
$root = 'HKCU:'   # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'

$key = "$root\Software\policies\microsoft\office\16.0\common\identity"
Remove-ItemProperty -Path $key -Name 'basichostallowlist' -ErrorAction SilentlyContinue
'Policy values removed (Not configured).'

Intune (settings catalog)

Allow specified hosts to show Basic Authentication prompts to Office apps (User)

Settings catalog → Add settings → search for the name above.

Intune Settings Catalog Viewer ↗

Alternative: custom profile (OMA-URI)
OMA-URI
./User/Vendor/MSFT/Policy/Config/office16v12~Policy~L_MicrosoftOfficeSystem~L_SecuritySettings/L_BasicAuthPromptBehavior
Data typeString
Value<enabled/> · <disabled/>

This policy has options: add one <data id="…" value="…"/> per element after <enabled/>. The element IDs are in the ADMX file.

Cloud Policy

Cloud Policy (config.office.com → Customization → Policy Management) offers many user policies of the Microsoft 365 Apps – search for Allow specified hosts to show Basic Authentication prompts to Office apps. It also applies to unmanaged devices and wins over GPO and Intune for the same setting.

Microsoft 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.

Same category: Microsoft Office 2016 › Security Settings

All policies in this category · All 945 policies of office16.admx