Wie führe ich das Onboarding mit eero Data Portability als Drittanbieter durch?

eero Data Portability bietet autorisierten Drittanbietern die Möglichkeit, Daten von eero-Kunden programmgesteuert in eine App oder Website zu importieren, nachdem Kunden die Autorisierung über ihr eero-Konto erteilt haben.

Dieses Dokument erklärt, wie eero Data Portability funktioniert, und die Schritte, die Sie unternehmen müssen, damit Ihre App oder Website Kundendaten importieren kann. Diese Funktion ist derzeit nur für Kunden verfügbar, die ein Netzwerk haben, das sich physisch in der Europäischen Union befindet.

eero Data Portability Workflow

Von der App oder Website Ihrer Organisation aus wird eine eero-Seite angezeigt, auf der sich der Kunde anmelden und mit dem Import seiner eero-Gerätedaten beginnen kann, indem er seine bestehenden eero-Kontoanmeldedaten verwendet oder sich mit seinem Amazon-Konto anmeldet. Vor jeder Datenübertragung zeigt eero eine Haftungsausschlussmeldung an, die Kunden über die erforderlichen Berechtigungen für die Datenfreigabe informiert.

Auf der Autorisierungsseite können Kunden Fortfahren oder Abbrechen auswählen.

Wenn der Kunde Abbrechen auswählt, endet der Workflow. Ihre Anwendung hat nicht die Möglichkeit, die Daten dieses Kunden zu importieren.
Wenn der Kunde Bestätigen auswählt, zeigt eero die Seite Datenfreigabe-Einstellungen an.

Auf der Seite Datenfreigabe-Einstellungen bietet eero Optionen für Kunden, um ihre Einstellungen festzulegen, die Autorisierung zu bestätigen und die Schaltfläche Abbrechen oder Autorisieren auszuwählen.

Wenn der Kunde die Schaltfläche Autorisieren auswählt, aktiviert dies eero Data Portability in Ihrer Anwendung und erteilt die Autorisierung zum Import der Daten dieses Kunden.
Wenn der Kunde Abbrechen auswählt, wird Ihre Anwendung nicht autorisiert, die Daten dieses Kunden zu importieren.

Nach dem Onboarding erhalten Sie eine 'client_id' und ein 'client_secret', die für nachfolgende OAuth 2.0 API-Interaktionen verwendet werden. Sobald der Kunde Autorisieren auswählt, initiieren Sie den OAuth-Flow mit eero. Ihre Organisation speichert den in der HTTP-Antwort bereitgestellten Autorisierungscode. Sie verwenden diesen Autorisierungscode und Ihr 'client secret', um ein Access Token und ein Refresh Token anzufordern. Speichern Sie das Access Token und verwenden Sie es, um die eero Data Portability API aufzurufen. Access Tokens laufen automatisch ab, speichern Sie daher das Refresh Token, um zukünftige Access Tokens zu erhalten.

Datenfreigabe-Einstellungen

Die Daten, die in Ihre Anwendung portiert werden, hängen von den Einstellungen ab, die der Kunde auf der Seite Datenfreigabe-Einstellungen festgelegt hat.

Wie lange möchten Sie Zugriff gewähren?

Kunden wählen aus, wie lange Ihre Anwendung Daten importieren kann, indem sie ein zukünftiges Datum innerhalb der nächsten Zeit auswählen:

1 Tag
30 Tage
90 Tage
180 Tage
1 Jahr

Sobald der ausgewählte Zeitraum abgelaufen ist, kann Ihre Anwendung keine Kundendaten mehr importieren, es sei denn, der Kunde erteilt eine neue Autorisierung. Die Autorisierung endet, wenn ein Kunde den Zugriff widerruft oder wenn die Tokens ablaufen.

Schritte zum Onboarding mit eero

Senden Sie eine E-Mail an eero-data-portability-intake@amazon.com mit den folgenden Details, um den Onboarding-Prozess zu beginnen:
- E-Mail-Adresse
- Firmenname
- Firmenadresse
- Name des Geschäftsinhabers oder gesetzlichen Vertreters
- Bitte fügen Sie die Gewerbelizenz der E-Mail bei
Antworten Sie auf E-Mails/Anfragen/Meeting-Einladungen der eero/Amazon-Teams, um den Onboarding-Prozess in Gang zu bringen.
Ein Fragebogen wird nach Validierung der oben genannten Details geteilt. Füllen Sie die Details aus und teilen Sie ihn zur weiteren Validierung.
Antworten Sie auf E-Mails/Anfragen während der Third Party Security Assessment bis zu deren erfolgreicher Fertigstellung.
Senden Sie eine E-Mail an privacy@eero.com, um den Prozess zur Integration mit eero APIs einzuleiten, und teilen Sie die TPSA (Third party Security Assessment) ID als Referenz. eero stellt Ihnen eine Geheimhaltungsvereinbarung (NDA) zur Verfügung. Sobald die NDA ausgeführt ist, wird eero die vollständige Dokumentation per E-Mail mit Ihnen teilen.
Aktivieren Sie die Customer Experience (CX) auf der 3P-Website und in der App.

