Configuración de fuentes de datos en Ecoscope

Antes de ejecutar cualquier flujo de trabajo en Ecoscope, primero debe configurar al menos una fuente de datos. Las fuentes de datos proporcionan los datos de entrada que los flujos de trabajo consultan, procesan y visualizan.


Sin una fuente de datos configurada, los flujos de trabajo no pueden recuperar datos y, por lo tanto, no pueden ejecutarse.
 

¿Qué es una fuente de datos?

En Ecoscope, una fuente de datos representa una conexión a un sistema externo que contiene datos operativos, como observaciones GPS, registros de patrulla o registros de eventos.

Las fuentes de datos se pueden configurar en Ecoscope Web o Ecoscope Desktop, dependiendo de cómo se ejecuten los flujos de trabajo.
Una vez conectados, los datos de la fuente están disponibles para los flujos de trabajo correspondientes (como Seguimiento de Sujetos, Eventos o Patrullas). Estos flujos de trabajo utilizan dichos datos para generar mapas, gráficos y métricas resumidas. 
 

Fuentes de datos compatibles

Las fuentes de datos disponibles actualmente difieren ligeramente dependiendo de si se utiliza Ecoscope Web o Ecoscope Desktop.

Ecoscope Web

Actualmente es compatible con:

  • EarthRanger
  • Motor de búsqueda de Google Earth

Se prevé la compatibilidad futura con plataformas adicionales como SMART y otros proveedores de datos de conservación.

Ecoscope Desktop

Ecoscope Desktop admite integraciones adicionales diseñadas para flujos de trabajo más avanzados y entornos sin conexión, entre las que se incluyen:

  • EarthRanger
  • ELEGANTE
  • Motor de búsqueda de Google Earth

Las integraciones de escritorio permiten a los usuarios configurar las conexiones localmente y pueden requerir la importación de credenciales o archivos de configuración en lugar de introducirlos directamente en un formulario.

Nota de escritorio de Ecoscope
En Ecoscope Desktop, las credenciales no siempre se validan durante la configuración inicial. Si las credenciales o los parámetros de configuración son incorrectos, es posible que solo aparezcan errores al ejecutar el flujo de trabajo.

 

Conectar una fuente de datos

Conecta Ecoscope Web con EarthRanger para usar los datos de seguimiento, eventos y patrullaje de tu sitio en los flujos de trabajo. Después de ingresar la URL de tu sitio, Ecoscope verifica cómo tu sitio EarthRanger gestiona el inicio de sesión y muestra el siguiente paso correcto:

  • Nombre de usuario y contraseña: su sitio utiliza las credenciales estándar EarthRanger . Esto se aplica actualmente a la mayoría de los sitios.
  • Inicio de sesión EarthRanger : su sitio web utiliza EarthRanger Identity y usted inicia sesión con su dirección de correo electrónico en una nueva pestaña del navegador.

Para iniciar una conexión:

  1. Ve a la pestaña Fuentes de datos y haz clic en Conectar .
  2. En Seleccionar tipo de fuente de datos , seleccione EarthRanger .
  3. Introduzca la URL EarthRanger y un nombre para la fuente de datos , y haga clic en Siguiente .

Lo que veas a continuación depende de tu sitio web.

Con EarthRanger Iniciar sesión

Si su sitio web utiliza EarthRanger Identity, la página de inicio de sesión EarthRanger se abrirá en una nueva pestaña del navegador.

  1. Introduce tu dirección de correo electrónico, haz clic en Continuar e inicia sesión.
  2. Cuando veas el mensaje "Autenticación exitosa" , regresa a la pestaña original de Ecoscope.
  3. Ecoscope muestra que Ecoscope se ha conectado correctamente con EarthRanger . Haga clic en Listo .

Si su sitio requiere una verificación de seguridad adicional

Algunos sitios EarthRanger requieren autenticación multifactor (MFA). Si tu sitio la requiere, hay un paso más después de volver a Ecoscope:

  1. Ecoscope muestra que se requiere autenticación adicional . Haga clic en Continuar .
  2. Se abrirá una nueva pestaña del navegador con el mensaje "Verifica tu identidad" . Introduce el código de un solo uso de tu aplicación de autenticación.
  3. Haz clic en Continuar . Cuando veas Autenticación exitosa , vuelve a la pestaña Ecoscope y haz clic en Listo .
 

 

Con nombre de usuario y contraseña

 

