添加并注册应用程序

将 URL 引用添加到现有应用程序是一种与组织成员及普通公众共享工作成果的有效方法(根据共享权限)。 除 URL 之外,您还可共享其他详细信息,例如应用程序类型、用途、摘要和描述以及含有用于创建应用程序的代码的 .zip 文件。将应用程序添加至 ArcGIS Online 时,仅会添加对应用程序 URL 的引用;ArcGIS Online 不会存储应用程序文件。

作为拥有组织账户的应用程序开发者,您还可以在平台中注册应用程序。 这涉及注册 OAuth 应用程序,以便组织成员和组织外部的用户可以登录应用程序。有关详细信息,请参阅以下使用开发人员凭据添加和注册应用程序部分。

如果需要注册应用程序(例如当上传代码示例时),按照以下通过 URL 添加应用程序部分中的步骤执行操作。

提示:

另一种与组织成员及公众共享应用程序的方法是创建包含地图的应用程序包含群组的图库应用程序。

从 URL 添加应用程序

按照以下步骤添加使用 URL 访问 Web 上的应用程序但无需注册的项目(例如,代码示例):

注:

要添加已注册应用程序,按照相关步骤使用开发人员凭据添加和注册应用程序

  1. 验证您是否已登录,以及是否具备创建、更新和删除内容的权限
  2. 在内容页面的我的内容选项卡中,单击新建项目,然后单击应用程序
  3. 选择应用程序类型:
    • Web 制图 - 用 Web API 构建 Web 应用程序,如 JavaScript
    • 桌面 - 在桌面平台构建的用于桌面的应用程序,如 Java 或 .NET (Microsoft Windows Desktop)。
    • 移动 - 使用 SDK 为移动设备(如 iOSAndroid)构建的可下载应用程序。
    • 其他应用程序 - 桌面应用程序、Python 脚本或任何类型的通用应用程序,您没有关于应用程序用途、API、SDK 或 URL 地址的详细信息。
  4. 对于 web 制图、桌面或移动应用程序,请输入应用程序的 URL,例如 https://<myServer>/myWebMapApp
  5. 对于桌面应用程序,请单击浏览,然后选择包含应用程序的 .zip 文件。
  6. 单击下一步
  7. 提供标题。
  8. 我的内容中选择要用于保存项目的文件夹。

    您也可以从菜单中选择创建新文件夹,并输入文件夹名称,将项目保存在新文件夹中。

    文件夹名称不能包含 4 字节 Unicode 字符。

  9. 如果您的组织已设置内容类别,请单击分配类别并最多选择 20 个类别以方便其他用户查找项目。

    您还可以输入类别名称以缩小类别列表范围。

  10. 或者,输入用于描述项目的标签。

    多个术语之间使用逗号进行分隔(例如,Federal land 将被视为一个标签;Federal, land 则被视为两个标签)。

    输入过程中,您可以选择显示的任何建议标签;建议由您之前添加的标签生成。

  11. 或者,添加描述应用程序的摘要。
  12. 单击保存

添加应用程序后,文件即会出现在您的内容中。 如果需要稍后注册,可以从应用程序项目页面的设置选项卡执行此操作。 有关详细信息,请参阅以下使用开发人员凭据添加和注册应用程序部分。

可以根据需要配置项目详细信息附加代码,如果您具有共享权限,则可以共享应用程序

创建开发者凭据项目

作为拥有组织账户的开发者,创建一个开发者凭据项目以生成应用程序 ID。 在应用程序中使用应用程序 ID 来收集使用情况统计数据并允许用户使用 OAuth 2.0(一种标准授权框架)登录到平台。 应用程序可使用 OAuth 2.0 指导用户通过平台所托管的登录页面登录平台。 它也允许应用程序使用与组织相关联的用户内容和其他 ArcGIS Online 功能,例如地理编码、路径选择和 GeoEnrichment。 要了解有关身份验证和 OAuth 2.0 的详细信息,请参阅 Esri 开发者

也可以创建用于执行应用程序身份验证和生成 API 密钥的开发者凭据。

