Set up a NameID policy for SAML
task brazil Updated Sep 10, 2026 1 min read t_SetUpNameIDPolicy.md
Set up a NameID policy for SAML. SAML 2.0 requires the IdP to exchange a NameID token with the service provider.
Before you begin
Role required: sso_config_admin, business_rule_admin, script_include_admin
About this task
For the SAML 2.0 integration the NameID token must map to a particular field in the User table. The integration uses the NameID token's value to determine what user the IdP authenticates.
Procedure
-
Browse the IdP metadata to find the
NameIDFormatelement that contains a value ofemailAddress.The value of this element is the default format that the integration uses.
-
Review other
NameIDFormatelements to determine if there are formats that match other fields in the User table.
36 lines · 1.3 KB
---
title: Set up a NameID policy for SAML
description: Set up a NameID policy for SAML. SAML 2.0 requires the IdP to exchange a NameID token with the service provider.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/platform-security/authentication/t\_SetUpNameIDPolicy.html
release: brazil
product: Authentication
classification: authentication
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Service Provider \(SP\) system properties, SAML, Multi-Provider single sign-on \(SSO\), Authentication, Access Management]
---
# Set up a NameID policy for SAML
Set up a NameID policy for SAML. SAML 2.0 requires the IdP to exchange a NameID token with the service provider.
## Before you begin
Role required: sso\_config\_admin, business\_rule\_admin, script\_include\_admin
## About this task
For the SAML 2.0 integration the NameID token must map to a particular field in the User table. The integration uses the NameID token's value to determine what user the IdP authenticates.
## Procedure
1. Browse the IdP metadata to find the `NameIDFormat` element that contains a value of `emailAddress`.
The value of this element is the default format that the integration uses.
2. Review other `NameIDFormat` elements to determine if there are formats that match other fields in the User table.
| title | Set up a NameID policy for SAML |
| description | Set up a NameID policy for SAML. SAML 2.0 requires the IdP to exchange a NameID token with the service provider. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/platform-security/authentication/t\_SetUpNameIDPolicy.html |
| release | brazil |
| product | Authentication |
| classification | authentication |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Service Provider \(SP\) system propertiesSAMLMulti-Provider single sign-on \(SSO\)AuthenticationAccess Management |