¿Cómo me incorporo a eero Data Portability como tercero?

eero Data Portability o la Portabilidad de datos de eero, ofrece a terceros autorizados la capacidad de importar mediante programación los datos de los clientes de eero a una aplicación o sitio web, una vez que los clientes otorguen autorización a través de su cuenta eero.

Este documento explica cómo funciona eero Data Portability y los pasos que debe seguir para que su aplicación o sitio web pueda importar los datos de los clientes. Esta función está disponible actualmente solo para clientes cuya red se encuentra físicamente ubicada en la Unión Europea.

Flujo de trabajo de eero Data Portability

Desde la aplicación o sitio web de su organización, se mostrará una página de eero donde el cliente podrá iniciar sesión y comenzar a importar los datos de su dispositivo eero utilizando las credenciales de su cuenta eero existente o iniciando sesión con su cuenta Amazon. Antes de cualquier transferencia de datos, eero mostrará un mensaje de aviso informando a los clientes sobre los permisos necesarios para compartir datos.

En la página de autorización, los clientes pueden seleccionar Continuar o Cancelar.

Si el cliente selecciona Cancelar, el flujo de trabajo finaliza. Su aplicación no tendrá la capacidad de importar los datos de ese cliente.
Si el cliente selecciona Confirmar, eero muestra la página de Preferencias de uso compartido de datos.

En la página de Preferencias de uso compartido de datos, eero ofrece opciones para que los clientes establezcan sus preferencias, confirmen la autorización y seleccionen el botón Cancelar o Autorizar.

Si el cliente selecciona el botón Autorizar, se activa eero Data Portability en su aplicación, otorgando autorización para importar los datos de ese cliente.
Si el cliente selecciona Cancelar, su aplicación no estará autorizada para importar los datos de ese cliente.

Tras la incorporación, recibirá un ‘client_id’ y un ‘client_secret,’ que se utilizan para las interacciones posteriores con la API OAuth 2.0. Una vez que el cliente seleccione Autorizar, iniciará el flujo OAuth con eero. Su organización guardará el código de autorización proporcionado en la respuesta HTTP. Utilizará este código de autorización y su ‘client secret’ para solicitar un token de acceso y un token de actualización. Guarde el token de acceso y utilícelo para llamar a la API de eero Data Portability. Los tokens de acceso caducan automáticamente, por lo que debe guardar el token de actualización para obtener futuros tokens de acceso.

Preferencias de uso compartido de datos

Los datos que se transfieren a su aplicación dependen de las preferencias establecidas por el cliente en la página de Preferencias de uso compartido de datos.

¿Durante cuánto tiempo desea conceder acceso?

Los clientes seleccionan durante cuánto tiempo su aplicación puede importar datos eligiendo una fecha futura dentro de los siguientes plazos:

1 día
30 días
90 días
180 días
1 año

Una vez que expire el período seleccionado, su aplicación no podrá importar datos del cliente a menos que este proporcione una nueva autorización. La autorización finaliza cuando un cliente revoca el acceso o cuando los tokens caducan.

Pasos para incorporarse a eero

Envíe un correo electrónico a eero-data-portability-intake@amazon.com con los siguientes datos para iniciar el proceso de incorporación:
- Dirección de correo electrónico
- Nombre de la empresa
- Dirección de la empresa
- Nombre del propietario de la empresa o representante legal
- Adjunte la licencia comercial al correo electrónico
Responda a los correos electrónicos, consultas e invitaciones a reuniones de los equipos de eero/Amazon para ayudar a iniciar el proceso de incorporación.
Se compartirá un cuestionario tras validar los datos anteriores. Rellene los datos y compártalos para su validación adicional.
Responda a los correos electrónicos y consultas durante la Evaluación de seguridad de terceros hasta su finalización satisfactoria.
Envíe un correo electrónico a privacy@eero.com para iniciar el proceso de integración con las API de eero y comparta el ID de la TPSA (Evaluación de seguridad de terceros) como referencia. eero le proporcionará un acuerdo de no divulgación (NDA). Una vez ejecutado el NDA, eero le enviará la documentación completa por correo electrónico.
Habilite la experiencia del cliente (CX) en el sitio web y la aplicación del tercero (3P).

Autorice su aplicación con la API de eero Portability

El acceso a las API de eero se concede mediante el protocolo OAuth 2.0. Su aplicación deberá integrarse con las API REST OAuth de eero. Las API de eero siguen el protocolo estándar de concesión de código de autorización (https://oauth.net/2/grant-types/authorization-code/) sin PKCE (https://oauth.net/2/pkce/). Cuando un cliente le autorice como tercero, recibirá un código de autorización. El código y su client secret (proporcionado previamente) pueden intercambiarse por Bearer Access Tokens (https://oauth.net/2/access-tokens/) y Refresh Tokens (https://oauth.net/2/refresh-tokens/).

Estos tokens de acceso caducan automáticamente en un tiempo configurable. Una vez que sus tokens de acceso hayan caducado, los tokens de actualización pueden canjearse por nuevos tokens de acceso. Tenga en cuenta que cuando el cliente le autorice, especificará una duración de autorización. Una vez alcanzada esta duración (por ejemplo, 1 año), todos sus tokens de acceso y tokens de actualización serán revocados. El cliente y eero también tendrán la capacidad de revocar el acceso manualmente en cualquier momento. Una vez revocado o caducado, el cliente deberá volver a autorizarle si aún desea sus servicios.

Se proporcionará una especificación completa de la API una vez que haya completado la Evaluación de seguridad de terceros y esté listo para la incorporación. Se espera que desarrolle su aplicación en torno a las API de eero, que pueden llamarse directamente, ya que no proporcionamos bibliotecas adicionales. En términos generales, necesitaremos de su parte:

El nombre de su empresa (lo que los clientes verán al autorizar)
Sus URI de redirección. Solo enrutamos a sus URI de confianza.
Prueba de que su aplicación gestiona el código de autorización en el lado del servidor. Actualmente no admitimos aplicaciones del lado del cliente.

Una vez que dispongamos de esta información, crearemos su cliente y le proporcionaremos sus credenciales de cliente para futuras solicitudes autenticadas mediante OAuth a la API de eero Portability.

Conecte su aplicación con la API de eero Portability

Una vez creado su cliente, dispondrá de un Client Id y un Client Secret. Puede utilizarlos para crear tokens de acceso en nombre de los clientes, tal como se describe en «Autorice su aplicación». Estos Bearer Tokens se pasarán como encabezados a la API de eero Portability para recuperar información relacionada con el cliente. Las API de eero son de tipo REST y todo el acceso es de solo lectura. Las categorías de datos que proporcionamos son:

Configuración de red: Preferencias y configuraciones de redes eero, como SSID de red, contraseñas y configuraciones de copia de seguridad.
Datos del dispositivo eero: Datos sin procesar del dispositivo eero, como direcciones MAC, direcciones IP y versiones de firmware.
Gestión de dispositivos: Datos de dispositivos del cliente, como alias y perfiles asociados a dispositivos, dispositivos pausados y bloqueados.
Seguridad y acceso: Configuraciones especificadas por el cliente, como reglas de firewall y reenvío de puertos.

Se proporcionará una especificación completa de la API una vez que haya completado la Evaluación de seguridad de terceros y se haya incorporado.