错误：升级到 Portal for ArcGIS 10.5.1 后无法登录至 Portaladmin API。

错误消息

如果 Portal for ArcGIS 已升级到版本 10.5.1，而先前安装的版本已经配置了转发代理服务器，则用户可登录至 Portal for ArcGIS 主目录应用程序和共享 API，但无法登录至 Portaladmin API。

原因

Portaladmin API 无法通过指定的转发代理服务器进行身份验证。 当尝试登录时，Web 浏览器中发生了下列错误：

错误： 
“无效令牌”
或者
“您无权访问此资源”

此外，门户日志将显示与下列类似的消息：

错误：
无法为用户“portaladmin”生成令牌. java.lang.异常：服务器返回 HTTP 状态代码 404。 请求的 URL：https://portaladmin.domain.com:7443/arcgis/sharing/generateToken

解决方案或解决方法

如果可能，在升级至 Portal for ArcGIS 10.5.1 之前，请将转发代理 JavaScript 对象表示法 (JSON) "nonProxyHosts" 参数添加到 Portal for ArcGIS 系统属性。

1. 使用管理员帐户登录至 Portaladmin API。
   • 示例：https://portal.domain.com:7443/arcgis/portaladmin
2. 选择系统 > 属性 > 更新 （https://portal.domain.com:7443/arcgis/portaladmin/system/properties/update）。
3. 将 "nonProxyHosts":"portal.domain.com" 添加到转发代理设置（将 portal.domain.com 替换为安装 Portal for ArcGIS 的计算机的完全限定域名 (FQDN)）。
   • 示例：

     "httpProxyHost":"forwardproxy.domain.com","httpsProxyHost":"forwardproxy.domain.com","httpProxyPort":80,"httpsProxyPort":443","nonProxyHosts":"portal.domain.com"

   • 此内容 将在 Web 帮助文档中进一步说明，将转发代理服务器与 Portal for ArcGIS 结合使用。
4. 选择更新属性 以保存更改。
5. 登出 Portal for ArcGIS。 应用程序 将重新启动。
6. Portal for ArcGIS 重新启动完成后，重新登录至 Portaladmin 以验证设置是否已保存。
7. 使用 ArcGIS Enterprise 备份实用程序创建备份。
8. 备份完成后，升级至 Portal for ArcGIS 10.5.1。

• 联系 Esri 技术支持以获得有关将 Portal for ArcGIS 恢复为先前版本的帮助，或者
• 修改 catalina.properties 和 portal-config.properties 页面，如下所示：

1. 在服务控制台 (services.msc) 中停止 Portal for ArcGIS Windows 服务：
   • 在运行对话框中输入 services.msc，然后按 Enter 键。
2. 创建 catalina.properties 文件的备份副本，例如：
   
3. 使用文本编辑器打开 catalina.properties 文件。
4. 注释掉以下条目：
   • http.proxyHost =
   • https.proxyHost =
   • http.proxyPort =
   • https.proxyPort =
   • nonProxyHosts =
5. 保存 catalina.properties 文件
6. 创建 portal-config.properties 文件的备份副本，例如：
   
7. 使用文本编辑器打开 portal-config.properties 文件。
8. 注释掉以下条目：
   • http.proxyHost =
   • https.proxyHost =
   • http.proxyPort =
   • https.proxyPort =
   • nonProxyHosts =
9. 保存 portal-config.properties 文件。
10. 在服务控制台 (services.msc) 中启动 Portal for ArcGIS Windows 服务。
11. 登录到 Portal for ArcGIS Portaladmin API (https://portal.domain.com:7443/arcgis/portaladmin)
12. 选择系统 > 属性 > 更新。
13. 添加 "nonProxyHosts":"portal.domain.com"。 将 portal.domain.com 替换为安装 Portal for ArcGIS 的主机名。 例如：

• "httpProxyHost":"forwardproxy.domain.com","httpsProxyHost":"forwardproxy.domain.com","httpProxyPort":80,"httpsProxyPort":443","nonProxyHosts":"portal.domain.com"

14. 选择更新属性。
15. 使用 ArcGIS Enterprise 备份实用程序创建备份。