Compartir a través de

Integración con el proveedor de datos de actividades de granja de servidores

  • Artículo

Azure Data Manager for Agriculture admite conectores para sincronizar convenientemente los datos de los usuarios finales de una variedad de orígenes de datos de maquinaria de granja de servidores. La configuración implica configurar el flujo de oAuth como requisito previo para la integración con cualquier proveedor de datos de actividades de granja de servidores, junto con un paso de consentimiento transparente por cuenta que controla la sincronización de datos inicial e incremental para mantener actualizado el patrimonio de datos de ADMA.

Nota:

Los pasos 1 a 3 forman parte de la configuración inicial única por proveedor. Una vez integrado, podrá permitir que todos los usuarios finales usen el flujo de trabajo de oAuth existente y llamen a la API de configuración (paso 4) por usuario (PartyID) para recuperar el token de acceso.

Configuración del proveedor

El flujo de ejemplo aquí usa Climate FieldView

Paso 1: Creación de aplicaciones

Si la aplicación aún no está registrada con Climate Fieldview, vaya al portal FieldView y envíe el formulario. Una vez que FieldView procesa la solicitud, envían client_id y client_secret las usará una vez por instancia de ADMA para FieldView.

Paso 2: Configuración del proveedor

Use la oAuthProvider API para crear o actualizar el proveedor de oAuth (por ejemplo: FIELDVIEW) con las credenciales adecuadas de la aplicación recién creada.

Documentación de la API: oAuthProviders- Create Or Update

Paso opcional: una vez finalizada la operación, puede ejecutar el oAuthProviders_Get para comprobar si la aplicación está registrada. Ahora, todas las partes creadas en la instancia de Azure Data Manager for Agriculture pueden usar FieldView como proveedor para capturar datos de actividades de granja de servidores.

Paso 3: Configuración del punto de conexión

Punto de conexión de redirección de usuario: este punto de conexión es donde desea que los usuarios se redirijan una vez completado el flujo de oAuth. El usuario generará este punto de conexión y se proporcionará a ADMA como userRedirectLink en la API oauth/tokens/:connect. Registre el punto de conexión de devolución de llamada de oAuth con la aplicación en el portal de Climate FieldView.

Configuración de la cuenta de usuario final

Paso 4: Integración de terceros (usuario final)

Cuando una entidad (usuario final) llega a la página web donde se espera la acción del usuario (por ejemplo: Conectar al botón FieldView), realice una llamada a oauth/tokens/:connect la API de la manera siguiente para obtener el URI de inicio de sesión del proveedor de oAuth (por ejemplo, Climate FieldView) para iniciar el flujo de oAuth del usuario final.

Documentación de la API: oAuthTokens: obtener OAuth Conectar ion Link

Una vez que la oauth/tokens/:connect API devuelve correctamente , el oauthAuthorizationLinkusuario final hace clic en este vínculo para completar el flujo de oAuth (por ejemplo: Para Climate FieldView, el usuario recibe un consentimiento de acceso de FieldView y una página de inicio de sesión). Una vez completado el inicio de sesión, ADMA redirigirá al usuario al punto de conexión proporcionado por el cliente (userRedirectLink) con los siguientes parámetros de consulta en la dirección URL.

  1. estado (correcto/error)
  2. state (cadena opcional para identificar de forma única al usuario al final del cliente)
  3. message (cadena opcional)
  4. errorCode (cadena opcional enviada para Error/error) en los parámetros.

Nota:

Si la API devuelve 404, implica que se produjo un error en el flujo de oAuth y ADMA no pudo adquirir el token de acceso.

Paso 5: Comprobar la información del token de acceso (opcional)

Este paso es opcional, solo para confirmar si para un usuario determinado o una lista de usuarios, se ha adquirido o no el token de acceso válido necesario. Esto se puede hacer mediante la realización de una llamada a la oauth/tokens API para comprobar la entrada isValid: true en el cuerpo de la respuesta.

Documentación de api: oAuthTokens - List

Este paso marca la finalización correcta del flujo de oAuth para un usuario. Ahora, el usuario está todo configurado para desencadenar un nuevo FarmOperationsDataJob para empezar a extraer los datos de actividades de granja de datos de Climate FieldView.