使用身份验证

ArcGIS Velocity 需要 ArcGIS Online 的访问权限，才能创建项目（如源和分析），运行项目（如来自要素图层的源），以及将要素写入到输出要素图层。 Velocity 不存储用户名和密码，而是使用刷新令牌或 ArcGIS API 密钥来执行身份验证和连接 ArcGIS Online。

您可以同时拥有一个 ArcGIS API 密钥和一个已在 Velocity 中注册的刷新令牌。 在此类情况下，Velocity 使用 ArcGIS API 密钥，不使用刷新令牌。 如果 ArcGIS API 密钥到期或失效，Velocity 将尝试改为使用刷新令牌来创建和运行项目。

身份验证机制

以下部分介绍这两种身份验证方法的工作原理，以及 Velocity 如何使用它们。

刷新令牌

刷新令牌是短期有效的访问令牌，其默认有效期为 2 周。 为了确保源和分析长时间运行，Velocity  设置了机制来识别刷新令牌何时即将到期。 Velocity 会自动请求和更新这些令牌。

了解有关如何创建刷新令牌的详细信息

ArcGIS API 密钥

ArcGIS API 密钥是长期有效的访问令牌，其有效期为 1 天到 1 年。 您需要在创建 ArcGIS API 密钥时定义其到期值。 建议将到期值设置为 1 年。 您的 ArcGIS Online 用户账户必须拥有创建 ArcGIS API 密钥所需权限。

详细了解有关使用 ArcGIS API 密钥的注意事项和局限性的信息

在 ArcGIS Online 中创建 API 密钥

注：

必须首先在 ArcGIS Online 中创建 API 密钥，然后在 Velocity 中注册该 ArcGIS API 密钥。

要创建 API 密钥，请完成以下步骤：

1. 在浏览器中打开 ArcGIS Online，然后使用您的 ArcGIS 组织凭据登录。
2. 在您的门户中，单击内容 > 我的内容 > 新建项目。

   

3. 单击开发者凭据 > API 密钥凭据，然后单击下一步。

   

4. 选择模拟您身份的私有应用程序选项，然后单击下一步。

   

5. 在创建开发者凭据窗口中，执行以下操作：
   1. 单击到期日期（必填）参数，然后设置 API 密钥的到期日期。

      注：

      最小到期日期为 1 天，最大到期日期为 1 年。 建议将到期日期设置为 1 年。

   2. 提供引用者 URL 参数值，然后单击下一步。

      键入以下引用者 URL 值：https://*.arcgis.com。

      

   3. 在项目详细信息部分中，为标题参数提供值为 API 密钥项目命名，然后单击下一步。

      

   4. 选中我了解并确认所选权限的功能消息复选框，然后单击下一步。

      

   5. 选择有关何时生成 API 密钥的选项，然后单击下一步。

      可用选项如下：

      • 立即生成 API 密钥。 我已准备就绪，可以复制和保存密钥。
      • 转至项目详细信息页面。 我将稍后生成 API 密钥。

      

6. 在生成 API 密钥页面中，复制生成的 API 密钥，然后单击关闭。

   注：

   请务必复制您的 API 密钥，因为这是您唯一可访问它的机会。

   

7. 在项目详细信息页面中，转至设置 > 常规打开常规页面。

   建议开启删除管理切换按钮，以防止此项目被误删。

   

8. 在常规页面中，将鼠标悬停在到期文本上方可查看完整的 API 密钥到期日期。

   返回值采用您的本地时区。

   

完成上面的步骤之后，您已在 ArcGIS Online 中创建了一个可在 Velocity 中注册的 API 密钥。

了解有关在 ArcGIS Online 中创建 API 密钥凭据的详细信息

在 Velocity 中注册 ArcGIS API 密钥

在 ArcGIS Online 中生成 API 密钥之后，可以在 Velocity 中注册。

要在 Velocity 中注册 ArcGIS API 密钥，请完成以下步骤：

1. 在浏览器中打开 Velocity 应用程序，然后使用您的 ArcGIS 组织凭据登录。
2. 单击查看身份验证机制按钮 展开身份验证机制下拉菜单。

   

3. 单击更新身份验证机制打开配置身份验证机制对话框。
4. 选择 ArcGIS API 密钥选项，然后单击下一步。

   

5. 将您在上一部分中创建的 API 密钥粘贴到 ArcGIS API 密钥文本框中。
6. 将到期日期选项设置为您在上一部分中选择的同一天。
7. 单击确认。

   

   完成上述步骤后，您将收到成功消息。 请注意，ArcGIS API 密钥已注册切换按钮在身份验证机制下拉菜单中已开启，这说明您已注册了一个 ArcGIS API 密钥。

   

   了解有关注册和创建 ArcGIS API 密钥的详细信息

注意事项和限制

在 Velocity 中使用 ArcGIS API 密钥时，请注意以下事项：

• 目前，当注册的 ArcGIS API 密钥即将到期时，Velocity 不会发送电子邮件通知。

• 在 ArcGIS Online 账户中，如果创建开发者凭据菜单中没有 API 密钥凭据选项，则说明您的账户可能没有相应权限。 您的账户需要具备创建授权并将其分配给 API 密钥凭证的权限。

  您可以在成员角色页面中编辑常规权限。 要打开成员角色页面，请转至组织 > 设置 > 成员角色。

  在管理角色部分中成员角色下，可以查看 ArcGIS Online 中的所有现有角色。 单击角色旁边的更多选项按钮，然后选择编辑选项打开编辑角色窗口。

  

  在编辑角色窗口中，展开常规权限  > 内容，然后打开生成 API 密钥和为 OAuth 2.0 应用程序分配权限切换按钮创建授权并分配给 API 密钥凭据。

  

  注：

  如果缺少这些权限，请联系您所在组织的管理员，以便为您的角色授予必要权限。

• 用户账户必须拥有 Velocity 项目的访问权限，才能使用该用户在 Velocity 中创建的 API 密钥。