你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

与服务器场活动数据提供程序集成

  • 项目

Azure Data Manager for Agriculture 支持连接器，以便方便地同步来自一系列服务器场机械数据源的最终用户数据。 该设置涉及 将 oAuth 流配置为与任何服务器场活动数据提供程序集成的先决条件，以及处理初始和增量数据同步的每个帐户透明同意步骤，以便使 ADMA 数据资产保持最新。

注意

步骤 1 到 3 是每个提供程序一次性的初始配置的一部分。 集成后，你将能够让所有最终用户使用现有的 oAuth 工作流，并调用每个用户的配置 API（步骤 4）来检索访问令牌。

提供程序安装程序

此处的示例流使用 Climate FieldView

步骤 1：应用创建

如果应用程序尚未注册到 Climate Fieldview，请转到 FieldView 门户 并提交表单。 一旦 FieldView 处理请求，它们就会发送你的 client_id 请求，并且 client_secret 每个 ADMA 实例对 FieldView 使用一次。

步骤 2：提供程序配置

oAuthProvider使用 API 通过新创建的应用的相应凭据创建或更新 oAuth 提供程序（例如：FIELDVIEW）。

API 文档： oAuthProviders - 创建或更新

可选步骤： 操作完成后，可以运行 oAuthProviders_Get 来验证应用程序是否已注册。 现在，在 Azure Data Manager for Agriculture 实例中创建的所有参与方都可以使用 FieldView 作为提供程序来提取服务器场活动数据。

步骤 3：终结点配置

用户重定向终结点：此终结点是希望在 oAuth 流完成后将用户重定向到的位置。 此终结点将由你生成，并将其提供给 ADMA，如 userRedirectLink oauth/tokens/：connect API 中所示。 在 Climate FieldView 门户中向应用注册 oAuth 回调终结点。

最终用户帐户设置

步骤 4：Party （最终用户） 集成

当一方（最终用户）登陆你的网页时（例如：连接到 FieldView 按钮），使用以下方式调用 oauth/tokens/:connect API 以获取 oAuth 提供程序（例如：Climate FieldView）登录 URI 以启动最终用户 oAuth 流。

API 文档：oAuthTokens - 获取 OAuth 连接ion 链接

oauth/tokens/:connect API 成功返回oauthAuthorizationLink后，最终用户单击此链接以完成 oAuth 流（例如：对于 Climate FieldView，将为用户提供 FieldView 访问许可和登录页）。 登录完成后，ADMA 会将用户重定向到客户提供的终结点（userRedirectLink）URL 中的以下查询参数

  1. 状态 （成功/失败）
  2. 状态 （用于唯一标识客户端的用户的可选字符串）
  3. 消息 （可选字符串）
  4. 参数中的 errorCode （为 Failure/error 发送的可选字符串）。

注意

如果 API 返回 404，则表示 oAuth 流失败，ADMA 无法获取访问令牌。

步骤 5：检查访问令牌信息（可选）

此步骤是可选的，仅确认对于给定用户或用户列表，是否已获取所需的有效访问令牌。 可以通过调用 API 来完成此操作，oauth/tokens以便为响应正文中的条目isValid: true检查。

API 文档： oAuthTokens - 列表

此步骤标志着用户 oAuth 流成功完成。 现在，用户已全部设置为触发新的 FarmOperationsDataJob ，开始从 Climate FieldView 拉取服务器场活动数据。