Интеграция с поставщиком данных действий фермы

  • Статья

Azure Data Manager для сельского хозяйства поддерживает соединители для удобной синхронизации данных конечных пользователей из ряда источников данных сельскохозяйственных машин. Настройка включает настройку потока oAuth в качестве предварительных требований для интеграции с любым поставщиком данных действий фермы, а также прозрачного шага согласия для каждой учетной записи, который обрабатывает начальную и добавочную синхронизацию данных, чтобы обеспечить актуальность актива данных ADMA.

Примечание.

Шаги 1–3 являются частью одноразовой конфигурации для каждого поставщика. После интеграции вы сможете разрешить всем конечным пользователям использовать существующий рабочий процесс oAuth и вызвать API конфигурации (шаг 4) для каждого пользователя (PartyID), чтобы получить маркер доступа.

Настройка поставщика

Пример потока здесь использует 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 для сельского хозяйства, могут использовать FieldView в качестве поставщика для получения данных о действиях фермы.

Шаг 3. Конфигурация конечной точки

Конечная точка перенаправления пользователей: эта конечная точка должна быть перенаправлена пользователями после завершения потока OAuth. Эта конечная точка будет создана вами и предоставлена ADMA, как userRedirectLink в API oauth/token/:connect. Зарегистрируйте конечную точку обратного вызова oAuth в приложении на портале Climate FieldView.

Настройка учетной записи конечного пользователя

Шаг 4. Интеграция стороннего пользователя

Когда сторона (конечный пользователь) приземляется на веб-странице, где ожидается действие пользователя (например, Подключение к FieldView, кнопка), выполните вызов oauth/tokens/:connect API следующим образом, чтобы получить uri входа поставщика oAuth (Ex: Climate FieldView) для запуска потока oAuth.

Документация по API: oAuthTokens — Get OAuth Подключение ion Link

oauth/tokens/:connect После успешного возврата oauthAuthorizationLinkAPI конечный пользователь щелкает эту ссылку, чтобы завершить поток oAuth (например, для Climate FieldView, пользователь получает согласие на доступ FieldView и страницу входа). После завершения входа ADMA перенаправит пользователя на конечную точку, предоставленную клиентом (userRedirectLink) со следующими параметрами запроса в URL-адресе.

  1. status (success/failure)
  2. состояние (необязательная строка для уникальной идентификации пользователя в конце клиента)
  3. message (необязательная строка)
  4. errorCode (необязательная строка, отправленная для ошибки или ошибки) в параметрах.

Примечание.

Если API возвращает 404, он подразумевает сбой потока OAuth, и ADMA не удалось получить маркер доступа.

Шаг 5. Проверка сведений о маркере доступа (необязательно)

Этот шаг является необязательным, только чтобы подтвердить, если для данного пользователя или списка пользователей необходимый допустимый маркер доступа был получен или нет. Это можно сделать с помощью вызова oauth/tokens API для проверка записи isValid: true в тексте ответа.

Документация по API: oAuthTokens — List

Этот шаг помечает успешное завершение потока OAuth для пользователя. Теперь пользователь должен активировать новый FarmOperationsDataJob , чтобы начать извлечение данных о действиях фермы из Climate FieldView.