您创建的开发者凭据的类型取决于您在组织中的权限。 如果您是默认管理员角色的成员或具有 API 密钥生成权限自定义角色的成员,则您可以使用 OAuth 2.0 或 API 密钥凭据。 否则,只能使用 OAuth 2.0 开发者凭据。

创建开发者凭据后,请单击应用程序项目页面设置选项卡上的查看使用情况以访问有关已登录应用程序的用户及其所用配额数量的信息。 还可以管理应用程序中嵌入的凭据的设置

注:

在通过 ArcGIS Location Platform 订阅登录时,查看使用情况部分不可用。

用户登录的实施模式会因您开发的是基于 Web 的应用程序还是原生应用程序而稍有不同。Esri 开发者 文档中包含同时适用于基于 Web 的应用程序和原生应用程序的详细信息与代码示例。

创建用于用户身份验证的 OAuth 2.0 凭据

如果您的应用程序要求用户使用 ArcGIS Online 账户登录,请完成以下步骤。

  1. 验证您是否已使用具备创建、更新和删除内容权限的组织账户进行登录。
  2. 单击内容页面的我的内容选项卡,然后单击新建项目
  3. 新建项目窗口中,单击开发人员凭据

    为您显示的第一个窗口可能因您在组织中权限的不同而有所变化。 如果您的成员角色不具备创建 API 密钥的权限,请前进至步骤 5。 如果您的角色具备创建 API 密钥的权限,请前进至步骤 4。

  4. 选择 OAuth 2.0 凭据 — 用于用户身份验证选项并单击下一步
  5. 重定向 URL 下,提供用于在用户成功登录后重定向用户的 Web 页面或服务器端点的 URL。 单击添加根据需要添加更多重定向 URL。

    授权期间指定的重定向 URL 必须与已注册 URL 之一相匹配,否则授权将遭拒。

    还可以指定特殊值 urn:ietf:wg:oauth:2.0:oob 以进行授权许可。 这会导致授权码传递到门户 URL (/oauth2/approval)。 此值通常用于没有可以提供代码的 Web 服务器或自定义 URL 方案的应用程序。

    下面是受支持的重定向 URL 格式的示例:

    • https://app.foo.com
    • urn:ietf:wg:oauth:2.0:oob

  6. URL 框中,以 https://<myServer>/myWebMapApp 格式键入应用程序的 URL。
  7. 单击下一步
  8. 提供标题。
  9. 我的内容中选择要用于保存项目的文件夹。

    您也可以从菜单中选择创建新文件夹,并输入文件夹名称,将项目保存在新文件夹中。

    文件夹名称不能包含 4 字节 Unicode 字符。

  10. 如果您的组织已设置内容类别,请单击分配类别并最多选择 20 个类别以方便其他用户查找项目。

    您还可以输入类别名称以缩小类别列表范围。

  11. 或者,输入用于描述项目的标签。

    多个术语之间使用逗号进行分隔(例如,Federal land 将被视为一个标签;Federal, land 则被视为两个标签)。

    输入过程中,您可以选择显示的任何建议标签;建议由您之前添加的标签生成。

  12. 或者,添加描述应用程序的摘要。
  13. 单击下一步

    将显示凭据摘要。

  14. 查看凭据摘要。 要更改设置,在创建项目之前单击返回进行更改。
  15. 单击创建

应用程序即会添加至内容,其项目页面随即显示。 指示已将 OAuth 2.0 凭据用于应用程序的标记 OAuth 2.0 凭据 会显示在项目页面上,当用户从内容页面或项目预览窗格查看项目时,也会显示该标记。 在项目页面的概览选项卡上,标记用于指示凭据中是包含个人权限,还是仅包含标准权限。

创建用于应用程序身份验证的 OAuth 2.0 凭据

