| 1 |
|
| 2 |
|
| 3 |
@c gnutls_privkey_flags_t |
| 4 |
@table @code |
| 5 |
@item GNUTLS_@-PRIVKEY_@-IMPORT_@-AUTO_@-RELEASE |
| 6 |
When importing a private key, automatically |
| 7 |
release it when the structure it was imported is released. |
| 8 |
@item GNUTLS_@-PRIVKEY_@-IMPORT_@-COPY |
| 9 |
Copy required values during import. |
| 10 |
@item GNUTLS_@-PRIVKEY_@-DISABLE_@-CALLBACKS |
| 11 |
The following flag disables call to PIN callbacks etc. |
| 12 |
Only relevant to TPM keys. |
| 13 |
@item GNUTLS_@-PRIVKEY_@-SIGN_@-FLAG_@-TLS1_@-RSA |
| 14 |
Make an RSA signature on the hashed data as in the TLS protocol. |
| 15 |
@item GNUTLS_@-PRIVKEY_@-FLAG_@-PROVABLE |
| 16 |
When generating a key involving prime numbers, use provable primes; a seed may be required. |
| 17 |
@item GNUTLS_@-PRIVKEY_@-FLAG_@-EXPORT_@-COMPAT |
| 18 |
Keys generated or imported as provable require an extended format which cannot be read by previous versions |
| 19 |
of gnutls or other applications. By setting this flag the key will be exported in a backwards compatible way, |
| 20 |
even if the information about the seed used will be lost. |
| 21 |
@item GNUTLS_@-PRIVKEY_@-SIGN_@-FLAG_@-RSA_@-PSS |
| 22 |
Make an RSA signature on the hashed data with the PSS padding. |
| 23 |
@item GNUTLS_@-PRIVKEY_@-FLAG_@-REPRODUCIBLE |
| 24 |
Make a signature on the hashed data with reproducible parameters. |
| 25 |
For RSA-PSS, that means to use empty salt instead of random value. To |
| 26 |
verify a signature created using this flag, the corresponding SPKI needs |
| 27 |
to be set on the public key. Use @code{gnutls_pubkey_set_spki()} for that. |
| 28 |
For ECDSA/DSA, it uses the deterministic construction of random parameter |
| 29 |
according to RFC 6979. Note that this only supports the NIST curves and DSA |
| 30 |
subgroup bits up to 512. |
| 31 |
@item GNUTLS_@-PRIVKEY_@-FLAG_@-CA |
| 32 |
The generated private key is going to be used as a CA (relevant for RSA-PSS keys). |
| 33 |
@item GNUTLS_@-PRIVKEY_@-FLAG_@-RSA_@-PSS_@-FIXED_@-SALT_@-LENGTH |
| 34 |
When making an RSA-PSS |
| 35 |
signature, use the salt whose length is equal to the digest length, as |
| 36 |
mandated in RFC 8446 4.2.3. |
| 37 |
@end table |