中文

操作方法:使用外部 Web 浏览器登录 Survey123 for ArcGIS 2.0 外业应用程序或 Survey123 Connect for ArcGIS 2.0

摘要

默认情况下,Survey123 for ArcGIS 外业应用程序和 Survey123 Connect for ArcGIS 都具备登录应用程序所需的嵌入式 Web 视图。 此外,这两个应用程序均支持启动外部 Web 浏览器进行登录,但需要进行一些配置。

使用外部 Web 浏览器进行登录的原因包括:

  • 指定使用特定 Web 浏览器的安全策略
  • 使用 web 浏览器凭据管理的要求
  • 屏幕尺寸和分辨率特性

无论使用嵌入式 web 视图还是外部 web 浏览器,都会显示相同的 OAuth 登录页面。

ArcGIS Online 以及 10.5.1 或更高版本的 Portal for ArcGIS 已经配置了使用外部 Web 浏览器进行登录的功能。 对于 Portal for ArcGIS 的早期版本,必须在门户中配置相关的 Survey123 for ArcGIS 重定向 URI,并将门户配置添加到应用程序。

:
本文所针对的是 2.0 版及更高版本的原生 Survey123 for ArcGIS 应用程序,对于基于 Web 的 Survey123 for ArcGIS 版本来说并非必需内容。

过程

在 Portal for ArcGIS 中配置 Survey123 for ArcGIS 重定向 URI

用户在 Web 浏览器中进行身份验证后,必须将其重新定向回 Survey123 for ArcGIS。 为此,必须针对所有适用的门户使用相应的客户端 ID 注册 Survey123 for ArcGIS 外业应用程序和 Survey123 for ArcGIS Connect 的重定向 URI。 这些门户如下所示:

client_idredirect_uri
survey123urn:ietf:wg:oauth:2.0:oob
survey123arcgis-survey123://
survey123connecturn:ietf:wg:oauth:2.0:oob
survey123connectarcgis-survey123connect://

默认情况下,ArcGIS Online 以及 10.5.1 或更高版本的 Portal for ArcGIS 中存在上述门户;但对于较早版本的 Portal for ArcGIS,必须在 Portal for ArcGIS 界面中进行手动添加。

  1. 以管理员身份登录门户的 portaladmin 资源 (https:// / /portaladmin)。
  2. 导航至安全 > OAuth > 获取应用程序信息
  3. 验证现有应用程序信息。 在应用程序 ID 框中输入应用程序 ID,然后单击获取应用程序信息。 信息如下:
    survey123:{"appId":"survey123","redirectURIs":["https://*.arcgis.com","http://*.arcgis.com","https://*.esri.com","http://*.esri.com","urn:ietf:wg:oauth:2.0:oob"]}
    survey123connect:{"appId":"survey123connect","redirectURIs":["https://*.arcgis.com","http://*.arcgis.com","https://*.esri.com","http://*.esri.com","urn:ietf:wg:oauth:2.0:oob"]}
  4. 返回 OAuth 页面,并导航至 更新应用程序信息
  5. 将以下文本粘贴到文本框中,然后单击更新应用程序,以更新用于 Survey123 for ArcGIS 外业应用程序的信息。 注意 redirectURIs 部分结尾处添加的内容。
    {"appId":"survey123","redirectURIs":["https://*.arcgis.com","http://*.arcgis.com","https://*.esri.com","http://*.esri.com","urn:ietf:wg:oauth:2.0:oob","arcgis-survey123://*"]}
  6. 以同样的方式更新 Survey123 Connect for ArcGIS 的信息,粘贴并更新以下内容。
    {"appId":"survey123connect","redirectURIs":["https://*.arcgis.com","http://*.arcgis.com","https://*.esri.com","http://*.esri.com","urn:ietf:wg:oauth:2.0:oob","arcgis-survey123connect://*"]}
添加门户连接并登录

以下步骤适用于 ArcGIS Online 和 Portal for ArcGIS。 如需为 ArcGIS Online 启用基于浏览器的身份验证,请使用门户 URL https://www.arcgis.com/。 Survey123 for ArcGIS 外业应用程序和 Survey123 Connect for ArcGIS 添加门户连接的过程是相同的。

  1. 在 Survey123 for ArcGIS 外业应用程序中,单击设置按钮 > 门户 > 添加门户

    A view of the Survey123 Connect for ArcGIS app, with the Settings button highlighted. A view of the Survey123 Connect Settings window, having clicked Portal, with ArcGIS Online highlighted.
     
  2. 键入门户的 URL(单击或按住文本,选择已激活的 ArcGIS Portal,以进入高级配置。)

    A view of the Survey123 Connect Settings window, with ArcGIS Online highlighted, and the URL of your Portal for ArcGIS available for editing.
     
  3. 通过系统 web 浏览器选择登录
  4. 单击 添加门户,然后登录。
  5. 在浏览器中加载对话框后,输入指定用户凭据。
  6. 系统会将用户重定向到外业应用程序并登录。
:
在为 Windows 和 Linux 上运行的应用程序输入登录凭据后,系统会向用户显示“OAuth2 批准”页面。 必须将其中包含的代码手动复制并粘贴到应用程序中,以完成身份验证过程。