Limit basic authentication restriction allowed users

reference brazil Updated Sep 10, 2026 3 min read sc-limit-basic-auth-restriction-allowed-users.md
Raw file servicenow.com

The glide.authenticate.basic_auth.allowed_users property defines specific user accounts that bypass the Basic Authentication Restriction gate without multi-factor authentication.

This system property contains a comma-separated list of user sys_ids exempt from the Basic authentication restriction gate. When restriction is active, any interactive-login user whose sys_id appears in this list can authenticate through Basic Auth without multi-factor authentication or time-based one-time password. This user check runs unconditionally, before enforcement-date tracking logic and before any per-account review in the Basic Auth Exception table. A user match is never logged as a tracked exception and always bypasses the gate regardless of whether enforcement is enabled.

The out-of-box value is empty, so no account is exempted unless an administrator explicitly adds one. This property is intended for narrowly-scoped integration accounts that cannot satisfy multi-factor authentication requirements and do not hold a role listed in the allowed_roles property.

To configure this property:

  1. Navigate to /sys_properties_list.do on the instance.
  2. Ensure the glide.authenticate.basic_auth.allowed_users property contains only sys_ids for dedicated integration accounts with a documented business justification. Remove any account that no longer requires a standing MFA exemption for Basic Auth API access.

More information

Attribute

Description

Configuration name

glide.authenticate.basic_auth.allowed_users

Configuration type

System Properties (/sys_properties_list.do)

Data type

String (comma-delimited list of sys_ids)

Recommended value

<Empty> or limited to specific, individually-reviewed dedicated service accounts

Default value

<Empty>

Fallback value

<None>

Category

Authentication

Security risk

  • Severity score: 8.1
  • CVSS score: High
  • Security risk details:

Any user sys_id added to this property receives a permanent, unconditional bypass of the Basic Authentication Restriction gate for that one account. This is not a temporary tracking-mode allowance. Unlike an account left to the default review flow, a listed sys_id is never logged and never subject to further review. That account permanently loses multi-factor authentication protection on its Basic Auth API access.

An attacker who obtains that account's password through phishing, credential stuffing, or a prior breach can authenticate directly against the API without satisfying a second factor. Entries are added by sys_id rather than username. A stale entry can silently persist and continue exempting an account long after the original justification for adding it is gone. Nothing in the property's own value indicates which account it refers to.

Functional impact

This property takes effect for users not already allowed through an earlier check. Earlier checks include WSAO accounts, oauth_token requests, an active TOTP or multi-factor authentication session, or the allowed_roles list.

Because this property ships empty, any populated entry is always a deliberate administrator action, never an inherited default. Removing a sys_id from this list does not deny that account access outright. Affected users fall through to the same allowed_roles check and enforcement-date tracking-mode review flow as any other basic-auth user. There is a review safety net before actual denial takes effect.

Administrators should periodically re-validate every sys_id in this list against a live user record. Confirm each is still a legitimate, currently-needed integration account rather than a stale holdover. A bare sys_id gives no indication of which account it names.

Dependencies and prerequisites

Plugin com.snc.integration.multifactor.authentication must be Active. No effect unless glide.authenticate.basic_auth.restriction.active is true.

**Parent Topic:**[Authentication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-security/instance-security-hardening-settings/sc-authentication.md)
Keywords basic authenticationMFA bypassuser exemptionsecurity gate
Search documentation
Search document titles and file paths on the brazil branch