File: README.md

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (24 lines) | stat: -rw-r--r-- 1,241 bytes parent folder | download | duplicates (9)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# //components/encrypted_messages

Do not add new uses of this component without consulting the security team.

This component implements an extremely simple cryptographic scheme, which allows
encrypting anonymous messages to a remote end with a known, static public key.
The scheme is as follows, with a server public key spub:

1. Generate a random X25519 keypair (cpub, cpriv)
2. Compute a shared secret using spub and cpriv - note that the server will be
   able to compute the same shared secret using cpub and spriv later
3. Compute a subkey from that shared secret and a client-supplied fixed label
   string (to provide domain separation) using HKDF
4. Use that subkey with an AEAD (currently always AES-128-CTR with HMAC-SHA256)
   to encrypt and authenticate the payload
5. Pack the result into a protobuf containing the message itself, a server
   public key identifier, the random cpub from step 1, and an algorithm
   identifier for the inner AEAD

This is used in situations where Chromium is forced to communicate
maybe-sensitive data over plain HTTP - namely metrics and variation requests,
which are scenarios in which HTTPS might be unavailable.

Do not add new uses of this component without consulting the security team.