如果您的公共应用程序不需要用户登录,并在服务器端生成访问令牌,请完成以下步骤。

  1. 验证您是否已使用具备创建、更新和删除内容权限的组织账户进行登录。
  2. 单击内容页面的我的内容选项卡,然后单击新建项目
  3. 新建项目窗口中,单击开发人员凭据

    为您显示的第一个窗口可能因您在组织中权限的不同而有所变化。 如果您的成员角色不具备创建 API 密钥的权限,请前进至步骤 5。 如果您的角色具备创建 API 密钥的权限,请前进至步骤 4。

  4. 选择 OAuth 2.0 凭据 — 用于应用程序身份验证选项并单击下一步
  5. 您将在何处使用这些凭据下,选择以下选项之一:
    • 具有所选权限和访问权的私有应用程序 — 要授予对您的任意一组项目和权限的访问权,请选择此选项。 您可以将此嵌入私有应用程序中,或嵌入公共应用程序使用的服务器端组件中。
    • 模拟您身份的私有应用程序 — 要授予您的所有当前权限以及对组织内容、成员和设置的访问权,请选择此选项。
  6. 单击下一步
  7. 或者,如果选择的是具有所选权限和访问权的私有应用程序,请选择以下选项之一:
    • 无项目访问权 — 此凭据不需要任何项目访问权。 单击下一步
    • 通过权限授予项目访问权 — 此凭据要求选择特定权限,才能允许访问项目。 单击下一步
    • 授予对特定项目的访问权 — 必须首先选择您拥有的项目,然后才能授予访问权限。 单击下一步
  8. 或者,如果选择的是具有所选权限和访问权的私有应用程序,请通过分配权限来选择凭据允许该应用程序执行的操作。 单击下一步

    可供您选择的权限列表取决于您是否拥有 ArcGIS Location Platform 订阅,以及您在组织中拥有的权限。 您无法授予您的账户不具备的权限。

    有关权限类型的信息,请参阅 Esri 开发人员帮助中的安全和身份验证指南

  9. 单击下一步
  10. Referrer URL 下,提供允许连接到应用程序的 URL 或 IP 地址。根据需要单击添加以添加更多 referrer URL 或 IP 地址。

    授权期间指定的 URL 必须与已注册 URL 之一匹配,否则授权将被拒绝。

    下面是受支持的 Referrer URL 格式的示例:

    • https://www.example.com/pages
    • https://www.example.com/pages/index.html

  11. 单击下一步
  12. 提供标题。
  13. 我的内容中选择要用于保存项目的文件夹。

    您也可以从菜单中选择创建新文件夹,并输入文件夹名称,将项目保存在新文件夹中。

    文件夹名称不能包含 4 字节 Unicode 字符。

  14. 如果您的组织已设置内容类别,请单击分配类别并最多选择 20 个类别以方便其他用户查找项目。

    您还可以输入类别名称以缩小类别列表范围。

  15. 或者,输入用于描述项目的标签。

    多个术语之间使用逗号进行分隔(例如,Federal land 将被视为一个标签;Federal, land 则被视为两个标签)。

    输入过程中,您可以选择显示的任何建议标签;建议由您之前添加的标签生成。

  16. 或者,添加描述应用程序的摘要。
  17. 单击下一步

    将显示凭据摘要。

  18. 查看凭据摘要。 要更改设置,在创建项目之前单击返回进行更改。
  19. 如果选择的是模拟您身份的私有应用程序,请单击我承认并接受与所选权限相关的安全要求旁边的框。
  20. 单击创建

应用程序即会添加至内容,其项目页面随即显示。 当从内容页面或项目预览窗格查看项目时,将显示表示 OAuth 2.0 凭据的 OAuth 2.0 凭据标记。 如果在您将在何处使用这些凭据下选择模拟您身份的私有应用程序,项目页面的概览选项卡中将显示OAuth 2.0 凭据 - 模拟项目所有者身份标记。

创建 API 密钥凭据

