Internet-Draft | Private Discovery | December 2020 |
Bradley | Expires 1 July 2021 | [Page] |
This document specifies a protocol for advertising and discovering devices and services while preserving privacy and confidentiality.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 1 July 2021.¶
Copyright (c) 2020 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.¶
Advertising and discovering devices and services on the network can leak a lot of information about a device or person, such as their name, the types of services they provide or use, and persistent identifiers. This information can be used to identify and track a person's location and daily routine (e.g. buys coffee every morning at 8 AM at Starbucks on Main Street). It can also reveal intimate details about a person's behavior and medical conditions, such as discovery requests for a glucose monitor, possibly indicating diabetes.¶
This document specifies a system for advertising and discovery of devices and services while preserving privacy and confidentiality.¶
This document does not specify how keys are provisioned. Provisioning keys is complex enough to justify its own document(s). This document assumes each peer has a long-term asymmetric key pair (LTPK and LTSK) and communicating peers have each other's long-term asymmetric public key (LTPK).¶
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119].¶
Multi-byte values are encoded from the most significant byte to the least significant byte (big endian).¶
When multiple items are concatenated together, the symbol "||" (without quotes) between each item is used to indicate this. For example, a combined item of A followed by B followed by C would be written as "A || B || C".¶
This document uses two techniques to preserve privacy and provide confidentiality. The first is announcing, probing, and responding with only enough info to allow a peer with your public key to detect that it's you while hiding your identity from peers without your public key. This technique uses a fresh random, signed with your private key using a signature algorithm that doesn't reveal your public key. The second technique is to query and answer in a way that only a specific friend can read the data. This uses ephemeral key exchange and symmetric encryption and authentication.¶
The general flow of the protocol is a device sends multicast probes to discover friend devices on the network. If friend devices are found, it directly communicates with them via unicast queries and answers. Announcements are sent to report availability and when services are added or removed.¶
Messages use a common header with a flags/type field. This indicates the format of the data after the header. Unknown message types MUST be ignored. Any data beyond the type-specific message body MUST be ignored. Future versions of this document may define additional data and this MUST NOT cause older message parsers to break. Updated formats that break compatibility with older parsers MUST use a new message type.¶
This protocol avoids explicit version numbers. It's versioned using message types and flags. Flags are used for protocol extensions where a flag can indicate the presence of an optional field. A new message type is used when the old message type structure cannot reasonably be extended without breaking older parsers. For example, if the probe message in this document changed to use a different key type then older parsers would misinterpret the content of the message. A new type MUST be used in this case so it will be ignored by older, compliant parsers.¶
Message format:¶
0 1 2 3 4 5 6 7 8 bits +-----+---------+~~~~~~~~~~~~~~~~~~~~ |Flags| Type | Type-specific data +-----+---------+~~~~~~~~~~~~~~~~~~~~¶
A probe is used to discover friends on the network. It provides enough info for a friend to identify the source, but doesn't allow non-friends to identify it. Probe procedure:¶
When a peer receives a probe, it does the following:¶
Message format:¶
0 1 2 3 4 5 6 7 8 bits +0 +-----+---------+ |Flg=0| Type=1 | 1 byte +1 +-----+---------+---------------+ | EPK1 | 32 bytes | | +33 +-------------------------------+ | TS1 | 4 bytes +37 +-------------------------------+ | SIG1 | 64 bytes | | | | +-------------------------------+ +101 Total bytes¶
A response is sent to answer a probe and provide keys for subsequent encryption of future queries. Response procedure:¶
When the friend that sent the probe receives the response, it does the following:¶
Key Derivation details:¶
Message format:¶
0 1 2 3 4 5 6 7 8 bits +0 +-----+---------+ |Flg=0| Type=2 | 1 byte +1 +-----+---------+---------------+ | EPK2 | 32 bytes | | +33 +-------------------------------+ | ESIG2 | 96 bytes | | | | +-------------------------------+ +129 Total bytes¶
An announcement indicates availability to friends on the network or if it has update(s). It is sent whenever a device joins a network (e.g. joins WiFi, plugged into Ethernet, etc.), its IP address changes, or when it has an update for one or more of its services. Announce procedure:¶
When a peer receives an announcement, it does the following:¶
Message format:¶
0 1 2 3 4 5 6 7 8 bits +0 +-----+---------+ |Flg=0| Type=3 | 1 byte +1 +-----+---------+---------------+ | EPK1 | 32 bytes | | +33 +-------------------------------+ | TS1 | 4 bytes +37 +-------------------------------+ | SIG1 | 64 bytes | | | | +-------------------------------+ +101 Total bytes¶
A query is sent to request specific info from a friend. Query procedure:¶
When the friend receives a query, it does the following:¶
Message format:¶
0 1 2 3 4 5 6 7 8 bits +0 +-----+---------+ |Flg=0| Type=4 | 1 byte +1 +-----+---------+--------------+ | EMSG1 (Encrypted query data) | n + 16 bytes | | +------------------------------+ +17 + n Total bytes¶
An answer is sent in response to a query from a friend. Answer procedure:¶
When the querying friend receives the answer, it does the following:¶
Message format:¶
0 1 2 3 4 5 6 7 8 bits +0 +-----+---------+ |Flg=0| Type=5 | 1 byte +1 +-----+---------+--------------+ | EMSG2 (Encrypted query data) | n + 16 bytes | | +------------------------------+ +17 + n Total bytes¶
A timestamp in this document is the number of seconds since 1970-01-01 00:00:00 UTC (i.e. Unix Epoch Time). Timestamps sent in messages SHOULD be randomized by +/- 30 seconds to reduce the fingerprinting ability of observers. A timestamp of 0 means the sender doesn't know the current time (e.g. lacks a battery-backed RTC and access to an NTP server). Receivers MAY use a timestamp of 0 to decide whether to enforce time window restrictions. This can allow discovery in situations where one or more devices don't know the current time (e.g. location without Internet access).¶
A timestamp is considered valid if it's within N seconds of the current time of the receiver. The RECOMMENDED value of N is 900 seconds (15 minutes) to allow peers to remain discoverable even after a large amount of clock drift.¶
The nonces in this document are integers that increment by 1 for each encryption. Nonces are never included in any message. Including nonces in messages would enable senders to be easily tracked by their predictable nonce sequence. This may seem futile if other layers of the system also leak trackable identifiers, such as IP addresses, but this document tries to avoid introducing any new privacy leaks in anticipation of leaks by other layers eventually being fixed. Random nonces could avoid tracking, but make replay protection difficult by requiring the receiver to remember previously received messages to detect a replay.¶
One issue with implicit nonces and replay protection in general is handling lost messages. Message loss and reordering is expected and shouldn't cause complete failure. Accepting nonces within N of the expected nonce enables recovery from some loss and reordering. When a message is received, the expected nonce is checked first and then nonce + 1, nonce - 1, up to nonce +/- N. The RECOMMENDED value of N is 8 as a balance between privacy, robustness, and performance.¶
Re-keying is a hedge against key compromise. The underlying algorithms have limits that far exceed reasonable usage (e.g. 96-bit nonces), but if a key was revealed then we want to reduce the damage by periodically re-keying.¶
Probes are periodically re-sent with a new ephemeral public key in case the previous key pair was compromised. The RECOMMENDED maximum probe ephemeral public key lifetime is 20 hours. This is close to 1 day since people often repeat actions on a daily basis, but with some leeway for natural variations. If a probe ephemeral public key is re-generated for other reasons, such as joining a WiFi network, the refresh timer is reset.¶
Session keys are periodically re-key'd in case a symmetric key was compromised. The RECOMMENDED maximum session key lifetime is 20 hours or 1000 messages, whichever comes first. This uses the same close-to-a-day reasoning as probes, but adds a maximum number of messages to reduce the potential for exposure when many messages are being exchanged. Responses SHOULD be throttled if it appears that a peer is making an excessive number of requests since this may indicate the peer is probing for weaknesses (e.g. timing attacks, ChopChop-style attacks).¶
Name | Type | Description |
---|---|---|
Invalid | 0 | Invalid message type. Avoids misinterpreting zeroed memory. |
Probe | 1 | See Section 3.1. |
Response | 2 | See Section 3.2. |
Announcement | 3 | See Section 3.3. |
Query | 4 | See Section 3.4. |
Answer | 5 | See Section 3.5. |
Reserved | 6-31 | Reserved. Don't send. Ignore if received. |
Name | Description |
---|---|
EPK1/EPK2 | Ephemeral Public Key. 32-byte Curve25519 public key. |
TS1 | Timestamp. 4-byte timestamp. See Timestamps Section 4. |
SIG1/SIG2 | Signature. 64-byte Ed25519 signature. |
ESIG1/ESIG2 | Encrypted signature. Ed25519 signature encrypted with ChaCha20-Poly1305. Formatted as the 64-byte encrypted portion followed by a 16-byte MAC (96 bytes total). |
EMSG1/EMSG2 | Encrypted message. Message encrypted with ChaCha20-Poly1305. Formatted as the N-byte encrypted portion followed by a 16-byte MAC (N + 16 bytes total). |
Information leaks may still be possible in some situations. For example, an attacker could capture probes from a peer they've identified and replay them elsewhere within the allowed timestamp window. This could be used to determine if their friend is present on that network.¶
The network infrastructure may leak identifiers in the form of persistent IP addresses and MAC addresses. Mitigating this requires changes at lower levels of the network stack, such as periodically changing IP addresses and MAC addresses.¶
The following are some of the things that still need to be specified and decided:¶