Si su sitio utiliza las credenciales estándar EarthRanger , aparecerá una sección de inicio de sesión de la cuenta de EarthRanger debajo de los campos que haya rellenado.

  1. Introduzca su nombre de EarthRanger y contraseña EarthRanger .
  2. Haz clic en Conectar .

 

Cómo conectar una fuente de datos de Google Earth Engine (Web y Escritorio)

Las conexiones con Google Earth Engine funcionan igual tanto en Ecoscope Web como en Ecoscope Desktop. Antes de conectarse, necesitará una cuenta de servicio de Google Cloud con acceso a Earth Engine y una clave privada JSON descargada.

Paso 1: Crea una cuenta de servicio en Google Cloud.

  1. Confirma que la API de Earth Engine esté habilitada en tu proyecto de Google Cloud (regístrate en code.earthengine.google.com/register si aún no lo has hecho).
  2. Abra la consola de Google Cloud y navegue a IAM y administración → Cuentas de servicio .
  3. Haga clic en + Crear cuenta de servicio .
  4. Proporcione un nombre y (opcionalmente) una descripción para la cuenta.
  5. En la sección Permisos, asigne un rol de Earth Engine: Administrador de recursos o Redactor de recursos para la mayoría de los flujos de trabajo, o Visor de recursos para el acceso de solo lectura a los datos públicos.
  6. Haz clic en Listo para finalizar la creación de la cuenta y anota el correo electrónico de la cuenta de servicio generado automáticamente (termina en .iam.gserviceaccount.com ).

     

Paso 2: Generar una clave privada

  1. Abra la cuenta de servicio recién creada.
  2. Dirígete a la pestaña "Teclas" .
  3. Haz clic en Agregar clave → Crear nueva clave .
  4. Seleccione JSON como tipo de clave.
  5. Haz clic en Crear : se descargará un archivo .json en tu ordenador. Esta es la única copia; guárdala en un lugar seguro.

Este archivo contiene el correo electrónico de la cuenta de servicio, el ID del proyecto y las credenciales de autenticación que necesita Earth Engine.

⚠️ Mantén este archivo seguro. La clave JSON te da acceso a tu cuenta de servicio de Google Earth Engine. Trátala como una contraseña: no la compartas, no la incluyas en el control de versiones ni la pegues en herramientas de chat.

 

 

Paso 3: Conectar la fuente de datos en Ecoscope.

En Ecoscope Web o Desktop, vaya a Fuentes de datos → Conectar fuente de datos (Web) o Fuentes de datos y seleccione el tipo (Desktop), luego elija Google Earth Engine y complete:

  • Nombre de la fuente de datos : una etiqueta que reconocerás más adelante.
  • Clave privada : busque y seleccione el archivo de clave .json que descargó.
  • Correo electrónico de la cuenta de servicio : termina en .iam.gserviceaccount.com .
  • ID del proyecto : Su ID de proyecto de Google Cloud.

Las credenciales se validan únicamente en tiempo de ejecución. Las conexiones a Google Earth Engine, tanto en la versión web como en la de escritorio, no se comprueban al guardar la fuente de datos. Si se rechaza la clave, se especifica un proyecto incorrecto o la cuenta de servicio no tiene acceso a Earth Engine, el error solo aparecerá la primera vez que un flujo de trabajo utilice la conexión.

 

Utilizar la conexión en un flujo de trabajo

Cualquier flujo de trabajo que incluya una sección "Conectar con Earth Engine" (por ejemplo, el flujo de trabajo NDVI ) ofrecerá esta fuente de datos en el menú desplegable.

Conexión de fuentes de datos en Ecoscope Desktop

En Ecoscope Desktop, las fuentes de datos se configuran localmente dentro de la aplicación.

A diferencia de Ecoscope Web, las integraciones de escritorio pueden requerir la importación de archivos de credenciales o la especificación de parámetros de configuración, según la fuente. La versión de escritorio también permite la conexión a fuentes de datos adicionales diseñadas para flujos de trabajo más avanzados o entornos donde los servicios en la nube no estén disponibles.

El proceso general es el siguiente:

  1. Abra la sección Fuentes de datos en Ecoscope Desktop.
  2. Seleccione el tipo de fuente de datos que desea configurar.
  3. Proporcione las credenciales o los archivos de configuración necesarios.
  4. Guarda la configuración para que la fuente de datos esté disponible para los flujos de trabajo.

Los pasos de configuración específicos varían según la fuente de datos.

EarthRanger (Escritorio)

