<ph type="x-smartling-placeholder"></ph>
您正在查看 Apigee Edge 文档。
转到
Apigee X 文档。 信息
UnresolvedVariable
错误代码
steps.basicauthentication.UnresolvedVariable
错误响应正文
{
"fault": {
"faultstring": "Unresolved variable : [variable_name]",
"detail": {
"errorcode": "steps.basicauthentication.UnresolvedVariable"
}
}
}
错误消息示例
{
"fault": {
"faultstring": "Unresolved variable : request.header.Authorization",
"detail": {
"errorcode": "steps.basicauthentication.UnresolvedVariable"
}
}
}
原因
如果包含 BasicAuthentication 政策的 <Source>
元素中指定的 Base64 编码字符串的变量是以下任一项,就会出现此错误:
- 超出范围(在执行政策的特定流中不可用)
- 无法解析(未定义)
例如,如果 BasicAuthentication 政策在 <Source>
元素中指定了 request.header.Authorization
变量,但授权标头不是作为 API 请求的一部分传递,就会出现此错误。
诊断
标识用于 BasicAuthentication 政策中
<Source>
元素的变量。您可以在错误响应的faultstring
元素中找到此信息。例如,在以下faultstring,
中,<Source>
元素所用的变量为request.header.Authorization
:"faultstring": "Unresolved variable : request.header.Authorization"
检查出现故障的特定 API 代理中的所有 BasicAuthentication 政策。可能有一个或多个 BasicAuthentication 政策。标识一个或多个 BasicAuthentication 政策,在其中,在
<Source>
元素中指定的变量与故障字符串中标识的变量名称(上述第 1 步)相匹配。例如,以下政策将
<Source>
元素设置为名为request.header.Authorization
的变量,该变量与faultstring
中的内容相匹配:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BasicAuthentication name="DecodeBaseAuthHeaders"> <DisplayName>Decode Basic Authentication Header</DisplayName> <Operation>Decode</Operation> <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables> <User ref="request.header.username"/> <Password ref="request.header.password"/> <Source>request.header.Authorization</Source> </BasicAuthentication>
确定变量是否已定义,以及在执行 BasicAuthentication 政策的流中是否可用。
如果该变量:
- 超出范围(在执行政策的特定流中不可用)
- 无法解析(未定义)
那么就会导致错误。
在上面所示的 BasicAuthentication 示例中,变量
request.header.Authorization
未作为请求的一部分进行传递。也就是说,API 请求是在没有授权标头的情况下发出的,如下所示:curl -v "http://org-env.apigee.net/basicauth"
由于在 BasicAuthentication 政策中使用的变量不可用,因此您会收到错误代码:
steps.basicauthentication.UnresolvedVariable
解决方法
确保将 BasicAuthentication 政策中使用的变量定义为输入或作为输入传递,并且在执行政策的流中可用。
如需解决上述 BasicAuthentication 示例中的问题,请发出一个 API 请求,如下所示:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: Basic YWthc2g6MTIz"
InvalidBasicAuthenticationSource
错误代码
steps.basicauthentication.InvalidBasicAuthenticationSource
错误响应正文
{
"fault": {
"faultstring": "Source variable : [variable_name] for basic authentication decode policy is not valid",
"detail": {
"errorcode": "steps.basicauthentication.InvalidBasicAuthenticationSource"
}
}
}
错误示例错误消息
{
"fault": {
"faultstring": "Source variable : request.header.Authorization for basic authentication decode policy is not valid",
"detail": {
"errorcode": "steps.basicauthentication.InvalidBasicAuthenticationSource"
}
}
}
可能的原因
造成此错误的可能原因包括:
原因 | 说明 |
---|---|
来源变量无效 | BasicAuthentication 政策的输入来源变量不是有效的 Base64 编码字符串。 |
标头格式不正确 | 包含传递给 BasicAuthentication 政策的 Base64 编码字符串的标头格式不正确。 |
原因:来源变量无效
如果包含 BasicAuthentication 政策的 <Source>
元素中指定的 Base64 编码字符串的变量不包含有效值,就会出现此错误。
例如,如果 BasicAuthentication 政策的 <Source>
元素中指定的变量没有有效的 Base64 编码字符串,就会出现此错误。
诊断
标识用于 BasicAuthentication 政策中
<Source>
元素的变量。您可以在错误响应的faultstring
元素中找到此信息。例如,在以下faultstring,
中,<Source>
元素所用的变量为request.header.Authorization
:"faultstring": "Source variable : request.header.Authorization for basic authentication decode policy is not valid"
检查出现故障的特定 API 代理中的所有 BasicAuthentication 政策。可能有一个或多个 BasicAuthentication 政策。标识一个或多个 BasicAuthentication 政策,在其中,在
<Source>
元素中指定的变量与故障字符串中标识的变量名称(上述第 1 步)相匹配。例如,以下政策将
<Source>
元素设置为名为request.header.Authorization
的变量,该变量与faultstring
中的内容相匹配:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BasicAuthentication name="DecodeBaseAuthHeaders"> <DisplayName>Decode Basic Authentication Header</DisplayName> <Operation>Decode</Operation> <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables> <User ref="request.header.username"/> <Password ref="request.header.password"/> <Source>request.header.Authorization</Source> </BasicAuthentication>
如果存储在
<Source>
元素中指定的变量的值不是有效的 Base64 编码字符串,则是导致错误的原因。
在上面显示的 BasicAuthentication 示例中,客户端以标头发送的变量
request.header.Authorization
无效,如下所示:curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: Basic 23435"
由于变量
request.header.Authorization
包含无效的 Base64 编码字符串“23435"
”,您将收到错误代码:steps.basicauthentication.InvalidBasicAuthenticationSource
解决方法
确保为 BasicAuthentication 政策中 <Source>
元素指定的变量具有有效的 Base64 编码字符串。
如需解决上述 BasicAuthentication 示例中的问题,请通过在授权标头中传递有效的 Base64 编码字符串来发出 API 请求,如下所示:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: Basic YWthc2g6MTIz"
原因:标题格式错误/无效
如果传递给 BasicAuthentication 政策的标头格式不正确或无效,就会出现此错误。
例如,如果 BasicAuthentication 政策在 <Source>
元素中指定了 request.header.Authorization
变量,并且作为 API 请求的一部分传递的标头格式不正确/无效,就会出现此错误。
诊断
标识用于 BasicAuthentication 政策中
<Source>
元素的变量。您可以在错误响应的faultstring
元素中找到此信息。例如,在以下错误中,用于<Source>
元素的变量是request.header.Authorization
:"faultstring": "Source variable : request.header.Authorization for basic authentication decode policy is not valid"
检查出现故障的特定 API 代理中的所有 BasicAuthentication 政策。可能有一个或多个 BasicAuthentication 政策。标识一个或多个 BasicAuthentication 政策,在其中,在
<Source>
元素中指定的变量与故障字符串中标识的变量名称(上述第 1 步)相匹配。例如,以下政策将
<Source>
元素设置为名为request.header.Authorization
的变量,该变量与faultstring
中的内容相匹配:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BasicAuthentication name="DecodeBaseAuthHeaders"> <DisplayName>Decode Basic Authentication Header</DisplayName> <Operation>Decode</Operation> <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables> <User ref="request.header.username"/> <Password ref="request.header.password"/> <Source>request.header.Authorization</Source> </BasicAuthentication>
如果该变量是标头且格式有误或无效,也就是说,它没有身份验证类型或者身份验证类型不是“基本”类型,就会导致错误。
授权标头的格式如下:
Authorization: <Authentication type> <credentials>
格式错误的标头可通过两种方式传递到 BasicAuthentication 政策:
示例 1:标头中没有身份验证类型:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: YWthc2g6MTIz"
在上面的示例中,授权标头没有身份验证类型。如果将此标头传递给上面显示的 BasicAuthentication 政策,您将收到错误代码:
steps.basicauthentication.InvalidBasicAuthenticationSource
示例 2:身份验证类型不是“基本”类型:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: OAuth YWthc2g6MTIz"
在上面的示例中,授权标头不具有“基本”身份验证类型:如果将此标头传递给上面显示的 BasicAuthentication 政策,您将收到错误代码:
steps.basicauthentication.InvalidBasicAuthenticationSource
同样,如果授权标头中使用身份验证类型(如 Bearer、Digest Auth 等),也会出现此错误。
解决方法
确保传递 BasicAuthentication 政策的输入的标头具有身份验证类型,并且为“基本”类型。
如需解决上述 BasicAuthentication 政策示例中的问题,请通过在授权标头中传递有效的 Base64 编码字符串(具有“基本”身份验证类型)来发出 API 请求,如下所示:
curl -v "http://org-env.apigee.net/basicauth" -H "Authorization: Basic YWthc2g6MTIz"