L'API della piattaforma

Non pubblicata

Il servizio ospitato ha un’interfaccia HTTP — è con cui parlano le app — ma non è un’API pubblicata. Non c’è nessun documento pubblico, nessuna versione pubblicata, e nessuna promessa di stabilità. Non la descriviamo qui, perché descriverla implicherebbe una promessa di mantenerla come descritta.

E non contiene nulla di tuo

Quella è la metà minore. Quella maggiore è che non ci sono affatto rotte specifiche dell’utente sulla piattaforma, e non c’è nessun piano per aggiungerne.

Una rotta che rispondesse “qual è il codice di Maria?” avrebbe bisogno del segreto che produce il codice, il che significa che il server dovrebbe detenerlo. Da quel momento la promessa end-to-end non è più vera — non per un abuso, ma per costruzione: un server che PUÒ leggere i tuoi codici è un server la cui compromissione legge i codici di tutti. La cura da parte nostra non cambia ciò che un aggressore porterebbe via.

Quindi nessun segreto utente è conservato su nessun server che gestiamo. L’interfaccia della piattaforma è lavoro a livello di sistema, da macchina a macchina, che non tocca nessun dato personale, e un titolare di account comunque non vi ha accesso.

Leggi questo come la rassicurazione che vuole essere. L’assenza non è una funzione a cui non siamo ancora arrivati. È la forma di un sistema progettato in modo che il giorno peggiore dalla nostra parte non sia il giorno peggiore dalla tua.

Che cosa usare al suo posto

Esegui il companion desktop e parla con la sua API locale. Il daemon detiene la sessione e le chiavi dell’account, e raggiunge la piattaforma per tuo conto. Tutto in questa sezione documenta quella superficie.

Questo è l’unico assetto in cui qualcosa può rispondere per il tuo account: le chiavi sono sulla tua macchina, quindi anche la risposta deve avvenire lì.

Per un server o un account macchina senza una persona davanti a uno schermo, il companion gira senza interfaccia e valgono le stesse rotte.

Quando questo cambierà

Se l’API della piattaforma viene pubblicata, avrà le proprie pagine qui, accanto a quella locale, con la stessa mappa delle rotte e la stessa dichiarazione di ciò che è garantito. Finché non le vedi, tratta l’interfaccia della piattaforma come privata.

Ciò che non cambierà è la parte qui sopra: qualunque cosa venga pubblicata sarà a livello di sistema, e continuerà a non contenere nessun tuo segreto.