为企业应用程序定制在 JSON Web Token (JWT) 中发布的声明

函数 说明 ExtractMailPrefix() 删除电子邮件地址或用户主体名称中的域后缀。 此功能仅提取用户名的第一部分。 例如，，而非 。 Join() 通过联接两个属性来创建新的值。 或者，可以在两个属性之间使用分隔符。 对于 NameID 声明转换，在转换输入具有域部分时，Join() 函数具有特定行为。 它会先从输入中删除域部分，然后再将输入与分隔符和所选参数联接起来。 例如，如果转换的输入为 ，分隔符为 ，参数为 ，则此输入组合最终会生成 。 ToLowercase() 将所选属性的字符转换为小写字符。 ToUppercase() 将所选属性的字符转换为大写字符。 Contains() 如果输入与指定的值匹配，则输出一个属性或常量。 否则，如果没有匹配项，则可以指定其他输出。
例如，如果想要发出一个声明，其中的值为用户的电子邮件地址（如果包含域 ），否则就需要输出用户主体名称。 若要执行此函数，请配置以下值：
参数 1(输入) ：user.email
值：“@contoso.com”
参数 2(输出)：user.email
参数 3（如果没有匹配项，则为输出）：user.userprincipalname EndWith() 如果输入以指定值结束，则输出一个属性或常量。 否则，如果没有匹配项，则可以指定其他输出。
例如，如果想要发出一个声明，其中的值为用户的员工 ID （如果员工 ID 以 结束），否则就需要输出一个扩展属性。 若要执行此函数，请配置以下值：
参数 1(输入) ：user.employeeid
值：000
参数 2(输出)：user.employeeid
参数 3（如果没有匹配项，则为输出）：user.extensionattribute1 StartWith() 如果输入以指定值开始，则输出一个属性或常量。 否则，如果没有匹配项，则可以指定其他输出。
例如，如果想要发出一个声明，其中的值为用户的员工 ID（如果国家/地区以“”开始），否则就需要输出一个扩展属性。 若要执行此函数，请配置以下值：
参数 1(输入) ：user.country
值：美国
参数 2(输出)：user.employeeid
参数 3（如果没有匹配项，则为输出）：user.extensionattribute1 Extract() - 匹配后 匹配指定值后返回的子字符串。
例如，如果输入的值为 ，匹配值为 ，则声明的输出为 。 Extract() - 匹配前 在匹配指定值前返回的子字符串。
例如，如果输入的值为 ，匹配值为 ，则声明的输出为 。 Extract() - 匹配之间 在匹配指定值前返回的子字符串。
例如，如果输入的值为 ，第一个匹配值为 ，第二个匹配值为 ，则声明的输出为 。 ExtractAlpha() - 前缀 返回字符串的前缀字母部分。
例如，如果输入的值为 ，则它将返回 。 ExtractAlpha() - 后缀 返回字符串的后缀字母部分。
例如，如果输入的值为 ，则它将返回 。 ExtractNumeric() - 前缀 返回字符串的前缀数字部分。
例如，如果输入的值为 ，则它将返回 。 ExtractNumeric() - 后缀 返回字符串的后缀数字部分。
例如，如果输入的值为 ，则它将返回 。 IfEmpty() 如果输入为 null 或为空，则输出一个属性或常量。
例如，如果希望在给定用户的员工 ID 为空时输出存储在 extension attribute 中的属性。 若要执行此函数，请配置以下值：
参数 1(输入)：user.employeeid
参数 2(输出)：user.extensionattribute1
参数 3（如果没有匹配项，则为输出）：user.employeeid IfNotEmpty() 如果输入不为 null 或空，则输出一个属性或常量。
例如，如果希望在给定用户的员工 ID 不为空时输出存储在 extension attribute 中的属性。 若要执行此函数，请配置以下值：
参数 1(输入)：user.employeeid
参数 2(输出)：user.extensionattribute1 Substring() - 固定长度 提取字符串声明类型的组成部分（从位于指定位置处的字符开始），并返回指定数目的字符。
SourceClaim - 应执行的转换的声明源。
StartIndex - 此实例中子字符串的起始字符位置（从零开始）。
Length - 子字符串的字符长度。
例如：
sourceClaim - PleaseExtractThisNow
StartIndex - 6
Length - 11
输出：ExtractThis Substring() - EndOfString 从指定位置的字符开始，提取字符串声明类型的部分内容，并返回声明中从指定起始索引开始的剩余内容。
SourceClaim - 转换的声明源。
StartIndex - 此实例中子字符串的起始字符位置（从零开始）。
例如：
sourceClaim - PleaseExtractThisNow
StartIndex - 6
输出：ExtractThisNow RegexReplace() RegexReplace() 转换接受以下内容作为输入参数：
- 参数 1：用户属性作为正则表达式输入
- 信任源作为多值的选项
- 正则表达式模式