2021-09-30 15:05:01 +02:00
|
|
|
This document lists current limitations of the PSA Crypto API (as of version
|
|
|
|
1.1) that may impact our ability to (1) use it for all crypto operations in
|
|
|
|
TLS and X.509 and (2) support isolation of all long-term secrets in TLS (that
|
2022-02-01 10:26:07 +01:00
|
|
|
is, goals G1 and G2 in [strategy.md](strategy.md) in the same directory).
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
This is supposed to be a complete list, based on a exhaustive review of crypto
|
|
|
|
operations done in TLS and X.509 code, but of course it's still possible that
|
|
|
|
subtle-but-important issues have been missed. The only way to be really sure
|
|
|
|
is, of course, to actually do the migration work.
|
|
|
|
|
|
|
|
Limitations relevant for G1 (performing crypto operations)
|
|
|
|
==========================================================
|
|
|
|
|
|
|
|
Restartable ECC operations
|
|
|
|
--------------------------
|
|
|
|
|
2022-06-07 10:16:24 +02:00
|
|
|
There is currently no support for that in PSA at all, but it will be added at
|
|
|
|
some point, see <https://github.com/orgs/Mbed-TLS/projects/1#column-18816849>.
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
Currently, `MBEDTLS_USE_PSA_CRYPTO` is simply incompatible with
|
|
|
|
`MBEDTLS_ECP_RESTARTABLE`.
|
|
|
|
|
2022-02-01 10:26:07 +01:00
|
|
|
Things that are in the API but not implemented yet
|
|
|
|
--------------------------------------------------
|
|
|
|
|
|
|
|
PSA Crypto has an API for FFDH, but it's not implemented in Mbed TLS yet.
|
|
|
|
(Regarding FFDH, see the next section as well.) See issue [3261][ffdh] on
|
|
|
|
github.
|
|
|
|
|
2022-03-31 15:07:01 +02:00
|
|
|
[ffdh]: https://github.com/Mbed-TLS/mbedtls/issues/3261
|
2022-02-01 10:26:07 +01:00
|
|
|
|
|
|
|
PSA Crypto has an experimental API for EC J-PAKE, but it's not implemented in
|
|
|
|
Mbed TLS yet. See the [EC J-PAKE follow-up EPIC][ecjp] on github.
|
|
|
|
|
2022-03-31 15:07:01 +02:00
|
|
|
[ecjp]: https://github.com/orgs/Mbed-TLS/projects/1#column-17950140
|
2022-02-01 10:26:07 +01:00
|
|
|
|
2021-09-30 15:05:01 +02:00
|
|
|
Arbitrary parameters for FFDH
|
|
|
|
-----------------------------
|
|
|
|
|
2022-02-01 10:26:07 +01:00
|
|
|
(See also the first paragraph in the previous section.)
|
|
|
|
|
2021-09-30 15:05:01 +02:00
|
|
|
Currently, the PSA Crypto API can only perform FFDH with a limited set of
|
2022-02-10 12:58:09 +01:00
|
|
|
well-known parameters (some of them defined in the spec, but implementations
|
2021-09-30 15:05:01 +02:00
|
|
|
are free to extend that set).
|
|
|
|
|
|
|
|
TLS 1.2 (and earlier) on the other hand have the server send explicit
|
2022-02-10 12:58:09 +01:00
|
|
|
parameters (P and G) in its ServerKeyExchange message. This has been found to
|
2021-09-30 15:05:01 +02:00
|
|
|
be suboptimal for security, as it is prohibitively hard for the client to
|
|
|
|
verify the strength of these parameters. This led to the development of RFC
|
|
|
|
7919 which allows use of named groups in TLS 1.2 - however as this is only an
|
|
|
|
extension, servers can still send custom parameters if they don't support the
|
|
|
|
extension.
|
|
|
|
|
|
|
|
In TLS 1.3 the situation will be simpler: named groups are the only
|
|
|
|
option, so the current PSA Crypto API is a good match for that. (Not
|
2022-02-10 13:00:33 +01:00
|
|
|
coincidentally, all the groups used by RFC 7919 and TLS 1.3 are included
|
|
|
|
in the PSA specification.)
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
There are several options here:
|
|
|
|
|
|
|
|
1. Implement support for custom FFDH parameters in PSA Crypto: this would pose
|
|
|
|
non-trivial API design problem, but most importantly seems backwards, as
|
2022-04-20 14:27:48 +02:00
|
|
|
the crypto community is moving away from custom FFDH parameters. (Could be
|
|
|
|
done any time.)
|
2021-09-30 15:05:01 +02:00
|
|
|
2. Drop the DHE-RSA and DHE-PSK key exchanges in TLS 1.2 when moving to PSA.
|
2022-04-20 14:27:48 +02:00
|
|
|
(For people who want some algorithmic variety in case ECC collapses, FFDH
|
|
|
|
would still be available in TLS 1.3, just not in 1.2.) (Can only be done in
|
|
|
|
4.0 or another major version.)
|
|
|
|
3. Variant of the precedent: only drop client-side support. Server-side is
|
|
|
|
easy to support in terms of API/protocol, as the server picks the
|
|
|
|
parameters: we just need remove the existing `mbedtls_ssl_conf_dh_param_xxx()`
|
|
|
|
APIs and tell people to use `mbedtls_ssl_conf_groups()` instead. (Can only be
|
|
|
|
done in 4.0 or another major version.)
|
|
|
|
4. Implement RFC 7919, support DHE-RSA and DHE-PSK only in conjunction with it
|
|
|
|
when moving to PSA. Server-side would work as above; unfortunately
|
2021-09-30 15:05:01 +02:00
|
|
|
client-side the only option is to offer named groups and break the handshake
|
|
|
|
if the server didn't take on our offer. This is not fully satisfying, but is
|
|
|
|
perhaps the least unsatisfying option in terms of result; it's also probably
|
|
|
|
the one that requires the most work, but it would deliver value beyond PSA
|
2022-04-20 14:27:48 +02:00
|
|
|
migration by implementing RFC 7919. (Implementing RFC 7919 could be done any
|
|
|
|
time; making it mandatory can only be done in 4.0 or another major version.)
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
RSA-PSS parameters
|
|
|
|
------------------
|
|
|
|
|
|
|
|
RSA-PSS signatures are defined by PKCS#1 v2, re-published as RFC 8017
|
|
|
|
(previously RFC 3447).
|
|
|
|
|
|
|
|
As standardized, the signature scheme takes several parameters, in addition to
|
|
|
|
the hash algorithm potentially used to hash the message being signed:
|
2021-10-27 13:25:49 +02:00
|
|
|
- a hash algorithm used for the encoding function
|
2021-09-30 15:05:01 +02:00
|
|
|
- a mask generation function
|
|
|
|
- most commonly MGF1, which in turn is parametrized by a hash algorithm
|
|
|
|
- a salt length
|
2022-02-10 13:07:22 +01:00
|
|
|
- a trailer field - the value is fixed to 0xBC by PKCS#1 v2.1, but was left
|
2022-04-13 20:28:52 +02:00
|
|
|
configurable in the original scheme; 0xBC is used everywhere in practice.
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
Both the existing `mbedtls_` API and the PSA API support only MGF1 as the
|
2021-10-27 13:25:49 +02:00
|
|
|
generation function (and only 0xBC as the trailer field), but there are
|
|
|
|
discrepancies in handling the salt length and which of the various hash
|
|
|
|
algorithms can differ from each other.
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
### API comparison
|
|
|
|
|
|
|
|
- RSA:
|
|
|
|
- signature: `mbedtls_rsa_rsassa_pss_sign()`
|
|
|
|
- message hashed externally
|
|
|
|
- encoding hash = MGF1 hash (from context, or argument = message hash)
|
|
|
|
- salt length: always using the maximum legal value
|
|
|
|
- signature: `mbedtls_rsa_rsassa_pss_sign_ext()`
|
|
|
|
- message hashed externally
|
|
|
|
- encoding hash = MGF1 hash (from context, or argument = message hash)
|
|
|
|
- salt length: specified explicitly
|
|
|
|
- verification: `mbedtls_rsassa_pss_verify()`
|
|
|
|
- message hashed externally
|
|
|
|
- encoding hash = MGF1 hash (from context, or argument = message hash)
|
|
|
|
- salt length: any valid length accepted
|
|
|
|
- verification: `mbedtls_rsassa_pss_verify_ext()`
|
|
|
|
- message hashed externally
|
|
|
|
- encoding hash = MGF1 hash from dedicated argument
|
|
|
|
- expected salt length: specified explicitly, can specify "ANY"
|
|
|
|
- PK:
|
|
|
|
- signature: not supported
|
|
|
|
- verification: `mbedtls_pk_verify_ext()`
|
|
|
|
- message hashed externally
|
|
|
|
- encoding hash = MGF1 hash, specified explicitly
|
|
|
|
- expected salt length: specified explicitly, can specify "ANY"
|
|
|
|
- PSA:
|
|
|
|
- algorithm specification:
|
|
|
|
- hash alg used for message hashing, encoding and MGF1
|
2022-02-07 10:19:08 +01:00
|
|
|
- salt length can be either "standard" (<= hashlen, see note) or "any"
|
2021-09-30 15:05:01 +02:00
|
|
|
- signature generation:
|
2022-02-07 10:19:08 +01:00
|
|
|
- salt length: always <= hashlen (see note) and random salt
|
2021-09-30 15:05:01 +02:00
|
|
|
- verification:
|
2022-02-07 10:19:08 +01:00
|
|
|
- salt length: either <= hashlen (see note), or any depending on algorithm
|
|
|
|
|
|
|
|
Note: above, "<= hashlen" means that hashlen is used if possible, but if it
|
2022-02-08 10:33:11 +01:00
|
|
|
doesn't fit because the key is too short, then the maximum length that fits is
|
2022-02-07 10:19:08 +01:00
|
|
|
used.
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
The RSA/PK API is in principle more flexible than the PSA Crypto API. The
|
|
|
|
following sub-sections study whether and how this matters in practice.
|
|
|
|
|
|
|
|
### Use in X.509
|
|
|
|
|
|
|
|
RFC 4055 Section 3.1 defines the encoding of RSA-PSS that's used in X.509.
|
|
|
|
It allows independently specifying the message hash (also used for encoding
|
|
|
|
hash), the MGF (and its hash if MGF1 is used), and the salt length (plus an
|
|
|
|
extra parameter "trailer field" that doesn't vary in practice"). These can be
|
|
|
|
encoded as part of the key, and of the signature. If both encoding are
|
|
|
|
presents, all values must match except possibly for the salt length, where the
|
|
|
|
value from the signature parameters is used.
|
|
|
|
|
|
|
|
In Mbed TLS, RSA-PSS parameters can be parsed and displayed for various
|
|
|
|
objects (certificates, CRLs, CSRs). During parsing, the following properties
|
|
|
|
are enforced:
|
2021-10-27 13:25:49 +02:00
|
|
|
- the extra "trailer field" parameter must have its default value
|
2021-09-30 15:05:01 +02:00
|
|
|
- the mask generation function is MGF1
|
|
|
|
- encoding hash = message hashing algorithm (may differ from MGF1 hash)
|
|
|
|
|
|
|
|
When it comes to cryptographic operations, only two things are supported:
|
|
|
|
- verifying the signature on a certificate from its parent;
|
|
|
|
- verifying the signature on a CRL from the issuing CA.
|
|
|
|
|
|
|
|
The verification is done using `mbedtls_pk_verify_ext()`.
|
|
|
|
|
|
|
|
Note: since X.509 parsing ensures that message hash = encoding hash, and
|
2022-02-10 12:58:09 +01:00
|
|
|
`mbedtls_pk_verify_ext()` uses encoding hash = mgf1 hash, it looks like all
|
2021-09-30 15:05:01 +02:00
|
|
|
three hash algorithms must be equal, which would be good news as it would
|
2021-10-27 13:25:49 +02:00
|
|
|
match a limitation of the PSA API.
|
2021-09-30 15:05:01 +02:00
|
|
|
|
2021-10-27 13:25:49 +02:00
|
|
|
It is unclear what parameters people use in practice. It looks like by default
|
|
|
|
OpenSSL picks saltlen = keylen - hashlen - 2 (tested with openssl 1.1.1f).
|
|
|
|
The `certool` command provided by GnuTLS seems to be picking saltlen = hashlen
|
2022-02-08 10:33:41 +01:00
|
|
|
by default (tested with GnuTLS 3.6.13). FIPS 186-4 requires 0 <= saltlen <=
|
2022-02-01 10:26:07 +01:00
|
|
|
hashlen.
|
2021-10-21 13:04:01 +02:00
|
|
|
|
2021-09-30 15:05:01 +02:00
|
|
|
### Use in TLS
|
|
|
|
|
|
|
|
In TLS 1.2 (or lower), RSA-PSS signatures are never used, except via X.509.
|
|
|
|
|
|
|
|
In TLS 1.3, RSA-PSS signatures can be used directly in the protocol (in
|
|
|
|
addition to indirect use via X.509). It has two sets of three signature
|
|
|
|
algorithm identifiers (for SHA-256, SHA-384 and SHA-512), depending of what
|
|
|
|
the OID of the public key is (rsaEncryption or RSASSA-PSS).
|
|
|
|
|
|
|
|
In both cases, it specifies that:
|
|
|
|
- the mask generation function is MGF1
|
|
|
|
- all three hashes are equal
|
|
|
|
- the length of the salt MUST be equal to the length of the digest algorithm
|
|
|
|
|
|
|
|
When signing, the salt length picked by PSA is the one required by TLS 1.3
|
|
|
|
(unless the key is unreasonably small).
|
|
|
|
|
2021-10-27 13:25:49 +02:00
|
|
|
When verifying signatures, PSA will by default enforce the salt len is the one
|
|
|
|
required by TLS 1.3.
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
### Current testing - X509
|
|
|
|
|
2021-10-27 13:25:49 +02:00
|
|
|
All test files use the default trailer field of 0xBC, as enforced by our
|
|
|
|
parser. (There's a negative test for that using the
|
|
|
|
`x509_parse_rsassa_pss_params` test function and hex data.)
|
2021-10-21 13:04:01 +02:00
|
|
|
|
2021-10-27 13:25:49 +02:00
|
|
|
Files with "bad" in the name are expected to be invalid and rejected in tests.
|
2021-10-21 13:04:01 +02:00
|
|
|
|
|
|
|
**Test certificates:**
|
|
|
|
|
|
|
|
server9-bad-mgfhash.crt (announcing mgf1(sha224), signed with another mgf)
|
|
|
|
Hash Algorithm: sha256
|
|
|
|
Mask Algorithm: mgf1 with sha224
|
|
|
|
Salt Length: 0xDE
|
|
|
|
server9-bad-saltlen.crt (announcing saltlen = 0xDE, signed with another len)
|
|
|
|
Hash Algorithm: sha256
|
|
|
|
Mask Algorithm: mgf1 with sha256
|
|
|
|
Salt Length: 0xDE
|
|
|
|
server9-badsign.crt (one bit flipped in the signature)
|
|
|
|
Hash Algorithm: sha1 (default)
|
|
|
|
Mask Algorithm: mgf1 with sha1 (default)
|
|
|
|
Salt Length: 0xEA
|
|
|
|
server9-defaults.crt
|
|
|
|
Hash Algorithm: sha1 (default)
|
|
|
|
Mask Algorithm: mgf1 with sha1 (default)
|
|
|
|
Salt Length: 0x14 (default)
|
|
|
|
server9-sha224.crt
|
|
|
|
Hash Algorithm: sha224
|
|
|
|
Mask Algorithm: mgf1 with sha224
|
|
|
|
Salt Length: 0xE2
|
|
|
|
server9-sha256.crt
|
|
|
|
Hash Algorithm: sha256
|
|
|
|
Mask Algorithm: mgf1 with sha256
|
|
|
|
Salt Length: 0xDE
|
|
|
|
server9-sha384.crt
|
|
|
|
Hash Algorithm: sha384
|
|
|
|
Mask Algorithm: mgf1 with sha384
|
|
|
|
Salt Length: 0xCE
|
|
|
|
server9-sha512.crt
|
|
|
|
Hash Algorithm: sha512
|
|
|
|
Mask Algorithm: mgf1 with sha512
|
|
|
|
Salt Length: 0xBE
|
|
|
|
server9-with-ca.crt
|
|
|
|
Hash Algorithm: sha1 (default)
|
|
|
|
Mask Algorithm: mgf1 with sha1 (default)
|
|
|
|
Salt Length: 0xEA
|
|
|
|
server9.crt
|
|
|
|
Hash Algorithm: sha1 (default)
|
|
|
|
Mask Algorithm: mgf1 with sha1 (default)
|
|
|
|
Salt Length: 0xEA
|
|
|
|
|
|
|
|
These certificates are signed with a 2048-bit key. It appears that they are
|
|
|
|
all using saltlen = keylen - hashlen - 2, except for server9-defaults which is
|
|
|
|
using saltlen = hashlen.
|
|
|
|
|
|
|
|
**Test CRLs:**
|
|
|
|
|
|
|
|
crl-rsa-pss-sha1-badsign.pem
|
|
|
|
Hash Algorithm: sha1 (default)
|
|
|
|
Mask Algorithm: mgf1 with sha1 (default)
|
|
|
|
Salt Length: 0xEA
|
|
|
|
crl-rsa-pss-sha1.pem
|
|
|
|
Hash Algorithm: sha1 (default)
|
|
|
|
Mask Algorithm: mgf1 with sha1 (default)
|
|
|
|
Salt Length: 0xEA
|
|
|
|
crl-rsa-pss-sha224.pem
|
|
|
|
Hash Algorithm: sha224
|
|
|
|
Mask Algorithm: mgf1 with sha224
|
|
|
|
Salt Length: 0xE2
|
|
|
|
crl-rsa-pss-sha256.pem
|
|
|
|
Hash Algorithm: sha256
|
|
|
|
Mask Algorithm: mgf1 with sha256
|
|
|
|
Salt Length: 0xDE
|
|
|
|
crl-rsa-pss-sha384.pem
|
|
|
|
Hash Algorithm: sha384
|
|
|
|
Mask Algorithm: mgf1 with sha384
|
|
|
|
Salt Length: 0xCE
|
|
|
|
crl-rsa-pss-sha512.pem
|
|
|
|
Hash Algorithm: sha512
|
|
|
|
Mask Algorithm: mgf1 with sha512
|
|
|
|
Salt Length: 0xBE
|
|
|
|
|
|
|
|
These CRLs are signed with a 2048-bit key. It appears that they are
|
|
|
|
all using saltlen = keylen - hashlen - 2.
|
|
|
|
|
|
|
|
**Test CSRs:**
|
|
|
|
|
|
|
|
server9.req.sha1
|
|
|
|
Hash Algorithm: sha1 (default)
|
|
|
|
Mask Algorithm: mgf1 with sha1 (default)
|
|
|
|
Salt Length: 0x6A
|
|
|
|
server9.req.sha224
|
|
|
|
Hash Algorithm: sha224
|
|
|
|
Mask Algorithm: mgf1 with sha224
|
|
|
|
Salt Length: 0x62
|
|
|
|
server9.req.sha256
|
|
|
|
Hash Algorithm: sha256
|
|
|
|
Mask Algorithm: mgf1 with sha256
|
|
|
|
Salt Length: 0x5E
|
|
|
|
server9.req.sha384
|
|
|
|
Hash Algorithm: sha384
|
|
|
|
Mask Algorithm: mgf1 with sha384
|
|
|
|
Salt Length: 0x4E
|
|
|
|
server9.req.sha512
|
|
|
|
Hash Algorithm: sha512
|
|
|
|
Mask Algorithm: mgf1 with sha512
|
|
|
|
Salt Length: 0x3E
|
|
|
|
|
2022-04-20 14:27:48 +02:00
|
|
|
These CSRs are signed with a 2048-bit key. It appears that they are
|
2021-10-21 13:04:01 +02:00
|
|
|
all using saltlen = keylen - hashlen - 2.
|
2021-09-30 15:05:01 +02:00
|
|
|
|
2021-10-27 13:25:49 +02:00
|
|
|
### Possible courses of action
|
|
|
|
|
|
|
|
There's no question about what to do with TLS (any version); the only question
|
|
|
|
is about X.509 signature verification. Options include:
|
|
|
|
|
|
|
|
1. Doing all verifications with `PSA_ALG_RSA_PSS_ANY_SALT` - while this
|
|
|
|
wouldn't cause a concrete security issue, this would be non-compliant.
|
|
|
|
2. Doing verifications with `PSA_ALG_RSA_PSS` when we're lucky and the encoded
|
|
|
|
saltlen happens to match hashlen, and falling back to `ANY_SALT` otherwise.
|
|
|
|
Same issue as with the previous point, except more contained.
|
|
|
|
3. Reject all certificates with saltlen != hashlen. This includes all
|
2022-04-20 14:27:48 +02:00
|
|
|
certificates generated with OpenSSL using the default parameters, so it's
|
2021-10-27 13:25:49 +02:00
|
|
|
probably not acceptable.
|
|
|
|
4. Request an extension to the PSA Crypto API and use one of the above options
|
|
|
|
in the meantime. Such an extension seems inconvenient and not motivated by
|
|
|
|
strong security arguments, so it's unclear whether it would be accepted.
|
2021-09-30 15:05:01 +02:00
|
|
|
|
|
|
|
Limitations relevant for G2 (isolation of long-term secrets)
|
|
|
|
============================================================
|
|
|
|
|
2022-05-11 13:21:39 +02:00
|
|
|
Currently none.
|