要创建 API 密钥凭据,请完成以下步骤。

  1. 验证您是否已使用组织账户进行登录,以及是否拥有创建 API 密钥内容以及创建、更新和删除内容的权限
  2. 单击内容页面的我的内容选项卡,然后单击新建项目
  3. 新建项目窗口中,单击开发人员凭据
  4. 选择 API 密钥凭据选项,然后单击下一步
  5. 您将在何处使用这些凭据下,选择以下选项之一:
    • 公共应用程序 — 要授予对特定项目和服务权限的访问权,请选择此选项。
    • 具有所选权限和访问权的私有应用程序 — 要授予对您的任意一组项目和权限的访问权,请选择此选项。 您可以将此嵌入私有应用程序中,或嵌入公共应用程序使用的服务器端组件中。
    • 模拟您身份的私有应用程序 — 要授予您的所有当前权限以及对组织内容、成员和设置的访问权,请选择此选项。
  6. 单击下一步
  7. 或者,如果选择的是公共应用程序,请选择以下选项之一:
    • 无项目访问权 — 此凭据不需要任何项目访问权。 单击下一步
    • 授予对特定项目的访问权 — 必须首先选择您拥有的项目,然后单击下一步
  8. 或者,如果选择的是具有所选权限和访问权的私有应用程序,请选择以下选项之一:
    • 无项目访问权 — 此凭据不需要任何项目访问权。 单击下一步
    • 通过权限授予项目访问权 — 此凭据需要具备特定权限,才能允许访问项目。 单击下一步
    • 授予对特定项目的访问权 — 必须首先选择您拥有的项目,然后单击下一步
  9. 或者,如果选择的是公共应用程序具有所选权限和访问权的私有应用程序,请通过分配权限来选择凭据允许该应用程序执行的操作。 单击下一步

    可供您选择的权限列表取决于您是否拥有 ArcGIS Location Platform 订阅,以及您在组织中拥有的权限。 您无法授予您的账户不具备的权限。

    有关权限类型的信息,请参阅 Esri 开发人员帮助中的安全和身份验证指南

  10. 或者,如果选择的是模拟您身份的私有应用程序,请使用日历指定凭据的到期日期。

    凭据可以在次日(最小值)或 365 天(最大值)后过期。 其将在您选择的到期日期的 23:59 到期。 此时间的存储基于您添加应用程序和生成凭据时的浏览器时间。

  11. 引荐来源 URL 下,提供允许连接到应用程序的 URL 或 IP 地址。根据需要单击添加以添加更多引荐来源 URL 或 IP 地址。

    授权期间指定的 URL 必须与已注册 URL 之一匹配,否则授权将被拒绝。

    下面是受支持的 Referrer URL 格式的示例:

    • https://www.example.com/pages
    • https://www.example.com/pages/index.html

  12. 单击下一步
  13. 提供标题。
  14. 我的内容中选择要用于保存项目的文件夹。

    您也可以从菜单中选择创建新文件夹,并输入文件夹名称,将项目保存在新文件夹中。

    文件夹名称不能包含 4 字节 Unicode 字符。

  15. 如果您的组织已设置内容类别,请单击分配类别并最多选择 20 个类别以方便其他用户查找项目。

    您还可以输入类别名称以缩小类别列表范围。

  16. 或者,输入用于描述项目的标签。

    多个术语之间使用逗号进行分隔(例如,Federal land 将被视为一个标签;Federal, land 则被视为两个标签)。

    输入过程中,您可以选择显示的任何建议标签;建议由您之前添加的标签生成。

  17. 或者,添加描述应用程序的摘要。
  18. 单击下一步

    将显示凭据摘要。

  19. 查看凭据摘要。 要更改设置,在创建项目之前单击返回进行更改。
  20. 如果选择的是模拟您身份的私有应用程序,请单击我承认并接受与所选权限相关的安全要求旁边的框。
  21. 单击创建

应用程序即会添加至内容,其项目页面随即显示。 指示已将 API 密钥与应用程序一同嵌入的标记 API 密钥凭据 会显示在项目页面上,当用户从内容页面或项目预览窗格查看项目时,也会显示该标记。 在项目页面的概览选项卡上,标记用于指示凭据中是包含个人权限,还是仅包含标准权限。

相关主题