Panoramica sulla portabilità dei dati
eero portabilità dei dati offre a terze parti autorizzate la possibilità di importare programmaticamente i dati dei clienti eero in un'app o in un sito Web dopo che i clienti hanno fornito l'autorizzazione tramite il loro conto eero.
Questo documento spiega come funziona la portabilità dei dati di eero e i passaggi da seguire affinché la tua app o il tuo sito web importino i dati dei clienti.Questa funzionalità è attualmente disponibile solo per i clienti che avere una rete che è fisicamente situato nell'Unione Europea.
Flusso di lavoro di portabilità dei dati eero
Dall'app o dal sito web della tua organizzazione,verrà visualizzata una pagina eero dove il cliente può accedere e iniziare a importare i dati del proprio dispositivo eero utilizzando le credenziali del proprio account eero esistente o accedendo con il proprio account Amazon. Prima di qualsiasi trasferimento dati, eero visualizza un messaggio di esclusione di responsabilità che informa i clienti delle autorizzazioni necessarie per la condivisione dei dati.
Esempio di pagina di autorizzazione eero
Nella pagina Autorizzazione, i clienti possono selezionare Continua o Cancellare.
- Se il cliente seleziona Cancellare, il flusso di lavoro termina. L'applicazione non sarà in grado di importare i dati di quel cliente.
- Se il cliente seleziona Confermare, eero visualizza le Preferenze di condivisione dei dati pagina.
Sul Preferenze di condivisione dei dati pagina, eero fornisce ai clienti opzioni per impostare le proprie preferenze, riconoscere l'autorizzazione e selezionare Cancellare o Autorizzare Pulsante.
- Se il cliente seleziona il Autorizzare pulsante, attiva la portabilità dei dati eero nella tua applicazione, autorizzando l'importazione dei dati di quel cliente.
- Se il cliente seleziona Cancellare, la tua applicazione non sarà autorizzata a importare i dati di quel cliente.
Dopo l'onboarding, riceverai un "client_id" e un "client_secret", che verranno utilizzati per le successive interazioni con l'API OAuth 2.0. Una volta che il cliente seleziona Autorizzare, avvierà il flusso ОAuth con eero. La tua organizzazione salverà il codice di autorizzazione fornito nella risposta HTTP. Utilizzerai questo codice di autorizzazione er 'segreto del cliente Per richiedere un token di accesso e un token di aggiornamento. Salva il token di accesso e utilizzarlo per chiamare l'API di portabilità dei dati di eero. I token di accesso scadono automaticamente, quindi salva il token di aggiornamento per ottenere token di accesso futuri.
Preferenze di condivisione dei dati
I dati trasferiti alla tua applicazione dipendono dalle preferenze impostate dal cliente nel Preferenze di condivisione dei dati pagina.
Pagina delle preferenze di condivisione dei dati
Per quanto tempo vuoi concedere l'accesso?
I clienti selezionano per quanto tempo l'applicazione può importare i dati selezionando un trasferimento una tantum o una data futura entro la prossima:
- 1 giorno
- 30 giorni
- 90 giorni
- 180 giorni
- 1 anno
Una volta scaduto il periodo selezionato, l'applicazione non sarà in grado di importare i dati del cliente a meno che il cliente non fornisca una nuova autorizzazione. L'autorizzazione termina quando un cliente revoca l'accesso o quando i token scadono.
Passaggi per l'onboarding con eero
- Invia un'e-mail a eero-data-portability-intake@amazon.com con i dettagli sottostanti per iniziare il processo di onboarding:
- Indirizzo e-mail
- Nome dell'azienda,
- Indirizzo dell'azienda,
- Nome del titolare dell'attività o del rappresentante legale
- Si prega di allegare la licenza commerciale all'e-mail
- Rispondere a email/domande/inviti alle riunioni da parte dei team eero/Amazon per aiutare ad avviare il processo di onboarding.
- Dopo aver convalidato i dati sopra indicati, ti verrà inviato un questionario. Compila i dati e condividilo per un'ulteriore convalida.
- Rispondere alle e-mail/domande durante la valutazione della sicurezza di terze parti fino al suo completamento con successo.
- Invia un'e-mail a privacy@eero.com per avviare il processo di integrazione con le API di eero e condividi l'ID TPSA (Third Party Security Assessment) come riferimento. eero ti fornirà un accordo di non divulgazione (NDA). Una volta sottoscritto l'NDA, eero condividerà con te la documentazione completa via e-mail.
- Abilita l'esperienza del cliente (CX) nel sito web e nell'app di terze parti.
Autorizza la tua applicazione con l'API di portabilità eero
L'accesso alle API eero è concesso tramite il protocollo OAuth 2.0. La tua applicazione dovrà integrarsi con le API REST OAuth di eero. Le API eero seguono il protocollo standardizzato Authorization Code Grant (https://oauth.net/2/grant-types/authorization-code/) senza PKCE (https://oauth.net/2/pkce/). Quando un cliente ti autorizza come terza parte, riceverai un codice di autorizzazione. Il codice e il tuo segreto client (fornito in precedenza) possono essere scambiati con i Bearer Access Token (https://oauth.net/2/access-tokens/) e token di aggiornamento (https://oauth.net/2/refresh-tokens/).
Questi token di accesso scadono automaticamente a un orario configurabile. Una volta scaduti, i token di aggiornamento possono essere convertiti in altri token di accesso. Tieni presente che quando il cliente autorizza l'accesso, specificherà una durata di autorizzazione. Una volta raggiunta questa durata (ad esempio, 1 anno), tutti i token di accesso e i token di aggiornamento verranno revocati. Il cliente ed eero avranno anche la possibilità di revocare manualmente l'accesso in qualsiasi momento. Una volta revocati o scaduti, il cliente dovrà richiedere nuovamente l'autorizzazione se desidera ancora usufruire dei tuoi servizi.
Una volta completata la valutazione di sicurezza di terze parti e una volta che sarete pronti per l'onboarding, vi verrà fornita una specifica API completa. Dovresti creare la tua applicazione attorno alle API eero che possono essere richiamate direttamente, poiché non forniamo librerie aggiuntive. Ad alto livello, avremo bisogno da te:
- Il nome della tua azienda (ciò che i clienti vedranno al momento dell'autorizzazione)
- I tuoi URI di reindirizzamento. Indirizziamo i dati solo verso i tuoi URI attendibili.
- Prova che la tua applicazione gestisce il codice di autorizzazione lato server. Al momento non supportiamo applicazioni lato client.
Una volta ottenuto questo, creeremo il tuo client e ti forniremo le credenziali client per future richieste autenticate tramite OAuth all'API eero Portability.
Collega la tua applicazione con l'API di portabilità eero
Una volta creato il tuo client, avrai un Client ID e un Client Secret. Puoi utilizzarli per creare token di accesso per conto dei clienti, come descritto nella sezione "Autorizzare la tua applicazione". Questi Bearer Token verranno passati come intestazioni all'API di portabilità eero per recuperare informazioni relative al cliente. Le API eero sono basate su REST e tutti gli accessi sono di sola lettura. Le categorie di dati che forniamo sono:
-
Impostazioni di rete
Preferenze e configurazioni delle reti eero, come SSID di rete, password e configurazioni di backup. -
Dati del dispositivo Eero
Dati grezzi del dispositivo eero, come indirizzi MAC, indirizzi IP e versioni del firmware. -
Gestione dei dispositivi
Dati sui dispositivi dei clienti, come nickname e profili associati ai dispositivi, dispositivi in pausa e bloccati. -
Sicurezza e accesso
Impostazioni specificate dal cliente, come regole di firewall e port forwarding.
Una volta completata la valutazione di sicurezza di terze parti e dopo l'inserimento, ti verrà fornita una specifica API completa.