Azure AD B2C 从字符串嵌套JSON提取student.person.name声明
核心问题本质
你碰到的致命异常和转换链路跑不通,本质是两个硬限制被忽略了:
- Azure AD B2C内置的
GetClaimFromJson转换器原生不支持带点号的嵌套路径解析,低版本框架碰到路径中的点会直接把字符串当成顶层字段名匹配,找不到值就抛空引用类的致命异常 - 你当前拿到的
student声明值是经过双重转义的序列化字符串,不是原生可解析的JSON对象,两级转换过程中如果中间值的格式没有对齐解析要求,第二次转换会直接触发JSON格式错误
可落地实现方案
方案1:单步提取支持嵌套路径(最省维护成本)
只要你把自定义策略依赖的IdentityExperienceFramework升级到1.1.7及以上版本,内置的GetClaimFromJson转换器就原生支持点分式嵌套路径提取,不需要拆分多级链路:
- 先在策略的声明架构块中定义好最终要使用的自定义声明:
<BuildingBlocks> <ClaimsSchema> <ClaimType Id="ext_studentFullName"> <DisplayName>Student Full Name</DisplayName> <DataType>string</DataType> </ClaimType> <ClaimType Id="ext_studentContactEmail"> <DisplayName>Student Contact Email</DisplayName> <DataType>string</DataType> </ClaimType> </ClaimsSchema> - 直接配置嵌套路径提取的转换规则,直接读取存为字符串的
student值,用嵌套路径取目标字段:<ClaimsTransformations> <ClaimsTransformation Id="ExtractStudentName" TransformationMethod="GetClaimFromJson"> <InputClaims> <InputClaim ClaimTypeReferenceId="student" TransformationClaimType="inputJson" /> </InputClaims> <InputParameters> <InputParameter Id="claimToExtract" DataType="string" Value="person.name" /> </InputParameters> <OutputClaims> <OutputClaim ClaimTypeReferenceId="ext_studentFullName" TransformationClaimType="extractedClaim" /> </OutputClaims> </ClaimsTransformation> <ClaimsTransformation Id="ExtractStudentEmail" TransformationMethod="GetClaimFromJson"> <InputClaims> <InputClaim ClaimTypeReferenceId="student" TransformationClaimType="inputJson" /> </InputClaims> <InputParameters> <InputParameter Id="claimToExtract" DataType="string" Value="person.email" /> </InputParameters> <OutputClaims> <OutputClaim ClaimTypeReferenceId="ext_studentContactEmail" TransformationClaimType="extractedClaim" /> </OutputClaims> </ClaimsTransformation> </ClaimsTransformations> </BuildingBlocks> - 在你需要获取这些声明的编排步骤里,把上面两个转换作为预置的声明操作加上,确保执行顺序在REST接口返回
student值之后。
方案2:拆两级转换(不用升级框架也能跑通)
如果你因为版本限制没法升级框架,就按照正确的拆分逻辑配置两级转换,避开之前踩的坑:
- 先定义两个临时中间声明,用来存第一级提取出来的person对象字符串:
<ClaimType Id="temp_personRawJson"> <DisplayName>Temporary Raw Person JSON String</DisplayName> <DataType>string</DataType> </ClaimType> - 配置第一级转换,从原始的
student字符串中提取顶层的person字段,存到临时声明里:<ClaimsTransformation Id="ExtractPersonFromStudent" TransformationMethod="GetClaimFromJson"> <InputClaims> <InputClaim ClaimTypeReferenceId="student" TransformationClaimType="inputJson" /> </InputClaims> <InputParameters> <InputParameter Id="claimToExtract" DataType="string" Value="person" /> </InputParameters> <OutputClaims> <OutputClaim ClaimTypeReferenceId="temp_personRawJson" TransformationClaimType="extractedClaim" /> </OutputClaims> </ClaimsTransformation> - 配置第二级转换,从临时的
temp_personRawJson字符串里,分别提取name和email字段作为最终使用的自定义声明:<ClaimsTransformation Id="ExtractNameFromPerson" TransformationMethod="GetClaimFromJson"> <InputClaims> <InputClaim ClaimTypeReferenceId="temp_personRawJson" TransformationClaimType="inputJson" /> </InputClaims> <InputParameters> <InputParameter Id="claimToExtract" DataType="string" Value="name" /> </InputParameters> <OutputClaims> <OutputClaim ClaimTypeReferenceId="ext_studentFullName" TransformationClaimType="extractedClaim" /> </OutputClaims> </ClaimsTransformation>
关键避坑点
- 所有用来存JSON文本的声明,DataType一律用
string,别定义成object或者complex类型,不然转换器会因为类型不匹配直接报错 - 第一级转换完成后,一定要临时把
temp_personRawJson加到编排步骤的输出声明里,跟踪实际值是不是合法的JSON字符串——如果值里还带着反斜杠的转义格式,说明REST返回值做了双重序列化,需要调整REST技术资料的响应解析配置,关掉返回值的自动转义逻辑,不然第二级解析永远会报格式错误 - 别在老版本框架里直接写带点的嵌套路径,比如直接写
person.name,解析器不识别点号层级,只会把这一整串当成顶层字段名匹配,找不到值就会触发你之前碰到的致命异常
内容的提问来源于stack exchange,提问作者Reni Dantas
相关产品推荐
相关产品推荐