Las fuentes de datos EarthRanger permiten que los flujos de trabajo de Ecoscope Desktop accedan a los datos de seguimiento, eventos y patrullaje de su sitio EarthRanger . Dependiendo de su sitio, la conexión se realiza mediante el inicio de sesión EarthRanger o con su nombre de usuario y contraseña EarthRanger .


Para configurar una fuente de datos EarthRanger :
1. Abra la sección Fuentes de datos en Ecoscope Desktop.
2. Seleccione EarthRanger como tipo de fuente de datos.
3. Introduzca la URL EarthRanger (la parte anterior a .pamdas.org) y un nombre para la fuente de datos.
4. Complete la conexión utilizando uno de los métodos que se indican a continuación.
 

Con el inicio de sesión EarthRanger
 

Algunos sitios EarthRanger requieren un paso adicional de autenticación multifactor. Si su sitio utiliza esta opción, después de hacer clic en «Volver a Ecoscope», Ecoscope Desktop mostrará un mensaje que indica que se requiere autenticación adicional y deberá hacer clic en un botón para volver a abrir la página de inicio de sesión EarthRanger . Inicie sesión por segunda vez y repita los pasos 3 y 4 para finalizar la conexión.

 

 

1. Haga clic en Siguiente . Su navegador web abrirá la página de inicio de sesión EarthRanger .
2. Inicia sesión con tu cuenta EarthRanger . Si ya has iniciado sesión, este paso se omite.
3. Haga clic en Aceptar para permitir que Ecoscope Desktop acceda a su cuenta EarthRanger .
4. Haga clic en Volver a Ecoscope y, a continuación, haga clic en Listo en Ecoscope Desktop.
 

Si la opción «Volver a Ecoscope» no funciona, haga clic en «¿Tiene problemas para volver?» en su navegador y copie el código de autenticación. En Ecoscope Desktop, haga clic en «Finalizar conexión manualmente», pegue el código y haga clic en «Completar conexión».

 

 

Con nombre de usuario y contraseña

1. En la sección "Iniciar sesión en la cuenta de EarthRanger , ingrese su nombre de usuario y contraseña EarthRanger .
2. Haz clic en Conectar.
Las credenciales introducidas de esta forma no se validan durante la configuración. Si son incorrectas, los errores solo aparecerán al ejecutar un flujo de trabajo.
Una vez conectada, la fuente de datos EarthRanger estará disponible al configurar flujos de trabajo que admitan datos EarthRanger .
 

SMART (Escritorio)

Las fuentes de datos SMART permiten que los flujos de trabajo de Ecoscope Desktop accedan a los datos de patrullaje y eventos almacenados en una base de datos SMART.

Para configurar una fuente de datos SMART:

  1. Abra la sección Fuentes de datos en Ecoscope Desktop.
  2. Seleccione SMART como tipo de fuente de datos.
  3. Proporcione los detalles de conexión SMART necesarios.
  4. Guarda la configuración.

Una vez guardada, la fuente de datos SMART estará disponible al configurar flujos de trabajo que admitan datos SMART.

 

Visualización y gestión de fuentes de datos existentes 
 

 

Todas las fuentes de datos configuradas aparecen en la vista de lista en la pestaña Fuentes de datos. Cada fila muestra información clave:

  • Nombre de la fuente de datos : el nombre personalizado que le diste a la conexión.
  • Dominio : la URL o el dominio de la instancia EarthRanger conectada.
  • Tipo de conexión : Actualmente limitado a EarthRanger , pero próximamente se añadirán más opciones.
  • Fecha de creación : marca de tiempo en la que se agregó la conexión.
  • Actualizado en : Marca de tiempo de la última actualización o reconfiguración exitosa.
     

 

¿Cuándo es necesaria una actualización?

En Ecoscope Web, los tokens de autenticación entre Ecoscope y su instancia EarthRanger pueden caducar con el tiempo.
Cuando esto ocurra, se le pedirá que vuelva a conectar la fuente de datos antes de ejecutar nuevos flujos de trabajo.

En Ecoscope Desktop, si utiliza EarthRanger IdP, los tokens pueden caducar con el tiempo.
Cuando esto ocurra, se le pedirá que vuelva a conectar la fuente de datos antes de ejecutar nuevos flujos de trabajo.

Se trata de una medida de seguridad habitual que garantiza que las conexiones permanezcan autenticadas y seguras.

En Ecoscope Desktop, si utiliza una fuente de datos EarthRanger autenticada con un nombre de usuario y una contraseña, los tokens de autenticación se crean sobre la marcha cuando son necesarios y se almacenan únicamente en la memoria, por lo que no se aplican los flujos de reconexión.