E2EE Willy – Zero-knowledge
In sintesi: In modalità
encrypted_messages, Willy non accede mai al contenuto del messaggio. Tratta solo payload cifrati e metadati tecnici. È il massimo livello di riservatezza: il client cifra prima di inviare, Willy fa da relay.
Le due modalità E2EE Willy
E2EE Willy può funzionare in due modi:
- Con title/body: come E2EE Basic – Willy riceve il contenuto, cifra, inoltra. Willy vede durante l'invio.
- Con encrypted_messages: tu cifri i messaggi sul tuo server prima di inviarli. Willy riceve solo blob già cifrati e li inoltra a FCM. Willy non vede mai titolo, corpo o link.
Come funziona (encrypted_messages)
- Il tuo server recupera le chiavi pubbliche dei destinatari dall'API Willy.
- Il tuo server cifra titolo, corpo e link con la chiave di ogni destinatario.
- Invii a Willy un array di
{ push_token, enc, ephem }– nessun testo in chiaro. - Willy inoltra i blob a FCM senza mai decifrarli.
- Il dispositivo decifra e mostra la notifica.
Chi vede cosa
| Chi | Vede il contenuto in chiaro? |
|---|---|
| Willy Push | No, mai |
| Google / FCM | No |
| Il destinatario | Sì (solo lui può decifrare) |
Per chi è
Integrazioni server-to-server, backend aziendali, banche, PA, assicurazioni e chi deve rispettare requisiti di sicurezza molto stringenti. In particolare per chi non vuole che Willy veda mai il contenuto dei messaggi.
Funzionalità aggiuntive
- Firma HMAC – ogni richiesta può essere firmata; modifica = firma invalida.
- Anti-replay – nonce unico per richiesta; niente riutilizzo di richieste intercettate.
- Invio asincrono – per grandi volumi (migliaia di destinatari).
Cosa puoi inviare – esempi pratici
Questi esempi non definiscono un divieto tecnico assoluto, ma mostrano quale modalità è generalmente più adatta in base al livello di riservatezza del contenuto.
Ideale per contenuti molto personalizzati, riservati, business-critical che non vuoi far transitare in chiaro da Willy.
Ecommerce avanzato
- Ciao Laura, un prodotto che seguivi è tornato disponibile nella tua taglia.
- Ciao Mario, il tuo reso è stato approvato. Controlla l'area ordini.
- Hai un buono personale da 17€ valido fino a domani.
Finance / account / business
- La fattura di marzo è disponibile nel tuo profilo.
- È stato registrato un nuovo pagamento sul tuo account.
- Hai ricevuto un documento riservato.
Gestionale / CRM
- Hai un nuovo lead assegnato. Apri il CRM per i dettagli.
- Un ordine richiede la tua attenzione. Controlla la dashboard.
Sanità / prenotazioni / professionisti
- Hai un aggiornamento nella tua area riservata.
- Hai ricevuto un nuovo messaggio dal professionista.
- È disponibile un nuovo documento da consultare.
Attenzione allo schermo: anche con zero-knowledge il telefono può essere visto da altri. Evita riferimenti espliciti a referti o stati di salute. Preferisci sempre forme schermate: "Hai un aggiornamento riservato", "Apri l'area personale per leggere il messaggio".
Dati personali
Puoi inviare dati personali. Con encrypted_messages l'esposizione è minima: Willy non accede mai al contenuto. Restano solo metadati tecnici (token, timestamp) e obblighi del titolare sul messaggio inviato.
Quando usare E2EE Basic o E2EE Willy
| Tipo messaggio | E2EE Basic | E2EE Willy |
|---|---|---|
| Promo, sconti, offerte | ✓ Ideale | ✓ |
| Carrello abbandonato, ordini, spedizioni | ✓ Ideale | ✓ |
| Notifiche operative standard | ✓ Ideale | ✓ |
| Personalizzazione forte (taglia, storico) | Con cautela | ✓ Ideale |
| Saldo, fatture, documenti fiscali | — | ✓ Ideale |
| Lead, CRM, workflow business | — | ✓ Ideale |