Autorisieren Sie Ihre Anwendung mit der eero Portability API

Der Zugriff auf eero APIs wird über das OAuth 2.0-Protokoll gewährt. Ihre Anwendung muss sich mit eero OAuth REST APIs integrieren. eero APIs folgen dem standardisierten Authorization Code Grant-Protokoll (https://oauth.net/2/grant-types/authorization-code/) ohne PKCE (https://oauth.net/2/pkce/). Wenn ein Kunde Sie als Drittanbieter autorisiert, erhalten Sie einen Autorisierungscode. Der Code und Ihr Client Secret (das Ihnen vorab bereitgestellt wird) können gegen Bearer Access Tokens (https://oauth.net/2/access-tokens/) und Refresh Tokens (https://oauth.net/2/refresh-tokens/) eingetauscht werden.

Diese Access Tokens laufen automatisch zu einer konfigurierbaren Zeit ab. Sobald Ihre Access Tokens abgelaufen sind, können Refresh Tokens gegen weitere Access Tokens eingetauscht werden. Bitte beachten Sie, dass der Kunde bei der Autorisierung mit Ihnen eine Autorisierungsdauer festlegt. Sobald diese Dauer erreicht ist (z. B. 1 Jahr), werden alle Ihre Access Tokens und Refresh Tokens widerrufen. Der Kunde und eero haben auch die Möglichkeit, den Zugriff jederzeit manuell zu widerrufen. Nach einem Widerruf oder Ablauf muss der Kunde sich erneut bei Ihnen autorisieren, wenn er Ihre Dienste weiterhin nutzen möchte.

Eine vollständige API-Spezifikation wird bereitgestellt, sobald Sie die Third Party Security Assessment abgeschlossen haben und für das Onboarding bereit sind. Es wird erwartet, dass Sie Ihre Anwendung um eero APIs herum aufbauen, die direkt aufgerufen werden können, da wir keine zusätzlichen Bibliotheken bereitstellen. Auf hoher Ebene benötigen wir von Ihnen:

Ihren Firmennamen (was Kunden bei der Autorisierung sehen)
Ihre Redirect-URIs. Wir leiten nur an Ihre vertrauenswürdigen URIs weiter.
Nachweis, dass Ihre Anwendung den Autorisierungscode serverseitig verarbeitet. Wir unterstützen derzeit keine clientseitigen Anwendungen.

Sobald wir dies haben, erstellen wir Ihren Client für Sie und stellen Ihnen Ihre Client-Anmeldedaten für zukünftige OAuth-authentifizierte Anfragen an die eero Portability API zur Verfügung.

Verbinden Sie Ihre Anwendung mit der eero Portability API

Sobald Ihr Client erstellt wurde, haben Sie eine Client-ID und ein Client Secret. Sie können diese verwenden, um Access Tokens im Namen von Kunden zu erstellen, wie in „Autorisieren Sie Ihre Anwendung" beschrieben. Diese Bearer Tokens werden als Header an die eero Portability API übergeben, um Informationen zum Kunden abzurufen. eero APIs sind REST-basiert und jeder Zugriff ist schreibgeschützt. Die von uns bereitgestellten Datenkategorien sind:

Netzwerkeinstellungen: eero-Netzwerkpräferenzen und -Konfigurationen wie Netzwerk-SSIDs, Passwörter und Backup-Konfigurationen.
eero-Gerätedaten: Rohe eero-Gerätedaten wie MAC-Adressen, IP-Adressen und Firmware-Versionen.
Geräteverwaltung: Kundengerätedaten wie Spitznamen und zugehörige Profile zu Geräten, pausierte und blockierte Geräte.
Sicherheit und Zugriff: Vom Kunden festgelegte Einstellungen wie Firewall- und Portweiterleitungsregeln.

Eine vollständige API-Spezifikation wird bereitgestellt, sobald Sie die Third Party Security Assessment abgeschlossen haben und integriert sind.