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

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 (например, Climate FieldView) для запуска потока OAuth конечного пользователя.

Документация по API: oAuthTokens — get OAuth Connection Link

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

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

Примечание.

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

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

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

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

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

  • Last updated on